DocumentationBuilt for developers
Everything you need to stream real-time market data into your products — from a 30-second quickstart to WebSocket reconnect strategies. Business and Enterprise plans include the full OHLCV archive with up to 10 years of historical data for back-testing and research.
Choose your path
First API call
Get your key, copy a request, and verify a live response in minutes.
Start onboarding →
Realtime streaming
Jump directly into WebSocket endpoints and reconnect-safe integration patterns.
Build realtime flow →
Plans and limits
Compare plan constraints, history depth, and endpoint availability before shipping.
Review pricing →
Base URLs
https://api.realmarketapi.comwss://api.realmarketapi.comhttps://ai.realmarketapi.com/mcpQuick start
Fetch the latest Gold price in 30 seconds. Replace YOUR_API_KEY with the key from your dashboard.
curl -X GET "https://api.realmarketapi.com/price?symbolCode=XAUUSD" -H "x-api-key: YOUR_API_KEY"Explore the docs
Jump to the section that fits your use case.
Getting Started
Authenticate with your API key, understand rate limits, explore supported symbols and timeframes.
- API key setup
- Authentication
- Symbols & Timeframes
- Best practices
REST Endpoints
Core market data endpoints plus account, category, 24-hour, indicator, volatility, and intelligence endpoints.
- GET /price · /price/24hr
- GET /price/category · /me
- GET /history · /candle
- GET /api/v1/indicator/*
WebSocket
Real-time streaming for live ticks, candle windows, order-flow imbalance, market-wide snapshots, and multi-timeframe feeds without polling.
- /price · /candles
- /market · /multi-timeframe
- /orderflow/imbalance
- Auto-reconnect patterns
API Reference
Every OHLCV field, HTTP status code, and structured exception code — all in one place.
- OHLCV fields
- HTTP error codes
- Exception codes
Technical Indicators
Use server indicator APIs for SMA, EMA, RSI, MACD and support/resistance, with formulas and integration examples.
- GET /api/v1/indicator/sma
- GET /api/v1/indicator/ema
- GET /api/v1/indicator/rsi
- GET /api/v1/indicator/macd
- Support/Resistance
Volatility API
Multi-metric volatility time-series, ATR spike detection, and a Day × Hour heatmap — all from a single endpoint group.
- GET /api/v1/volatility
- GET /volatility/spikes
- GET /volatility/heatmap
- ATR · HV · Band Width
Intelligence API
Advanced market analysis: next-candle bias scoring, trend detection, setup patterns, confluence signals, liquidity zones, order flow imbalance, stop-hunt detection, market anomalies, and manipulation risk.
- GET /insight/next · /trend · /score
- GET /insight/setup · /confluence
- GET /liquidity/zones
- GET /orderflow · /stop-hunt · /anomaly
MCP Server
Connect AI agents like Claude Desktop and Cursor to live market data via the Model Context Protocol, with quota-free tool calls.
- 34 MCP tools
- Quota-free calls
- Streamable HTTP
- Claude Desktop config
SDK Clients
Official SDK lineup: .NET (stable), JavaScript beta, and Python beta for REST and WebSocket integrations.
- NuGet + npm + PyPI
- C# stable
- JavaScript/Python beta
- Ticker · Candles · History
Telegram Bot
Get live prices, forecasts, price alerts, and volume spike notifications straight in Telegram — no server required.
- /price · /market · /next
- Price & spike alerts
- Wishlist
- /me — account info
Try it live in the Playground
Run real requests against the API — no backend required. Switch between REST and WebSocket, inspect responses, and copy code snippets.