RealMarketAPI.Sdk 1.0.5

RealMarketAPI.Sdk

Official .NET SDK for the RealMarket API — providing real-time market prices, OHLCV candles, historical data, technical indicators, WebSocket streaming, advanced market analysis (Insight, Liquidity, Order Flow, Stop Hunt, Anomaly, Manipulation), 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 price ticks (requires WebSocket-enabled plan)
        await foreach (var tick in client.WebSocket.StreamPriceAsync("EURUSD", "M1", ct))
            Console.WriteLine($"[WS price] {tick.OpenTime}: Close={tick.ClosePrice}");

        // Live order flow imbalance updates (PRO+)
        await foreach (var imbalance in client.WebSocket.StreamOrderFlowImbalanceAsync("BTCUSD", "H1", ct))
            Console.WriteLine($"[WS orderflow] {imbalance.CurrentImbalance}  Bull%: {imbalance.BullishRatio}");

        // Live multi-timeframe trend updates (PRO+)
        await foreach (var mtf in client.WebSocket.StreamMultiTimeframeAsync("EURUSD", ct))
            foreach (var (tf, direction) in mtf.Timeframes)
                Console.WriteLine($"[WS mtf] {tf}: {direction}");

        // Full market snapshot on every H1 tick
        await foreach (var market in client.WebSocket.StreamMarketAsync(ct))
            Console.WriteLine($"[WS market] received {market.Count} symbols");
    }
}

Available Endpoints

Ticker (client.Ticker)

Indicators (client.Indicators)

Account (client.Account)

Does not consume your request quota.

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 IsSocketSupport = true.
PRO+ endpoints additionally require the PRO plan or above.
Endpoints: wss://api.realmarketapi.com/{price|candles|orderflow/imbalance|multi-timeframe|market}

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

MCP calls do not consume your request quota.

Market Data & Indicators

Advanced Analysis — Pro plan required

Indicator and Advanced Analysis 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. PRO+ endpoints additionally require the PRO plan.
• MCP calls do not consume your request quota — they are treated as tooling/agent access.
• Market-aware quota: REST requests for symbols whose market is currently closed do not count against your monthly quota.
• Historical data availability depends on your plan's HistoricalRangeMonth.
• GET /me (client.Account.GetMeAsync()) does not consume your request quota.
• All methods accept an optional CancellationToken.
• Targets .NET 10.