RealMarketAPI.Sdk 1.0.2

RealMarketAPI.Sdk

Official .NET SDK for the RealMarket API — providing real-time market prices, OHLCV candles, historical data, technical indicators, WebSocket streaming, and MCP (Model Context Protocol) support.

Installation

dotnet add package RealMarketAPI.Sdk

Quick Start

1. Register with Dependency Injection

// Program.cs or Startup.cs
builder.Services.AddRealMarketApiClient("YOUR_API_KEY");

Or with full options:

builder.Services.AddRealMarketApiClient(options =>
{
    options.ApiKey = "YOUR_API_KEY";
    options.BaseUrl = "https://api.realmarketapi.com/"; // default
});

2. Inject and Use

public class MarketService(IRealMarketApiClient client)
{
    public async Task PrintPriceAsync()
    {
        // Real-time price
        var price = await client.Ticker.GetPriceAsync("EURUSD", "M1");
        Console.WriteLine($"EURUSD Close: {price.ClosePrice}");

        // Latest OHLCV candles
        var candles = await client.Ticker.GetCandlesAsync("BTCUSDT", "H1");
        foreach (var c in candles.Data)
            Console.WriteLine($"{c.OpenTime}: O={c.OpenPrice} H={c.HighPrice} L={c.LowPrice} C={c.ClosePrice}");

        // SMA(20)
        var sma = await client.Indicators.GetSmaAsync("EURUSD", "H1", period: 20);

        // RSI(14)
        var rsi = await client.Indicators.GetRsiAsync("EURUSD", "H1");

        // MACD
        var macd = await client.Indicators.GetMacdAsync("EURUSD", "H1");

        // Available symbols
        var symbols = await client.Symbols.GetSymbolsAsync();
    }

    public async Task StreamPricesAsync(CancellationToken ct)
    {
        // Real-time WebSocket streaming (requires WebSocket-enabled plan)
        await foreach (var tick in client.WebSocket.StreamPriceAsync("EURUSD", "M1", ct))
            Console.WriteLine($"[WS] {tick.OpenTime}: Close={tick.ClosePrice}");
    }
}

Available Endpoints

Ticker (client.Ticker)

Indicators (client.Indicators)

Symbols (client.Symbols)

WebSocket (client.WebSocket)

Requires a plan with WebSocket support enabled (IsSocketSupport = true). Endpoint: wss://api.realmarketapi.com/price

MCP — Model Context Protocol (client.Mcp)

Exposes the full RealMarket API as MCP tools, callable from AI assistants (GitHub Copilot, Claude, etc.) and from .NET code. Endpoint: https://api.realmarketapi.com/mcp

Indicator MCP tools require a Pro plan or higher.

Notes

• Indicator endpoints require a Pro plan or higher.
• WebSocket streaming requires a plan with IsSocketSupport = true.
• Historical data availability depends on your plan's HistoricalRangeMonth.
• All methods accept an optional CancellationToken.
• Targets .NET 10.