API reference
REST endpoints
47 endpoints across market data, indicators, volatility and intelligence. GET, POST and DELETE, authenticated with an API key, JSON responses.
Overview
- Base URL
- https://api.realmarketapi.com
- Auth
- apiKey query parameter
- Format
- JSON
All endpoints
Market Data
10 endpoints
Core Endpoints
Latest Price
Returns the latest completed OHLCV candle for the requested symbol and timeframe. Ideal for one-shot price queries in server-side scripts or cron jobs.
Query parameters
| Name | Type | Description |
|---|---|---|
| apiKeyrequired | string | Your API authentication key. |
| symbolCoderequired | string | Trading symbol (e.g. XAUUSD, EURUSD, AAPL). |
| timeFramerequired | string | Candle interval: M1, M5, M15, H1, H4, D1. |
Response fields
| Field | Type | Description |
|---|---|---|
| SymbolCode | string | Symbol identifier. |
| OpenPrice | number | Open price of the candle. |
| ClosePrice | number | Close price of the candle. |
| HighPrice | number | Highest price in the candle. |
| LowPrice | number | Lowest price in the candle. |
| Bid | number | Best bid price. |
| Ask | number | Best ask price. |
| Volume | number | Trade volume. |
| OpenTime | ISO 8601 | Candle open time (UTC). |
Request
GET https://api.realmarketapi.com/api/v1/price?apiKey=YOUR_API_KEY&symbolCode=XAUUSD&timeFrame=M1Example response
Response · 200
{
"SymbolCode": "XAUUSD",
"OpenPrice": 2348.12,
"ClosePrice": 2351.84,
"HighPrice": 2354.00,
"LowPrice": 2346.10,
"Bid": 2351.70,
"Ask": 2352.30,
"Volume": 1284.47,
"OpenTime": "2026-03-08T09:20:00Z"
}Market Overview
Returns the latest OHLCV candle for every symbol available on your plan in a single call. Use this for dashboards and multi-asset snapshots.
Query parameters
| Name | Type | Description |
|---|---|---|
| apiKeyrequired | string | Your API authentication key. |
Response fields
| Field | Type | Description |
|---|---|---|
| data | OHLCV[] | Array of latest candles for all accessible symbols. |
| totalCount | integer | Number of symbols returned. |
Request
GET https://api.realmarketapi.com/api/v1/price/market?apiKey=YOUR_API_KEYExample response
Response · 200
[
{
"SymbolCode": "XAUUSD",
"OpenPrice": 2348.12,
"ClosePrice": 2351.84,
"HighPrice": 2354.00,
"LowPrice": 2346.10,
"Bid": 2351.70,
"Ask": 2352.30,
"Volume": 1284.47,
"OpenTime": "2026-03-08T09:20:00Z"
},
{
"SymbolCode": "EURUSD",
"..."
}
]My Account
Returns your current plan, request usage, WebSocket allowance, and account status in a single authenticated call.
Query parameters
| Name | Type | Description |
|---|---|---|
| apiKeyrequired | string | Your API authentication key. |
Response fields
| Field | Type | Description |
|---|---|---|
string | Account email address. | |
| planCode | string | Active plan identifier. |
| requestCount | integer | Requests used in the current billing period. |
| requestLimit | integer | Monthly request allowance for the active plan. |
| wsConcurrentLimit | integer | Maximum simultaneous WebSocket connections. |
Request
GET https://api.realmarketapi.com/api/v1/me?apiKey=YOUR_API_KEYExample response
Response · 200
{
"email": "[email protected]",
"planCode": "PRO",
"requestCount": 18420,
"requestLimit": 200000,
"wsConcurrentLimit": 100
}Category Snapshot
Returns the latest market snapshot for one category: Stock, Index, Commodity, Equity, Forex, or Crypto.
Query parameters
| Name | Type | Description |
|---|---|---|
| apiKeyrequired | string | Your API authentication key. |
| categoryrequired | string | Category name: Stock, Index, Commodity, Equity, Forex, or Crypto. |
Response fields
| Field | Type | Description |
|---|---|---|
| data | OHLCV[] | Latest OHLCV frames for all symbols in the requested category. |
| category | string | Category echoed from the request. |
| totalCount | integer | Number of symbols returned for the category. |
Request
GET https://api.realmarketapi.com/api/v1/price/category?apiKey=YOUR_API_KEY&category=CryptoExample response
Response · 200
{
"category": "Crypto",
"totalCount": 9,
"data": [
{
"SymbolCode": "BTCUSD",
"OpenPrice": 67240.00,
"ClosePrice": 67812.50,
"HighPrice": 68100.00,
"LowPrice": 67050.00,
"Bid": 67810.00,
"Ask": 67815.00,
"Volume": 12.42,
"OpenTime": "2026-03-08T08:00:00Z"
}
]
}24h Snapshot
Returns 24-hour baseline market metrics across all accessible symbols, including last close, previous close, and percentage change.
Query parameters
| Name | Type | Description |
|---|---|---|
| apiKeyrequired | string | Your API authentication key. |
Response fields
| Field | Type | Description |
|---|---|---|
| data | array | Array of 24-hour baseline rows for each accessible symbol. |
| data[].symbolCode | string | Symbol identifier. |
| data[].lastClosePrice | number | Most recent close price. |
| data[].previousClosePrice | number | Close price 24 hours earlier. |
| data[].change24hPercent | number | Percentage change over the last 24 hours. |
Request
GET https://api.realmarketapi.com/api/v1/price/24hr?apiKey=YOUR_API_KEYExample response
Response · 200
[
{
"symbolCode": "XAUUSD",
"lastClosePrice": 2351.84,
"previousClosePrice": 2340.11,
"change24hPercent": 0.5
},
{
"symbolCode": "BTCUSD",
"lastClosePrice": 67812.50,
"previousClosePrice": 67100.00,
"change24hPercent": 1.06
}
]Historical Candles
Returns paginated OHLCV candles for a date range. Supports H1 timeframe only. Use pageNumber and pageSize to iterate large datasets.
Query parameters
| Name | Type | Description |
|---|---|---|
| apiKeyrequired | string | Your API authentication key. |
| symbolCoderequired | string | Trading symbol (e.g. XAUUSD, EURUSD, AAPL). |
| startTimerequired | ISO 8601 | Range start (UTC). e.g. 2026-02-01T00:00:00Z. |
| endTimerequired | ISO 8601 | Range end (UTC). e.g. 2026-03-01T00:00:00Z. |
| pageNumber | integer | Page number (1-based). Default: 1 |
| pageSize | integer | Candles per page (max 1000; larger values are clamped). Default: 20 |
Response fields
| Field | Type | Description |
|---|---|---|
| Data | OHLCV[] | Array of candles in the requested range. |
| TotalCount | integer | Total number of matching candles. |
| CurrentPage | integer | Current page index. |
| TotalPages | integer | Total number of pages. |
| PageSize | integer | Number of candles per page. |
Request
GET https://api.realmarketapi.com/api/v1/history?apiKey=YOUR_API_KEY&symbolCode=ETHUSD&startTime=2026-02-01T00:00:00Z&endTime=2026-03-01T00:00:00Z&pageNumber=1&pageSize=10Example response
Response · 200
{
"Data": [
{
"SymbolCode": "ETHUSD",
"OpenPrice": 3120.22,
"ClosePrice": 3138.44,
"HighPrice": 3142.07,
"LowPrice": 3115.13,
"Bid": 3138.30,
"Ask": 3138.58,
"Volume": 432.58,
"OpenTime": "2026-03-08T08:00:00Z"
}
],
"TotalCount": 240,
"CurrentPage": 1,
"TotalPages": 24,
"PageSize": 10
}Recent Candles
Returns the 10 most recently completed candles for a symbol and timeframe. Useful for seeding charting libraries or indicator warm-up.
Query parameters
| Name | Type | Description |
|---|---|---|
| apiKeyrequired | string | Your API authentication key. |
| symbolCoderequired | string | Trading symbol (e.g. XAUUSD, EURUSD, AAPL). |
| timeFramerequired | string | Candle interval: M1, M5, M15, H1, H4, D1. |
Response fields
| Field | Type | Description |
|---|---|---|
| Data | OHLCV[] | Up to 10 recent candles, newest first. |
| TotalCount | integer | Number of candles returned. |
Request
GET https://api.realmarketapi.com/api/v1/candle?apiKey=YOUR_API_KEY&symbolCode=BTCUSD&timeFrame=H1Example response
Response · 200
{
"Data": [
{
"SymbolCode": "BTCUSD",
"OpenPrice": 67240.00,
"ClosePrice": 67812.50,
"HighPrice": 68100.00,
"LowPrice": 67050.00,
"Bid": 67810.00,
"Ask": 67815.00,
"Volume": 12.42,
"OpenTime": "2026-03-08T08:00:00Z"
}
],
"TotalCount": 10
}Available Symbols
Lists every symbol the API serves, with its display name and market class. No API key required. Which symbols your key may query depends on your plan; use the returned codes as symbolCode in other endpoints.
Response fields
| Field | Type | Description |
|---|---|---|
| data | array | Supported symbols. |
| data[].symbolCode | string | Symbol code to pass as symbolCode. |
| data[].displayName | string | Human-readable name. |
| data[].marketClass | string | Market class, e.g. Forex, Crypto, Commodity, Index, Stock, Equity. |
| totalCount | integer | Number of symbols returned. |
Request
GET https://api.realmarketapi.com/api/v1/symbolExample response
Response · 200
{
"data": [
{ "symbolCode": "EURUSD", "displayName": "Euro / US Dollar", "marketClass": "Forex" },
{ "symbolCode": "US500", "displayName": "S&P 500", "marketClass": "Index" },
"..."
],
"totalCount": 61
}API Health
Health check. Returns 200 when the API, its database and its cache are reachable, and 503 with the same body when any of them is not. No authentication required — safe to use from monitoring tools.
Response fields
| Field | Type | Description |
|---|---|---|
| status | string | "Healthy" or "Unhealthy". |
| timestamp | ISO 8601 | Server timestamp of the health check. |
| checks | object | Per-dependency result: postgres and redis, each "Healthy" or "Unhealthy". |
Request
GET https://api.realmarketapi.com/api/v1/healthExample response
Response · 200
{
"status": "Healthy",
"timestamp": "2026-03-08T09:25:00Z",
"checks": {
"postgres": "Healthy",
"redis": "Healthy"
}
}Market Calendar
Returns session windows and high-impact macro events for the requested date and timezone.
Query parameters
| Name | Type | Description |
|---|---|---|
| apiKeyrequired | string | Your API authentication key. |
| date | date | Optional date in YYYY-MM-DD format. |
| timezone | string | Timezone for localized session/event timestamps. Default: UTC |
Response fields
| Field | Type | Description |
|---|---|---|
| date | string | Requested date. |
| sessions | array | Market sessions for the day. |
| sessions[].market | string | Market name (Forex, Crypto, etc). |
| sessions[].openUtc | ISO 8601 | Session open timestamp in UTC. |
| sessions[].closeUtc | ISO 8601 | Session close timestamp in UTC. |
| events | array | Scheduled macro events with impact labels. |
| events[].title | string | Event title. |
| events[].impact | string | Low | Medium | High. |
| events[].timeUtc | ISO 8601 | Event timestamp in UTC. |
Request
GET https://api.realmarketapi.com/api/v1/market-calendar?apiKey=YOUR_API_KEY&date=2026-06-11&timezone=UTCExample response
Response · 200
{
"date": "2026-06-11",
"sessions": [
{
"market": "Forex",
"openUtc": "2026-06-11T00:00:00Z",
"closeUtc": "2026-06-11T23:59:59Z"
}
],
"events": [
{
"title": "CPI Release",
"impact": "High",
"timeUtc": "2026-06-11T12:30:00Z"
}
]
}Indicators
14 endpoints · Pro+
Core Endpoints
SMA
Simple Moving Average — arithmetic mean of closing prices over the Period. Common periods: 10, 20, 50, 200.
Query parameters
| Name | Type | Description |
|---|---|---|
| apiKeyrequired | string | Your API authentication key. |
| symbolCoderequired | string | Trading symbol (e.g. XAUUSD, EURUSD, AAPL). |
| timeFramerequired | string | Candle interval: M1, M5, M15, H1, H4, D1. |
| periodrequired | integer | Lookback period (number of candles). Common values: 10, 20, 50, 200. |
Response fields
| Field | Type | Description |
|---|---|---|
| data | array | Array of indicator data points. |
| data[].openTime | ISO 8601 | Candle open timestamp (UTC). |
| data[].value | number | Computed indicator value for this bar. |
| totalCount | integer | Number of data points returned. |
Request
GET https://api.realmarketapi.com/api/v1/indicator/sma?apiKey=YOUR_API_KEY&symbolCode=AAPL&timeFrame=H1&period=20Example response
Response · 200
{
"data": [
{ "openTime": "2026-03-08T09:00:00Z", "value": 189.42 },
{ "openTime": "2026-03-08T08:00:00Z", "value": 188.97 }
],
"totalCount": 2
}EMA
Exponential Moving Average — weights recent prices higher than SMA, reacting faster to price changes. Common periods: 9, 20, 50, 200.
Query parameters
| Name | Type | Description |
|---|---|---|
| apiKeyrequired | string | Your API authentication key. |
| symbolCoderequired | string | Trading symbol (e.g. XAUUSD, EURUSD, AAPL). |
| timeFramerequired | string | Candle interval: M1, M5, M15, H1, H4, D1. |
| periodrequired | integer | Lookback period (number of candles). Common values: 9, 20, 50, 200. |
Response fields
| Field | Type | Description |
|---|---|---|
| data | array | Array of indicator data points. |
| data[].openTime | ISO 8601 | Candle open timestamp (UTC). |
| data[].value | number | Computed indicator value for this bar. |
| totalCount | integer | Number of data points returned. |
Request
GET https://api.realmarketapi.com/api/v1/indicator/ema?apiKey=YOUR_API_KEY&symbolCode=AUDUSD&timeFrame=H4&period=50Example response
Response · 200
{
"data": [
{ "openTime": "2026-03-08T08:00:00Z", "value": 0.64712 }
],
"totalCount": 1
}WMA
Weighted Moving Average — linearly weights recent closing prices more heavily than older ones over the period (2–200).
Query parameters
| Name | Type | Description |
|---|---|---|
| apiKeyrequired | string | Your API authentication key. |
| symbolCoderequired | string | Trading symbol (e.g. XAUUSD, EURUSD, AAPL). |
| timeFramerequired | string | Candle interval: M1, M5, M15, H1, H4, D1. |
| periodrequired | integer | Lookback period (number of candles). Range: 2–200. |
Response fields
| Field | Type | Description |
|---|---|---|
| data | array | Array of indicator data points. |
| data[].openTime | ISO 8601 | Candle open timestamp (UTC). |
| data[].value | number | Computed indicator value for this bar. |
| totalCount | integer | Number of data points returned. |
Request
GET https://api.realmarketapi.com/api/v1/indicator/wma?apiKey=YOUR_API_KEY&symbolCode=XAUUSD&timeFrame=H1&period=20Example response
Response · 200
{
"data": [
{ "openTime": "2026-03-08T09:00:00Z", "value": 2349.87 },
{ "openTime": "2026-03-08T08:00:00Z", "value": 2348.95 }
],
"totalCount": 2
}RSI
Relative Strength Index — momentum oscillator measuring speed and change of price movements. Values range 0–100.
Query parameters
| Name | Type | Description |
|---|---|---|
| apiKeyrequired | string | Your API authentication key. |
| symbolCoderequired | string | Trading symbol (e.g. XAUUSD, EURUSD, AAPL). |
| timeFramerequired | string | Candle interval: M1, M5, M15, H1, H4, D1. |
| period | integer | Lookback period (number of candles). Standard: 14. Default: 14 |
Response fields
| Field | Type | Description |
|---|---|---|
| data | array | Array of indicator data points. |
| data[].openTime | ISO 8601 | Candle open timestamp (UTC). |
| data[].value | number | RSI value (0–100). Above 70 → overbought; below 30 → oversold. |
| totalCount | integer | Number of data points returned. |
Request
GET https://api.realmarketapi.com/api/v1/indicator/rsi?apiKey=YOUR_API_KEY&symbolCode=AAPL&timeFrame=H1&period=14Example response
Response · 200
{
"data": [
{ "openTime": "2026-03-08T09:00:00Z", "value": 62.4 }
],
"totalCount": 1
}MACD
Moving Average Convergence Divergence — trend-following momentum indicator. Returns the MACD line, signal line, and histogram.
Query parameters
| Name | Type | Description |
|---|---|---|
| apiKeyrequired | string | Your API authentication key. |
| symbolCoderequired | string | Trading symbol (e.g. XAUUSD, EURUSD, AAPL). |
| timeFramerequired | string | Candle interval: M1, M5, M15, H1, H4, D1. |
| fastPeriod | integer | Fast EMA period. Default: 12 |
| slowPeriod | integer | Slow EMA period. Default: 26 |
| signalPeriod | integer | Signal line EMA period. Default: 9 |
Response fields
| Field | Type | Description |
|---|---|---|
| data | array | Array of MACD data points. |
| data[].openTime | ISO 8601 | Candle open timestamp. |
| data[].macd | number | MACD line (fast EMA – slow EMA). |
| data[].signal | number | Signal line (EMA of MACD). |
| data[].histogram | number | Histogram (MACD – signal). Positive = bullish momentum. |
| totalCount | integer | Number of data points returned. |
Request
GET https://api.realmarketapi.com/api/v1/indicator/macd?apiKey=YOUR_API_KEY&symbolCode=AUDUSD&timeFrame=H1&fastPeriod=12&slowPeriod=26&signalPeriod=9Example response
Response · 200
{
"data": [
{
"openTime": "2026-03-08T09:00:00Z",
"macd": 0.00124,
"signal": 0.00098,
"histogram": 0.00026
}
],
"totalCount": 1
}Bollinger Bands
Bollinger Bands — volatility channels placed above and below a moving average. Band width expands during high volatility and contracts during low volatility.
Query parameters
| Name | Type | Description |
|---|---|---|
| apiKeyrequired | string | Your API authentication key. |
| symbolCoderequired | string | Trading symbol (e.g. XAUUSD, EURUSD, AAPL). |
| timeFramerequired | string | Candle interval: M1, M5, M15, H1, H4, D1. |
| period | integer | Lookback period (number of candles). Middle band SMA period. Default: 20 |
| multiplier | number | Standard deviation multiplier for band width. Default: 2 |
Response fields
| Field | Type | Description |
|---|---|---|
| data | array | Array of Bollinger Band data points. |
| data[].openTime | ISO 8601 | Candle open timestamp. |
| data[].upper | number | Upper band (middle + k×σ). |
| data[].middle | number | Middle band (SMA of period). |
| data[].lower | number | Lower band (middle – k×σ). |
| totalCount | integer | Number of data points returned. |
Request
GET https://api.realmarketapi.com/api/v1/indicator/bollinger-bands?apiKey=YOUR_API_KEY&symbolCode=EURUSD&timeFrame=H1&period=20&multiplier=2Example response
Response · 200
{
"data": [
{
"openTime": "2026-03-08T09:00:00Z",
"upper": 1.09245,
"middle": 1.08412,
"lower": 1.07579
}
],
"totalCount": 1
}Stochastic
Stochastic Oscillator — compares closing price to its price range over a lookback. Returns %K (main) and %D (signal) lines.
Query parameters
| Name | Type | Description |
|---|---|---|
| apiKeyrequired | string | Your API authentication key. |
| symbolCoderequired | string | Trading symbol (e.g. XAUUSD, EURUSD, AAPL). |
| timeFramerequired | string | Candle interval: M1, M5, M15, H1, H4, D1. |
| kPeriod | integer | %K period (main oscillator line). Default: 14 |
| dPeriod | integer | %D period (SMA of %K, signal line). Default: 3 |
Response fields
| Field | Type | Description |
|---|---|---|
| data | array | Array of stochastic data points. |
| data[].openTime | ISO 8601 | Candle open timestamp. |
| data[].k | number | %K line (0–100). Above 80 → overbought; below 20 → oversold. |
| data[].d | number | %D line (signal). %K crossing %D triggers trade signals. |
| totalCount | integer | Number of data points returned. |
Request
GET https://api.realmarketapi.com/api/v1/indicator/stochastic?apiKey=YOUR_API_KEY&symbolCode=XAUUSD&timeFrame=H1&kPeriod=14&dPeriod=3Example response
Response · 200
{
"data": [
{ "openTime": "2026-03-08T09:00:00Z", "k": 72.4, "d": 68.1 }
],
"totalCount": 1
}ATR
Average True Range — measures market volatility by averaging the true range of each candle over a period. Used for stop-loss sizing.
Query parameters
| Name | Type | Description |
|---|---|---|
| apiKeyrequired | string | Your API authentication key. |
| symbolCoderequired | string | Trading symbol (e.g. XAUUSD, EURUSD, AAPL). |
| timeFramerequired | string | Candle interval: M1, M5, M15, H1, H4, D1. |
| period | integer | Lookback period (number of candles). Standard: 14. Default: 14 |
Response fields
| Field | Type | Description |
|---|---|---|
| data | array | Array of indicator data points. |
| data[].openTime | ISO 8601 | Candle open timestamp (UTC). |
| data[].value | number | ATR value in price units. |
| totalCount | integer | Number of data points returned. |
Request
GET https://api.realmarketapi.com/api/v1/indicator/atr?apiKey=YOUR_API_KEY&symbolCode=XAUUSD&timeFrame=H1&period=14Example response
Response · 200
{
"data": [
{ "openTime": "2026-03-08T09:00:00Z", "value": 18.42 }
],
"totalCount": 1
}CCI
Commodity Channel Index — measures price deviation from its statistical mean. Values above +100 suggest overbought; below -100 oversold.
Query parameters
| Name | Type | Description |
|---|---|---|
| apiKeyrequired | string | Your API authentication key. |
| symbolCoderequired | string | Trading symbol (e.g. XAUUSD, EURUSD, AAPL). |
| timeFramerequired | string | Candle interval: M1, M5, M15, H1, H4, D1. |
| period | integer | Lookback period (number of candles). Common: 14, 20. Default: 20 |
Response fields
| Field | Type | Description |
|---|---|---|
| data | array | Array of indicator data points. |
| data[].openTime | ISO 8601 | Candle open timestamp (UTC). |
| data[].value | number | CCI value. Above +100 → overbought; below -100 → oversold. |
| totalCount | integer | Number of data points returned. |
Request
GET https://api.realmarketapi.com/api/v1/indicator/cci?apiKey=YOUR_API_KEY&symbolCode=EURUSD&timeFrame=H4&period=20Example response
Response · 200
{
"data": [
{ "openTime": "2026-03-08T08:00:00Z", "value": 142.8 }
],
"totalCount": 1
}Williams %R
Williams Percent Range — momentum oscillator ranging -100 to 0. Above -20 indicates overbought; below -80 indicates oversold.
Query parameters
| Name | Type | Description |
|---|---|---|
| apiKeyrequired | string | Your API authentication key. |
| symbolCoderequired | string | Trading symbol (e.g. XAUUSD, EURUSD, AAPL). |
| timeFramerequired | string | Candle interval: M1, M5, M15, H1, H4, D1. |
| period | integer | Lookback period (number of candles). Default: 14 |
Response fields
| Field | Type | Description |
|---|---|---|
| data | array | Array of indicator data points. |
| data[].openTime | ISO 8601 | Candle open timestamp (UTC). |
| data[].value | number | Williams %R value (-100 to 0). Above -20 → overbought; below -80 → oversold. |
| totalCount | integer | Number of data points returned. |
Request
GET https://api.realmarketapi.com/api/v1/indicator/williams-r?apiKey=YOUR_API_KEY&symbolCode=GBPUSD&timeFrame=H1&period=14Example response
Response · 200
{
"data": [
{ "openTime": "2026-03-08T09:00:00Z", "value": -24.6 }
],
"totalCount": 1
}ADX
Average Directional Index — quantifies trend strength (not direction). Returns ADX, +DI, and -DI. ADX above 25 indicates a strong trend.
Query parameters
| Name | Type | Description |
|---|---|---|
| apiKeyrequired | string | Your API authentication key. |
| symbolCoderequired | string | Trading symbol (e.g. XAUUSD, EURUSD, AAPL). |
| timeFramerequired | string | Candle interval: M1, M5, M15, H1, H4, D1. |
| period | integer | Lookback period (number of candles). Wilder smoothing period. Default: 14 |
Response fields
| Field | Type | Description |
|---|---|---|
| data | array | Array of ADX data points. |
| data[].openTime | ISO 8601 | Candle open timestamp. |
| data[].adx | number | ADX value (0–100). Above 25 → strong trend. |
| data[].diPlus | number | +DI directional indicator (bullish pressure). |
| data[].diMinus | number | -DI directional indicator (bearish pressure). |
| totalCount | integer | Number of data points returned. |
Request
GET https://api.realmarketapi.com/api/v1/indicator/adx?apiKey=YOUR_API_KEY&symbolCode=XAUUSD&timeFrame=H1&period=14Example response
Response · 200
{
"data": [
{
"openTime": "2026-03-08T09:00:00Z",
"adx": 28.5,
"diPlus": 22.1,
"diMinus": 15.3
}
],
"totalCount": 1
}Fibonacci Retracement
Computes Fibonacci retracement levels from the high/low of the last N candles. Returns key price zones at 0%, 23.6%, 38.2%, 50%, 61.8%, 78.6%, and 100%.
Query parameters
| Name | Type | Description |
|---|---|---|
| apiKeyrequired | string | Your API authentication key. |
| symbolCoderequired | string | Trading symbol (e.g. XAUUSD, EURUSD, AAPL). |
| timeFramerequired | string | Candle interval: M1, M5, M15, H1, H4, D1. |
| lookback | integer | Number of candles to scan for the high/low anchor (10–1000). Default: 100 |
Response fields
| Field | Type | Description |
|---|---|---|
| high | number | Highest price in the lookback window (100% level). |
| low | number | Lowest price in the lookback window (0% level). |
| r0 | number | 0.0% retracement level (= low). |
| r236 | number | 23.6% retracement level. |
| r382 | number | 38.2% retracement level. |
| r500 | number | 50.0% retracement level. |
| r618 | number | 61.8% retracement level (golden ratio). |
| r786 | number | 78.6% retracement level. |
| r1 | number | 100% retracement level (= high). |
| lookback | integer | Number of candles used for the computation. |
Request
GET https://api.realmarketapi.com/api/v1/indicator/fibonacci?apiKey=YOUR_API_KEY&symbolCode=XAUUSD&timeFrame=H1&lookback=50Example response
Response · 200
{
"high": 2078.43,
"low": 2011.28,
"r0": 2011.28,
"r236": 2027.12,
"r382": 2036.84,
"r500": 2044.86,
"r618": 2052.87,
"r786": 2063.94,
"r1": 2078.43,
"lookback": 50
}Support & Resistance
Returns computed support and resistance price levels with touch counts and timestamps, derived from historical price data.
Query parameters
| Name | Type | Description |
|---|---|---|
| apiKeyrequired | string | Your API authentication key. |
| symbolCoderequired | string | Trading symbol (e.g. XAUUSD, EURUSD, AAPL). |
| timeFramerequired | string | Candle interval: M1, M5, M15, H1, H4, D1. |
Response fields
| Field | Type | Description |
|---|---|---|
| support | array | Array of support level objects. |
| support[].price | number | Support price level. |
| support[].touchCount | integer | Number of times price tested this level. |
| support[].lastTouched | ISO 8601 | Most recent test timestamp (UTC). |
| resistance | array | Array of resistance level objects (same structure as support). |
Request
GET https://api.realmarketapi.com/api/v1/indicator/support-resistance?apiKey=YOUR_API_KEY&symbolCode=XAUUSD&timeFrame=H1Example response
Response · 200
{
"support": [
{ "price": 2011.50, "touchCount": 4, "lastTouched": "2026-03-06T12:00:00Z" },
{ "price": 1998.00, "touchCount": 2, "lastTouched": "2026-02-28T08:00:00Z" }
],
"resistance": [
{ "price": 2078.20, "touchCount": 3, "lastTouched": "2026-03-07T08:00:00Z" }
]
}Market Sentiment
Composite Fear & Greed score (0–100) combining RSI(14), MACD(12,26,9), and EMA-50/100 crossover into a single sentiment rating plus trend classification.
Query parameters
| Name | Type | Description |
|---|---|---|
| apiKeyrequired | string | Your API authentication key. |
| symbolCoderequired | string | Trading symbol (e.g. XAUUSD, EURUSD, AAPL). |
| timeFramerequired | string | Candle interval: M1, M5, M15, H1, H4, D1. |
Response fields
| Field | Type | Description |
|---|---|---|
| fearGreedScore | integer | 0 = Extreme Fear · 100 = Extreme Greed. |
| sentiment | string | Label: ExtremeFear | Fear | Neutral | Greed | ExtremeGreed. |
| trend | string | Trend: StrongUptrend | Uptrend | Sideways | Downtrend | StrongDowntrend. |
| rsi | number | RSI(14) value used in the composite. |
| macdHistogram | number | MACD histogram value used in the composite. |
| ema50 | number | 50-period EMA. |
| ema100 | number | 100-period EMA. |
| calculatedAt | ISO 8601 | Timestamp of the composite calculation. |
Request
GET https://api.realmarketapi.com/api/v1/indicator/sentiment?apiKey=YOUR_API_KEY&symbolCode=EURUSD&timeFrame=H1Example response
Response · 200
{
"symbolCode": "EURUSD",
"timeFrame": "H1",
"calculatedAt": "2026-03-08T09:00:00Z",
"trend": "StrongUptrend",
"sentiment": "Greed",
"fearGreedScore": 68,
"rsi": 61.4,
"macdHistogram": 0.000312,
"ema50": 1.08254,
"ema100": 1.07981,
"currentClose": 1.08420
}Volatility
3 endpoints · Starter+
Core Endpoints
Volatility Metrics
Returns ATR, ATR%, Bollinger bandwidth, and historical volatility per bar over the requested period. Ideal for regime detection and risk management.
Query parameters
| Name | Type | Description |
|---|---|---|
| apiKeyrequired | string | Your API authentication key. |
| symbolCoderequired | string | Trading symbol (e.g. XAUUSD, EURUSD, AAPL). |
| timeFramerequired | string | Candle interval: M1, M5, M15, H1, H4, D1. |
| period | integer | Lookback period for ATR and historical volatility calculation. Default: 14 |
Response fields
| Field | Type | Description |
|---|---|---|
| data | array | Array of volatility data points. |
| data[].openTime | ISO 8601 | Candle open timestamp. |
| data[].atr | number | Average True Range (in price units). |
| data[].atrPercent | number | ATR as a percentage of the close price. |
| data[].bandWidth | number | Bollinger Band width as a percentage. |
| data[].historicalVolatility | number | Annualised historical volatility (0–1+ scale). |
| totalCount | integer | Number of data points returned. |
Request
GET https://api.realmarketapi.com/api/v1/volatility?apiKey=YOUR_API_KEY&symbolCode=BTCUSD&timeFrame=H1&period=14Example response
Response · 200
{
"data": [
{
"openTime": "2025-06-01T08:00:00Z",
"atr": 1234.56,
"atrPercent": 1.8432,
"bandWidth": 7.2418,
"historicalVolatility": 0.9751
}
],
"totalCount": 1
}Volatility Spikes
Identifies candles where ATR exceeded N× the rolling average ATR. Returns each spike event with direction and the exact multiplier reached.
Query parameters
| Name | Type | Description |
|---|---|---|
| apiKeyrequired | string | Your API authentication key. |
| symbolCoderequired | string | Trading symbol (e.g. XAUUSD, EURUSD, AAPL). |
| timeFramerequired | string | Candle interval: M1, M5, M15, H1, H4, D1. |
| period | integer | ATR lookback period. Default: 14 |
| spikeMultiplier | number | ATR / avg-ATR threshold to qualify as a spike (1.1 – 10.0). Default: 2.0 |
Response fields
| Field | Type | Description |
|---|---|---|
| data | array | Array of detected spike events. |
| data[].openTime | ISO 8601 | Candle open timestamp. |
| data[].atr | number | ATR at this spike candle. |
| data[].atrAverage | number | Rolling average ATR used for comparison. |
| data[].multiplierReached | number | Actual ATR / avg-ATR ratio (always ≥ spikeMultiplier). |
| data[].direction | string | "Bullish" or "Bearish" based on candle close vs open. |
| totalCount | integer | Number of spike events detected. |
Request
GET https://api.realmarketapi.com/api/v1/volatility/spikes?apiKey=YOUR_API_KEY&symbolCode=BTCUSD&timeFrame=H1&period=14&spikeMultiplier=2.0Example response
Response · 200
{
"data": [
{
"openTime": "2025-05-12T14:00:00Z",
"atr": 3512.88,
"atrAverage": 1204.32,
"multiplierReached": 2.92,
"direction": "Bearish"
}
],
"totalCount": 1
}Volatility Heatmap
Returns volatility metrics across all supported timeframes in a single call, enabling a cross-timeframe volatility heatmap view.
Query parameters
| Name | Type | Description |
|---|---|---|
| apiKeyrequired | string | Your API authentication key. |
| symbolCoderequired | string | Trading symbol (e.g. XAUUSD, EURUSD, AAPL). |
| timeFramerequired | string | Candle interval: M1, M5, M15, H1, H4, D1. |
Response fields
| Field | Type | Description |
|---|---|---|
| data | array | Array of per-timeframe volatility summaries. |
| data[].timeFrame | string | Timeframe identifier (M1, M5, M15, H1, H4, D1). |
| data[].atr | number | Average True Range for this timeframe. |
| data[].atrPercent | number | ATR as a percentage of the close price. |
| data[].bandWidth | number | Bollinger Band width (%). |
| data[].historicalVolatility | number | Annualised historical volatility. |
Request
GET https://api.realmarketapi.com/api/v1/volatility/heatmap?apiKey=YOUR_API_KEY&symbolCode=BTCUSD&timeFrame=H1Example response
Response · 200
{
"data": [
{ "timeFrame": "M1", "atr": 142.30, "atrPercent": 0.21, "bandWidth": 1.42, "historicalVolatility": 0.87 },
{ "timeFrame": "H1", "atr": 1234.56, "atrPercent": 1.84, "bandWidth": 7.24, "historicalVolatility": 0.98 },
{ "timeFrame": "D1", "atr": 3812.00, "atrPercent": 5.67, "bandWidth": 18.4, "historicalVolatility": 1.12 }
]
}Intelligence
20 endpoints
Alert Endpoints
Create Alert
Creates an alert rule for price or strategy conditions. Supports cooldowns and multi-channel delivery. Telegram alert notifications are delivered through @RealMarketAPISaasBot.
Query parameters
| Name | Type | Description |
|---|---|---|
| apiKeyrequired | string | Your API authentication key. |
| symbolCoderequired | string (body) | Symbol to watch (e.g. BTCUSD). |
| timeFramerequired | string (body) | Candle interval: M1, M5, M15, H1, H4, D1. |
| ruleTyperequired | string (body) | Alert rule type, e.g. PriceCrossAbove. |
| thresholdrequired | number (body) | Trigger level. Must be greater than 0. |
| cooldownSeconds | integer (body) | Minimum seconds between notifications. Default: 300 |
| channels | string[] (body) | Delivery channels. |
| idempotencyKey | string (body) | Optional unique key for safe retries. Can also be sent as an Idempotency-Key header. |
Response fields
| Field | Type | Description |
|---|---|---|
| alertId | string | Created alert identifier. |
| status | string | Initial alert status, typically Active. |
| createdDate | ISO 8601 | When the alert was created. |
Request
POST https://api.realmarketapi.com/api/v1/alerts?apiKey=YOUR_API_KEY
Content-Type: application/json
{
"symbolCode": "BTCUSD",
"timeFrame": "H1",
"ruleType": "PriceCrossAbove",
"threshold": 70000,
"cooldownSeconds": 300,
"channels": ["Email", "Webhook"]
}Delivery example · Telegram
🔔 Alert set!
📌 Symbol: XAUUSD
💰 Current: 4,328.81600
🎯 Target: 4,300.00000 (drops below ⬇️)
🆔 ID: 019e9dd6
You'll be notified when the price triggers.
View alerts: /alert listExample response
Response · 200
{
"alertId": "alt_01J2Z7XK7W6CV4R7K5",
"status": "Active",
"createdDate": "2026-06-11T09:40:00Z"
}List Alerts
Returns the account's alerts, optionally filtered by status.
Query parameters
| Name | Type | Description |
|---|---|---|
| apiKeyrequired | string | Your API authentication key. |
| status | string | Optional status filter, e.g. Active. |
Response fields
| Field | Type | Description |
|---|---|---|
| data | array | Alert rows. |
| data[].alertId | string | Alert identifier. |
| data[].symbolCode | string | Symbol code. |
| data[].timeFrame | string | Candle interval the rule evaluates. |
| data[].ruleType | string | Alert rule type. |
| data[].threshold | number | Trigger level. |
| data[].status | string | Current lifecycle status. |
| data[].createdDate | ISO 8601 | When the alert was created. |
| totalCount | integer | Number of alerts returned. |
Request
GET https://api.realmarketapi.com/api/v1/alerts?apiKey=YOUR_API_KEY&status=ActiveExample response
Response · 200
{
"data": [
{
"alertId": "alt_01J2Z7XK7W6CV4R7K5",
"symbolCode": "BTCUSD",
"timeFrame": "H1",
"ruleType": "PriceCrossAbove",
"threshold": 70000,
"status": "Active",
"createdDate": "2026-06-11T09:40:00Z"
}
],
"totalCount": 1
}Delete Alert
Deletes an existing alert by ID.
Query parameters
| Name | Type | Description |
|---|---|---|
| apiKeyrequired | string | Your API authentication key. |
| AlertIdrequired | path | Alert identifier to delete. |
Response fields
| Field | Type | Description |
|---|---|---|
| alertId | string | Deleted alert identifier. |
| deleted | boolean | Deletion success flag. |
Request
DELETE https://api.realmarketapi.com/api/v1/alerts/alt_01J2Z7XK7W6CV4R7K5?apiKey=YOUR_API_KEYExample response
Response · 200
{
"alertId": "alt_01J2Z7XK7W6CV4R7K5",
"deleted": true
}Signal Endpoints
Run Screener Query
Runs a multi-filter screener query and returns ranked matching symbols.
Query parameters
| Name | Type | Description |
|---|---|---|
| apiKeyrequired | string | Your API authentication key. |
| timeFramerequired | string (body) | Candle interval: M1, M5, M15, H1, H4, D1. |
| trend | string (body) | Optional trend filter, e.g. Bullish. |
| minRsi | number (body) | Optional minimum RSI. |
| maxVolatilityPct | number (body) | Optional maximum volatility percent. |
| minLiquidityScore | number (body) | Optional minimum liquidity score. |
| sortField | string (body) | Field to sort by. Default: SignalScore |
| sortDirection | string (body) | Asc or Desc. Default: Desc |
| size | integer (body) | Maximum rows returned, 1 to 100. Default: 25 |
Response fields
| Field | Type | Description |
|---|---|---|
| data | array | Matched symbols sorted by the query sort settings. |
| data[].symbolCode | string | Matched symbol. |
| data[].trend | string | Trend classification. |
| data[].signalScore | number | Composite signal score. |
| data[].rsi | number | RSI value. |
| data[].volatilityPct | number | Volatility percent. |
| data[].liquidityScore | number | Liquidity score. |
| totalCount | integer | Number of rows returned. |
Request
POST https://api.realmarketapi.com/api/v1/screener/query?apiKey=YOUR_API_KEY
Content-Type: application/json
{
"timeFrame": "H1",
"trend": "Bullish",
"minRsi": 55,
"maxVolatilityPct": 3.5,
"minLiquidityScore": 70,
"sortField": "SignalScore",
"sortDirection": "Desc",
"size": 25
}Example response
Response · 200
{
"data": [
{
"symbolCode": "ETHUSD",
"trend": "Bullish",
"signalScore": 82,
"rsi": 61.4,
"volatilityPct": 2.9,
"liquidityScore": 75
}
],
"totalCount": 1
}Strategy Signal
Returns composite strategy signal, confidence, risk level, and invalidation guidance for a symbol/timeframe.
Query parameters
| Name | Type | Description |
|---|---|---|
| apiKeyrequired | string | Your API authentication key. |
| symbolCoderequired | string | Trading symbol (e.g. XAUUSD, EURUSD, AAPL). |
| timeFramerequired | string | Candle interval: M1, M5, M15, H1, H4, D1. |
Response fields
| Field | Type | Description |
|---|---|---|
| signal | string | Buy | Sell | Neutral. |
| confidence | number | Confidence score in range 0..1. |
| riskLevel | string | Low | Medium | High. |
| invalidationPrice | number | Price level that invalidates current signal. |
| reasons | string[] | Supporting signal factors. |
Request
GET https://api.realmarketapi.com/api/v1/signals/strategy?apiKey=YOUR_API_KEY&symbolCode=BTCUSD&timeFrame=H1Example response
Response · 200
{
"symbolCode": "BTCUSD",
"timeFrame": "H1",
"signal": "Buy",
"confidence": 0.81,
"riskLevel": "Medium",
"invalidationPrice": 66850.0,
"reasons": ["TrendAlignment", "MomentumConfirmation"]
}Watchlist Endpoints
Create Watchlist
Creates a named watchlist for account-scoped symbol tracking.
Query parameters
| Name | Type | Description |
|---|---|---|
| apiKeyrequired | string | Your API authentication key. |
| namerequired | string (body) | Watchlist name. |
| tags | string[] (body) | Optional tags. |
| notes | string (body) | Optional notes. |
| idempotencyKey | string (body) | Optional unique key for safe create retries. Can also be sent as an Idempotency-Key header. |
Response fields
| Field | Type | Description |
|---|---|---|
| watchlistId | string | Created watchlist identifier. |
| name | string | Watchlist name. |
| tags | string[] | Optional watchlist tags. |
Request
POST https://api.realmarketapi.com/api/v1/watchlists?apiKey=YOUR_API_KEY
Content-Type: application/json
{
"name": "Momentum Watch",
"tags": ["swing", "crypto"],
"notes": "Top momentum symbols"
}Example response
Response · 200
{
"watchlistId": "wl_01J2Z8P8XQ3XVD28QW",
"name": "Momentum Watch",
"tags": ["swing", "crypto"]
}List Watchlists
Returns all watchlists for the authenticated account.
Query parameters
| Name | Type | Description |
|---|---|---|
| apiKeyrequired | string | Your API authentication key. |
Response fields
| Field | Type | Description |
|---|---|---|
| data | array | Watchlist summaries. |
| data[].watchlistId | string | Watchlist identifier. |
| data[].name | string | Watchlist name. |
| data[].tags | string[] | Watchlist tags. |
| data[].itemCount | integer | Number of symbols in watchlist. |
| totalCount | integer | Number of watchlists returned. |
Request
GET https://api.realmarketapi.com/api/v1/watchlists?apiKey=YOUR_API_KEYExample response
Response · 200
{
"data": [
{
"watchlistId": "wl_01J2Z8P8XQ3XVD28QW",
"name": "Momentum Watch",
"tags": ["swing", "crypto"],
"itemCount": 3
}
],
"totalCount": 1
}Add Watchlist Item
Adds a symbol to a watchlist with explicit display order.
Query parameters
| Name | Type | Description |
|---|---|---|
| apiKeyrequired | string | Your API authentication key. |
| watchlistIdrequired | path | Target watchlist identifier. |
| symbolCoderequired | string (body) | Symbol to add. |
| order | integer (body) | Display order, 0 or greater. |
| idempotencyKey | string (body) | Optional unique key for safe retries. Can also be sent as an Idempotency-Key header. |
Response fields
| Field | Type | Description |
|---|---|---|
| watchlistId | string | Target watchlist identifier. |
| symbolCode | string | Added symbol. |
| order | integer | Display order in watchlist. |
Request
POST https://api.realmarketapi.com/api/v1/watchlists/wl_01J2Z8P8XQ3XVD28QW/items?apiKey=YOUR_API_KEY
Content-Type: application/json
{
"symbolCode": "ETHUSD",
"order": 1
}Example response
Response · 200
{
"watchlistId": "wl_01J2Z8P8XQ3XVD28QW",
"symbolCode": "ETHUSD",
"order": 1
}Remove Watchlist Item
Removes a symbol from a watchlist.
Query parameters
| Name | Type | Description |
|---|---|---|
| apiKeyrequired | string | Your API authentication key. |
| watchlistIdrequired | path | Target watchlist identifier. |
| symbolCoderequired | path | Symbol to remove. |
Response fields
| Field | Type | Description |
|---|---|---|
| removed | boolean | Removal success flag. |
| watchlistId | string | Watchlist identifier. |
| symbolCode | string | Removed symbol. |
Request
DELETE https://api.realmarketapi.com/api/v1/watchlists/wl_01J2Z8P8XQ3XVD28QW/items/ETHUSD?apiKey=YOUR_API_KEYExample response
Response · 200
{
"watchlistId": "wl_01J2Z8P8XQ3XVD28QW",
"symbolCode": "ETHUSD",
"removed": true
}Insight Endpoints
Next-Candle Forecast
Returns a full next-candle forecast with key indicators, bias scoring (5-signal), and ATR-based price targets. REST equivalent of the Telegram /next command.
Query parameters
| Name | Type | Description |
|---|---|---|
| apiKeyrequired | string | Your API authentication key. |
| symbolCoderequired | string | Trading symbol (e.g. XAUUSD, EURUSD, AAPL). |
| timeFramerequired | string | Candle interval: M1, M5, M15, H1, H4, D1. |
Response fields
| Field | Type | Description |
|---|---|---|
| symbolCode | string | Symbol identifier. |
| timeFrame | string | Requested timeframe. |
| calculatedAt | ISO 8601 | Timestamp of calculation (UTC). |
| price | decimal | Current close price. |
| bias | string | Bullish | Bearish | Neutral — overall signal direction. |
| bullScore | int | Number of bullish signals out of 5. |
| bearScore | int | Number of bearish signals out of 5. |
| targetUp | decimal | Price + 1 ATR target. |
| targetDown | decimal | Price − 1 ATR target. |
| signals | array | 5 named signals each with a direction. |
Request
GET https://api.realmarketapi.com/api/v1/insight/next?apiKey=YOUR_API_KEY&symbolCode=BTCUSD&timeFrame=H1Example response
Response · 200
{
"symbolCode": "BTCUSD",
"timeFrame": "H1",
"calculatedAt": "2025-01-15T10:00:00+00:00",
"price": 94500.00,
"bias": "Bullish",
"bullScore": 4,
"bearScore": 1,
"targetUp": 94920.12,
"targetDown": 94079.88,
"signals": [
{ "name": "Price vs EMA Trend", "direction": "Bullish" },
{ "name": "EMA 21 vs EMA 50", "direction": "Bullish" },
{ "name": "RSI Momentum", "direction": "Bullish" },
{ "name": "Support/Resistance", "direction": "Bullish" },
{ "name": "Volume", "direction": "Neutral" }
]
}Trend Classification
Classifies the current trend direction using EMA alignment and ADX strength. Returns StrongUptrend, Uptrend, Sideways, Downtrend, or StrongDowntrend.
Query parameters
| Name | Type | Description |
|---|---|---|
| apiKeyrequired | string | Your API authentication key. |
| symbolCoderequired | string | Trading symbol (e.g. XAUUSD, EURUSD, AAPL). |
| timeFramerequired | string | Candle interval: M1, M5, M15, H1, H4, D1. |
Response fields
| Field | Type | Description |
|---|---|---|
| trend | string | StrongUptrend | Uptrend | Sideways | Downtrend | StrongDowntrend. |
| description | string | Human-readable explanation. |
| adx | decimal | ADX value — ≥25 = trending, <20 = ranging. |
| ema21 | decimal | EMA 21 value. |
| ema50 | decimal | EMA 50 value. |
| price | decimal | Current close price. |
Request
GET https://api.realmarketapi.com/api/v1/insight/trend?apiKey=YOUR_API_KEY&symbolCode=EURUSD&timeFrame=H4Example response
Response · 200
{
"symbolCode": "EURUSD",
"timeFrame": "H4",
"calculatedAt": "2025-01-15T08:00:00+00:00",
"trend": "StrongUptrend",
"description": "EURUSD is in a strong uptrend on H4 (ADX 31.2, price above EMA 21 & 50)",
"adx": 31.20,
"ema21": 1.09345,
"ema50": 1.08912,
"price": 1.09720
}Market Setup Detection
Detects the current market setup pattern: Breakout (with volume confirmation), Pullback into trend, or Range-bound. Returns direction and nearby S/R levels.
Query parameters
| Name | Type | Description |
|---|---|---|
| apiKeyrequired | string | Your API authentication key. |
| symbolCoderequired | string | Trading symbol (e.g. XAUUSD, EURUSD, AAPL). |
| timeFramerequired | string | Candle interval: M1, M5, M15, H1, H4, D1. |
Response fields
| Field | Type | Description |
|---|---|---|
| setup | string | Breakout | Pullback | Range | None. |
| direction | string | Bullish | Bearish | Neutral. |
| description | string | Human-readable setup summary. |
| price | decimal | Current close price. |
| nearestSupport | decimal | Nearest support level. |
| nearestResistance | decimal | Nearest resistance level. |
Request
GET https://api.realmarketapi.com/api/v1/insight/setup?apiKey=YOUR_API_KEY&symbolCode=XAUUSD&timeFrame=M15Example response
Response · 200
{
"symbolCode": "XAUUSD",
"timeFrame": "M15",
"calculatedAt": "2025-01-15T09:45:00+00:00",
"setup": "Breakout",
"direction": "Bullish",
"description": "Bullish breakout above resistance 2685.50 with volume confirmation on M15.",
"price": 2686.10,
"nearestSupport": 2672.34,
"nearestResistance": 2685.50
}Confluence Signal
Combines RSI, moving averages, and S/R into a single Buy/Sell/Neutral signal with a 0–100 confidence score and listed reasons.
Query parameters
| Name | Type | Description |
|---|---|---|
| apiKeyrequired | string | Your API authentication key. |
| symbolCoderequired | string | Trading symbol (e.g. XAUUSD, EURUSD, AAPL). |
| timeFramerequired | string | Candle interval: M1, M5, M15, H1, H4, D1. |
Response fields
| Field | Type | Description |
|---|---|---|
| signal | string | Buy | Sell | Neutral. |
| strength | string | Weak | Moderate | Strong. |
| score | int | 0–100 — percentage of signals confirming the direction. |
| reasons | string[] | List of contributing factors. |
Request
GET https://api.realmarketapi.com/api/v1/insight/confluence?apiKey=YOUR_API_KEY&symbolCode=BTCUSD&timeFrame=H1Example response
Response · 200
{
"symbolCode": "BTCUSD",
"timeFrame": "H1",
"calculatedAt": "2025-01-15T10:00:00+00:00",
"signal": "Buy",
"strength": "Strong",
"score": 83,
"reasons": [
"RSI bullish momentum (57.3)",
"Price above EMA 21 & 50 — bullish alignment",
"Price holding near support 93200.00 — bullish bounce zone"
],
"rsi": 57.30,
"ema21": 93800.12,
"ema50": 92100.65,
"price": 94500.00,
"nearestSupport": 93200.00,
"nearestResistance": 95800.00
}Bullish/Bearish Score
Returns a composite 0–100 bullish/bearish strength score from five equally-weighted components: RSI, MACD, EMA alignment, ADX direction, and price range position.
Query parameters
| Name | Type | Description |
|---|---|---|
| apiKeyrequired | string | Your API authentication key. |
| symbolCoderequired | string | Trading symbol (e.g. XAUUSD, EURUSD, AAPL). |
| timeFramerequired | string | Candle interval: M1, M5, M15, H1, H4, D1. |
Response fields
| Field | Type | Description |
|---|---|---|
| score | int | 0 (extreme bearish) to 100 (extreme bullish). |
| label | string | StrongBullish | Bullish | Neutral | Bearish | StrongBearish. |
| macdHistogram | decimal | Current MACD histogram value. |
| adx | decimal | Current ADX value. |
| factors | string[] | Per-component breakdown (e.g. 'RSI 58.4 → 12/20 pts'). |
Request
GET https://api.realmarketapi.com/api/v1/insight/score?apiKey=YOUR_API_KEY&symbolCode=EURUSD&timeFrame=H1Example response
Response · 200
{
"symbolCode": "EURUSD",
"timeFrame": "H1",
"calculatedAt": "2025-01-15T10:00:00+00:00",
"score": 72,
"label": "Bullish",
"rsi": 58.40,
"macdHistogram": 0.000142,
"adx": 28.50,
"price": 1.09720,
"factors": [
"RSI 58.4 → 12/20 pts",
"MACD histogram positive → 20/20 pts",
"Price above EMA 21 & 50 → 20/20 pts",
"ADX 28.5 +DI dominant → 20/20 pts",
"Price position in 20-candle range → 0/20 pts"
]
}Advanced Endpoints
Multi-Timeframe Trend
Returns the trend direction for every plan-allowed timeframe in a single call. Timeframes without sufficient data are silently omitted.
Query parameters
| Name | Type | Description |
|---|---|---|
| apiKeyrequired | string | Your API authentication key. |
| symbolCoderequired | string | Trading symbol (e.g. XAUUSD, EURUSD, AAPL). |
Response fields
| Field | Type | Description |
|---|---|---|
| symbolCode | string | Symbol identifier. |
| calculatedAt | ISO 8601 | Calculation timestamp (UTC). |
| timeframes | object | Dictionary of TimeFrame → trend label. |
| timeframes[key] | string | StrongBullish | Bullish | Neutral | Bearish | StrongBearish. |
Request
GET https://api.realmarketapi.com/api/v1/multi-timeframe?apiKey=YOUR_API_KEY&symbolCode=BTCUSDExample response
Response · 200
{
"symbolCode": "BTCUSD",
"calculatedAt": "2025-01-15T10:00:00+00:00",
"timeframes": {
"M5": "Bullish",
"M15": "StrongBullish",
"H1": "Neutral",
"H4": "Bearish",
"D1": "StrongBearish"
}
}Liquidity Zones
Returns key support and resistance clusters acting as liquidity pools, ordered by proximity to current price. Each zone includes touch count and relative strength.
Query parameters
| Name | Type | Description |
|---|---|---|
| apiKeyrequired | string | Your API authentication key. |
| symbolCoderequired | string | Trading symbol (e.g. XAUUSD, EURUSD, AAPL). |
| timeFramerequired | string | Candle interval: M1, M5, M15, H1, H4, D1. |
Response fields
| Field | Type | Description |
|---|---|---|
| currentPrice | decimal | Current close price. |
| zones | array | Array of liquidity zones sorted nearest-first. |
| zones[].price | decimal | Zone price level. |
| zones[].type | string | Support | Resistance. |
| zones[].touchCount | int | Number of times price has touched this level. |
| zones[].strength | string | Weak (1 touch) | Moderate (2–3) | Strong (≥4). |
Request
GET https://api.realmarketapi.com/api/v1/liquidity/zones?apiKey=YOUR_API_KEY&symbolCode=XAUUSD&timeFrame=H1Example response
Response · 200
{
"symbolCode": "XAUUSD",
"timeFrame": "H1",
"calculatedAt": "2025-01-15T10:00:00+00:00",
"currentPrice": 2684.50,
"zones": [
{ "price": 2685.50, "type": "Resistance", "touchCount": 4, "strength": "Strong", "lastTouchedAt": "2025-01-14T16:00:00+00:00" },
{ "price": 2672.34, "type": "Support", "touchCount": 2, "strength": "Moderate", "lastTouchedAt": "2025-01-13T08:00:00+00:00" }
]
}Order Flow Imbalance
Measures order flow imbalance over the last 50 candles — bullish vs bearish ratio and candles with abnormally large bodies (≥1.5× average). Returns up to 10 recent imbalance zones.
Query parameters
| Name | Type | Description |
|---|---|---|
| apiKeyrequired | string | Your API authentication key. |
| symbolCoderequired | string | Trading symbol (e.g. XAUUSD, EURUSD, AAPL). |
| timeFramerequired | string | Candle interval: M1, M5, M15, H1, H4, D1. |
Response fields
| Field | Type | Description |
|---|---|---|
| currentImbalance | string | Bullish (>60% bull) | Bearish (>60% bear) | Neutral. |
| bullishRatio | decimal | Percentage of bullish candles in last 50. |
| bearishRatio | decimal | Percentage of bearish candles in last 50. |
| recentImbalanceZones | array | Up to 10 most recent large-body candles. |
| recentImbalanceZones[].bodyMultiplier | decimal | Body size relative to average body size. |
| recentImbalanceZones[].direction | string | Bullish | Bearish. |
Request
GET https://api.realmarketapi.com/api/v1/orderflow/imbalance?apiKey=YOUR_API_KEY&symbolCode=BTCUSD&timeFrame=M15Example response
Response · 200
{
"symbolCode": "BTCUSD",
"timeFrame": "M15",
"calculatedAt": "2025-01-15T09:45:00+00:00",
"currentImbalance": "Bullish",
"bullishRatio": 64.0,
"bearishRatio": 36.0,
"recentImbalanceZones": [
{ "openTime": "2025-01-15T09:30:00+00:00", "open": 94200.00, "close": 94580.00, "direction": "Bullish", "bodyMultiplier": 2.30, "volume": 3840.0 }
]
}Stop Hunt Zones
Identifies price levels just beyond key S/R where retail stop orders cluster (buffer = 0.5×ATR). Flags zones recently swept by a wick that closed back inside. Up to 5 support + 5 resistance zones returned.
Query parameters
| Name | Type | Description |
|---|---|---|
| apiKeyrequired | string | Your API authentication key. |
| symbolCoderequired | string | Trading symbol (e.g. XAUUSD, EURUSD, AAPL). |
| timeFramerequired | string | Candle interval: M1, M5, M15, H1, H4, D1. |
Response fields
| Field | Type | Description |
|---|---|---|
| currentPrice | decimal | Current close price. |
| zones | array | Zones sorted nearest-first. |
| zones[].price | decimal | Stop cluster price level. |
| zones[].type | string | BelowSupport | AboveResistance. |
| zones[].recentlyHunted | bool | true if a candle in the last 10 wicked through and closed back inside. |
| zones[].huntedAt | ISO 8601? | Timestamp of the most recent hunt event, or null. |
Request
GET https://api.realmarketapi.com/api/v1/stop-hunt/zones?apiKey=YOUR_API_KEY&symbolCode=EURUSD&timeFrame=H1Example response
Response · 200
{
"symbolCode": "EURUSD",
"timeFrame": "H1",
"calculatedAt": "2025-01-15T10:00:00+00:00",
"currentPrice": 1.09720,
"zones": [
{ "price": 1.09485, "type": "BelowSupport", "description": "Stop cluster below support 1.09532", "recentlyHunted": true, "huntedAt": "2025-01-15T06:00:00+00:00" },
{ "price": 1.09967, "type": "AboveResistance", "description": "Stop cluster above resistance 1.09920", "recentlyHunted": false, "huntedAt": null }
]
}Market Anomalies
Scans the last 50 candles for three anomaly types: PriceSpike (>2.5σ range), UnusualVolume (>2.0σ volume), and FakeBreakout (wick through S/R + close inside). Up to 20 most recent anomalies returned.
Query parameters
| Name | Type | Description |
|---|---|---|
| apiKeyrequired | string | Your API authentication key. |
| symbolCoderequired | string | Trading symbol (e.g. XAUUSD, EURUSD, AAPL). |
| timeFramerequired | string | Candle interval: M1, M5, M15, H1, H4, D1. |
Response fields
| Field | Type | Description |
|---|---|---|
| hasAnomalies | bool | true if at least one anomaly was detected. |
| anomalies | array | Array of anomaly events. |
| anomalies[].type | string | PriceSpike | UnusualVolume | FakeBreakout. |
| anomalies[].value | decimal | The measured value that triggered the anomaly. |
| anomalies[].threshold | decimal | The statistical threshold that was exceeded. |
| anomalies[].description | string | Human-readable description. |
Request
GET https://api.realmarketapi.com/api/v1/anomaly?apiKey=YOUR_API_KEY&symbolCode=BTCUSD&timeFrame=M15Example response
Response · 200
{
"symbolCode": "BTCUSD",
"timeFrame": "M15",
"calculatedAt": "2025-01-15T09:45:00+00:00",
"hasAnomalies": true,
"anomalies": [
{ "openTime": "2025-01-15T08:15:00+00:00", "type": "PriceSpike", "value": 980.50, "threshold": 720.30, "description": "Candle range 980.50 exceeded 2.5σ threshold 720.30" },
{ "openTime": "2025-01-15T06:00:00+00:00", "type": "FakeBreakout", "value": 93180.00, "threshold": 93200.00, "description": "Wick below support 93200 but closed back above" }
]
}Manipulation Risk
Assesses manipulation probability based on wick-to-body ratio, volume divergence, and recent fake breakout frequency. Analysis window: last 20 candles.
Query parameters
| Name | Type | Description |
|---|---|---|
| apiKeyrequired | string | Your API authentication key. |
| symbolCoderequired | string | Trading symbol (e.g. XAUUSD, EURUSD, AAPL). |
| timeFramerequired | string | Candle interval: M1, M5, M15, H1, H4, D1. |
Response fields
| Field | Type | Description |
|---|---|---|
| riskLevel | string | Low | Medium | High. |
| riskScore | int | 0–100 composite manipulation risk score. |
| factors | string[] | List of contributing risk factors. |
| avgWickToBodyRatio | decimal | Average total-wick ÷ body ratio over last 20 candles. |
| currentVolume | decimal | Current candle volume. |
| avgVolume | decimal | Average volume over the analysis window. |
Request
GET https://api.realmarketapi.com/api/v1/manipulation-risk?apiKey=YOUR_API_KEY&symbolCode=XAUUSD&timeFrame=M15Example response
Response · 200
{
"symbolCode": "XAUUSD",
"timeFrame": "M15",
"calculatedAt": "2025-01-15T09:45:00+00:00",
"riskLevel": "High",
"riskScore": 75,
"factors": [
"Very high wick-to-body ratio (3.40x) — strong indecision or stop hunting",
"Large price move with low volume — volume divergence detected",
"3 fake breakout(s) in last 5 candles — potential stop-hunt activity"
],
"avgWickToBodyRatio": 3.40,
"currentVolume": 420.0,
"avgVolume": 1240.0
}Try it in the Playground
Send real requests and inspect live responses in the browser.