Documentation
Build with realtime market data
Everything you need to stream market data into your product, from a 30-second quick start to WebSocket reconnect strategies. Business and Enterprise plans include up to 10 years of OHLCV history for back-testing and research.
- Symbols
- 60+
- Timeframes
- 6
- Endpoints
- 47
- MCP tools
- 33
- Avg latency
- <5ms
- History
- 10 yr
First API call
Get your key, copy a request, and verify a live response in minutes.
Start onboarding
Realtime streaming
Jump straight into WebSocket streams and reconnect-safe integration patterns.
Build a realtime flow
Plans and limits
Compare plan constraints, history depth, and endpoint availability before shipping.
Review pricing
Base URLs
- REST API
- https://api.realmarketapi.com
- WebSocket
- wss://api.realmarketapi.com
- MCP server
- https://ai.realmarketapi.com/mcp
Quick start
YOUR_API_KEY with the key from your dashboard.curl "https://api.realmarketapi.com/api/v1/price?apiKey=YOUR_API_KEY&symbolCode=XAUUSD&timeFrame=M1"const res = await fetch(
"https://api.realmarketapi.com/api/v1/price?apiKey=YOUR_API_KEY&symbolCode=XAUUSD&timeFrame=M1"
);
const data = await res.json();
console.log(data);import requests
resp = requests.get(
"https://api.realmarketapi.com/api/v1/price",
params={"apiKey": "YOUR_API_KEY", "symbolCode": "XAUUSD", "timeFrame": "M1"},
)
print(resp.json())using var http = new HttpClient();
var json = await http.GetStringAsync(
"https://api.realmarketapi.com/api/v1/price?apiKey=YOUR_API_KEY&symbolCode=XAUUSD&timeFrame=M1");
Console.WriteLine(json);HttpClient client = HttpClient.newHttpClient();
HttpRequest req = HttpRequest.newBuilder()
.uri(URI.create("https://api.realmarketapi.com/api/v1/price?apiKey=YOUR_API_KEY&symbolCode=XAUUSD&timeFrame=M1"))
.build();
HttpResponse<String> res = client.send(req, BodyHandlers.ofString());
System.out.println(res.body());No API key yet?
Explore the docs
Getting started
Start hereAuthenticate with your API key, pick the right transport, and look up supported symbols and timeframes.
- API key setup
- Authentication
- Symbols & timeframes
- Best practices
REST endpoints
All plansCore market data 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/*
Feature modules
NewMarket Screener, Alert Center, Signal Lab, and Watchlist Hub with endpoint details and usage examples.
- Market Screener
- Alert Center
- Signal Lab
- Watchlist Hub
Integrate with AI
NewOne prompt for ChatGPT, Claude, Gemini, DeepSeek or your coding agent that points it at guide.md, so it wires up the API correctly.
- Copy or open in ChatGPT / Claude
- Gemini & DeepSeek
- guide.md for agents
Skills
Skill packsDownload SKILL.md files for market context, technical analysis, multi-timeframe workflows, XAUUSD, sentiment, and trading decisions.
- Direct SKILL.md downloads
- Meta skill catalog
- High-value workflows
WebSocket
Plus, Pro & BusinessLive 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
Fields & errors
ReferenceEvery OHLCV field, HTTP status code, and structured exception code in one place.
- OHLCV fields
- HTTP error codes
- Exception codes
Technical indicators
IndicatorsServer indicator APIs for SMA, EMA, RSI, MACD, support/resistance and more, with formulas and integration examples.
- /indicator/sma · /ema
- /indicator/rsi · /macd
- Support/Resistance
Volatility API
Starter+Multi-metric volatility time-series, ATR spike detection, and a day-by-hour heatmap.
- GET /api/v1/volatility
- /volatility/spikes
- /volatility/heatmap
Intelligence API
Pro+Next-candle bias, trend, setups, confluence, liquidity zones, order flow, stop hunts, anomalies, and manipulation risk.
- /insight/next · /trend · /score
- /insight/setup · /confluence
- /liquidity/zones · /anomaly
MCP server
Pro+Connect Claude Desktop, Cursor and other agents to live market data over the Model Context Protocol, with quota-free tool calls.
- 33 MCP tools
- Quota-free calls
- Streamable HTTP
SDK clients
SDKOfficial SDKs: .NET (stable), JavaScript beta, and Python beta for REST and WebSocket integrations.
- NuGet · npm · PyPI
- Ticker · Candles · History
Telegram bot
All plansLive prices, forecasts, price alerts, and volume spike notifications in Telegram, with no server required.
- /price · /market · /next
- Price & spike alerts
- /me account info
Try it in the Playground
Run real requests against the API with no backend. Switch between REST and WebSocket, inspect responses, and copy snippets.