RealMarketAPI.Sdk 1.0.4

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 BasicExamplesAsync()
    {
        // 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 InsightExamplesAsync()
    {
        // Next-candle forecast with bias and ATR targets
        var next = await client.Insight.GetNextAsync("BTCUSD", "H1");
        Console.WriteLine($"Bias: {next.Bias}  Bull: {next.BullScore}  Bear: {next.BearScore}");
        Console.WriteLine($"Target Up: {next.TargetUp}  Target Down: {next.TargetDown}");

        // Trend classification
        var trend = await client.Insight.GetTrendAsync("EURUSD", "H4");
        Console.WriteLine($"Trend: {trend.Trend}  ADX: {trend.Adx}");

        // Market setup detection
        var setup = await client.Insight.GetSetupAsync("XAUUSD", "M15");
        Console.WriteLine($"Setup: {setup.Setup}  Direction: {setup.Direction}");

        // Confluence signal with strength and reasons
        var confluence = await client.Insight.GetConfluenceAsync("BTCUSD", "H1");
        Console.WriteLine($"Signal: {confluence.Signal}  Strength: {confluence.Strength}  Score: {confluence.Score}");

        // Composite 0–100 bullish/bearish score
        var score = await client.Insight.GetScoreAsync("EURUSD", "H1");
        Console.WriteLine($"Score: {score.Score}  Label: {score.Label}");
    }

    public async Task ProModulesExamplesAsync()
    {
        // Trend direction across all timeframes
        var mtf = await client.MultiTimeframe.GetAsync("BTCUSD");
        foreach (var (tf, direction) in mtf.Timeframes)
            Console.WriteLine($"{tf}: {direction}");

        // Liquidity zones (S/R clusters)
        var liquidity = await client.Liquidity.GetZonesAsync("XAUUSD", "H1");
        foreach (var zone in liquidity.Zones)
            Console.WriteLine($"{zone.Type} @ {zone.Price}  Strength: {zone.Strength}  Touches: {zone.TouchCount}");

        // Order flow imbalance
        var imbalance = await client.OrderFlow.GetImbalanceAsync("BTCUSD", "M15");
        Console.WriteLine($"Imbalance: {imbalance.CurrentImbalance}  Bull%: {imbalance.BullishRatio}  Bear%: {imbalance.BearishRatio}");

        // Stop hunt zones
        var stopHunt = await client.StopHunt.GetZonesAsync("EURUSD", "H1");
        foreach (var zone in stopHunt.Zones)
            Console.WriteLine($"{zone.Type} @ {zone.Price}  Hunted: {zone.RecentlyHunted}");

        // Anomaly scan
        var anomalies = await client.Anomaly.GetAsync("BTCUSD", "M15");
        if (anomalies.HasAnomalies)
            foreach (var a in anomalies.Anomalies)
                Console.WriteLine($"{a.Type} at {a.OpenTime}: {a.Description}");

        // Manipulation risk
        var risk = await client.Manipulation.GetRiskAsync("XAUUSD", "M15");
        Console.WriteLine($"Risk: {risk.RiskLevel}  Score: {risk.RiskScore}");
    }

    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)

Volatility (client.Volatility)

Available on Starter plan and above. Free plan is not supported.

Insight (client.Insight) — Pro plan required

Multi-Timeframe (client.MultiTimeframe) — Pro plan required

Liquidity (client.Liquidity) — Pro plan required

Order Flow (client.OrderFlow) — Pro plan required

Stop Hunt (client.StopHunt) — Pro plan required

Anomaly (client.Anomaly) — Pro plan required

Manipulation Risk (client.Manipulation) — Pro plan required

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.
Volatility MCP tools require a Starter plan or higher.

Notes

• Pro plan required for: Indicator, Insight, Multi-Timeframe, Liquidity, Order Flow, Stop Hunt, Anomaly, and Manipulation endpoints.
• Starter plan required for Volatility endpoints (Free plan not supported).
• 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.