API reference · Pro+
Intelligence API
11 endpoints for bias scoring, trend detection, confluence, liquidity, order flow, anomalies and manipulation risk.
Overview
Pro plan and above
All Intelligence API endpoints require an active Pro plan or higher; Free, Starter and Plus plans do not have access. Authenticate with the
apiKey query parameter. SymbolCode and TimeFrame use PascalCase.- Base URL
- https://api.realmarketapi.com/api/v1
- Method
- GET
- Format
- JSON
| Endpoint | Name |
|---|---|
| GET/api/v1/insight/next | Next-Candle Forecast |
| GET/api/v1/insight/trend | Trend Classification |
| GET/api/v1/insight/setup | Market Setup Detection |
| GET/api/v1/insight/confluence | Confluence Signal |
| GET/api/v1/insight/score | Bullish/Bearish Score |
| GET/api/v1/multi-timeframe | Multi-Timeframe Trend |
| GET/api/v1/liquidity/zones | Liquidity Zones |
| GET/api/v1/orderflow/imbalance | Order Flow Imbalance |
| GET/api/v1/stop-hunt/zones | Stop Hunt Zones |
| GET/api/v1/anomaly | Market Anomalies |
| GET/api/v1/manipulation-risk | Manipulation Risk |
Next-Candle Forecast
Returns a next-candle forecast with EMA 21/50, RSI, ATR, Volume, Support/Resistance, bias scoring (5 signals), and ATR-based price targets (Target Up / Target Down). Equivalent to the Telegram /next command.
Query parameters
| Name | Type | Description |
|---|---|---|
| apiKeyrequired | string | Your API authentication key. |
| SymbolCoderequired | string | Trading symbol (e.g. BTCUSD, XAUUSD, EURUSD). |
| 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 | Calculation timestamp (UTC). |
| price | decimal | Current close price. |
| ema21 | decimal | EMA 21 value. |
| ema50 | decimal | EMA 50 value. |
| rsi | decimal | RSI value. |
| atr | decimal | Average True Range value. |
| volume | decimal | Current candle volume. |
| avgVolume | decimal | Average volume over the analysis window. |
| support | decimal | Nearest support level. |
| resistance | decimal | Nearest resistance level. |
| 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 level. |
| targetDown | decimal | Price − 1 ATR target level. |
| signals | array | 5 named signals each with name and direction (Bullish/Bearish/Neutral). |
Request
GET https://api.realmarketapi.com/api/v1/insight/next?apiKey=YOUR_API_KEY&symbolCode=BTCUSD&timeFrame=H1Response · 200
{
"symbolCode": "BTCUSD",
"timeFrame": "H1",
"calculatedAt": "2025-01-15T10:00:00+00:00",
"price": 94500.00,
"ema21": 93800.12,
"ema50": 92100.65,
"rsi": 57.30,
"atr": 420.12,
"volume": 1240.0,
"avgVolume": 980.0,
"support": 93200.00,
"resistance": 95800.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 market trend using EMA 21/50 alignment and ADX strength. Returns one of five labels from StrongUptrend to StrongDowntrend.
Query parameters
| Name | Type | Description |
|---|---|---|
| apiKeyrequired | string | Your API authentication key. |
| SymbolCoderequired | string | Trading symbol (e.g. BTCUSD, XAUUSD, EURUSD). |
| 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 | Calculation timestamp (UTC). |
| trend | string | StrongUptrend | Uptrend | Sideways | Downtrend | StrongDowntrend. |
| description | string | Human-readable explanation of the trend. |
| adx | decimal | ADX value — ≥25 indicates a trending market, <20 indicates 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=H4Response · 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 the trend, or Range-bound. Returns direction and the nearest support/resistance levels.
Query parameters
| Name | Type | Description |
|---|---|---|
| apiKeyrequired | string | Your API authentication key. |
| SymbolCoderequired | string | Trading symbol (e.g. BTCUSD, XAUUSD, EURUSD). |
| 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 | Calculation timestamp (UTC). |
| 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=M15Response · 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 momentum, EMA alignment, and proximity to key support/resistance into a single Buy/Sell/Neutral signal. Returns a 0–100 confidence score and a list of contributing reasons.
Query parameters
| Name | Type | Description |
|---|---|---|
| apiKeyrequired | string | Your API authentication key. |
| SymbolCoderequired | string | Trading symbol (e.g. BTCUSD, XAUUSD, EURUSD). |
| 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 | Calculation timestamp (UTC). |
| 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 factor descriptions. |
| rsi | decimal | RSI value at calculation time. |
| ema21 | decimal | EMA 21 value. |
| ema50 | decimal | EMA 50 value. |
| price | decimal | Current close price. |
| nearestSupport | decimal | Nearest support level. |
| nearestResistance | decimal | Nearest resistance level. |
Request
GET https://api.realmarketapi.com/api/v1/insight/confluence?apiKey=YOUR_API_KEY&symbolCode=BTCUSD&timeFrame=H1Response · 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 derived from five equally-weighted components: RSI, MACD, EMA alignment, ADX direction, and price range position. Includes a per-component breakdown.
Query parameters
| Name | Type | Description |
|---|---|---|
| apiKeyrequired | string | Your API authentication key. |
| SymbolCoderequired | string | Trading symbol (e.g. BTCUSD, XAUUSD, EURUSD). |
| 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 | Calculation timestamp (UTC). |
| score | int | 0 (extreme bearish) to 100 (extreme bullish). |
| label | string | StrongBullish | Bullish | Neutral | Bearish | StrongBearish. |
| rsi | decimal | RSI value. |
| macdHistogram | decimal | Current MACD histogram value. |
| adx | decimal | ADX value. |
| price | decimal | Current close price. |
| ema21 | decimal | EMA 21 value. |
| ema50 | decimal | EMA 50 value. |
| factors | string[] | Per-component breakdown showing contribution (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=H1Response · 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,
"ema21": 1.09345,
"ema50": 1.08912,
"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"
]
}Multi-Timeframe Trend
Returns the trend direction for every plan-allowed timeframe in a single call. Ideal for building top-down alignment dashboards. Timeframes without sufficient data are silently omitted. No TimeFrame parameter — analysis covers all timeframes automatically.
Query parameters
| Name | Type | Description |
|---|---|---|
| apiKeyrequired | string | Your API authentication key. |
| SymbolCoderequired | string | Trading symbol (e.g. BTCUSD, XAUUSD, EURUSD). |
Response fields
| Field | Type | Description |
|---|---|---|
| symbolCode | string | Symbol identifier. |
| calculatedAt | ISO 8601 | Calculation timestamp (UTC). |
| timeframes | object | Dictionary keyed by timeframe (M5, M15, H1, H4, D1). |
| timeframes[key] | string | StrongBullish | Bullish | Neutral | Bearish | StrongBearish for each timeframe. |
Request
GET https://api.realmarketapi.com/api/v1/multi-timeframe?apiKey=YOUR_API_KEY&symbolCode=BTCUSDResponse · 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. Zones are sorted by proximity to current price. Each zone includes touch count and relative strength rating.
Query parameters
| Name | Type | Description |
|---|---|---|
| apiKeyrequired | string | Your API authentication key. |
| SymbolCoderequired | string | Trading symbol (e.g. BTCUSD, XAUUSD, EURUSD). |
| 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 | Calculation timestamp (UTC). |
| currentPrice | decimal | Current close price. |
| zones | array | 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[].lastTouchedAt | ISO 8601 | Timestamp of the most recent touch. |
| zones[].strength | string | Weak (1 touch) | Moderate (2–3 touches) | Strong (≥4 touches). |
Request
GET https://api.realmarketapi.com/api/v1/liquidity/zones?apiKey=YOUR_API_KEY&symbolCode=XAUUSD&timeFrame=H1Response · 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 directional order flow imbalance over the last 50 candles — bullish vs bearish ratio — and identifies candles with body sizes ≥1.5× the average (imbalance zones). Returns up to 10 recent imbalance zones.
Query parameters
| Name | Type | Description |
|---|---|---|
| apiKeyrequired | string | Your API authentication key. |
| SymbolCoderequired | string | Trading symbol (e.g. BTCUSD, XAUUSD, EURUSD). |
| 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 | Calculation timestamp (UTC). |
| currentImbalance | string | Bullish (>60% bull candles) | Bearish (>60% bear candles) | Neutral. |
| bullishRatio | decimal | Percentage of bullish candles in the last 50. |
| bearishRatio | decimal | Percentage of bearish candles in the last 50. |
| recentImbalanceZones | array | Up to 10 most recent large-body candles. |
| recentImbalanceZones[].openTime | ISO 8601 | Candle open timestamp. |
| recentImbalanceZones[].open | decimal | Candle open price. |
| recentImbalanceZones[].close | decimal | Candle close price. |
| recentImbalanceZones[].direction | string | Bullish | Bearish. |
| recentImbalanceZones[].bodyMultiplier | decimal | Body size relative to average — always ≥1.5. |
| recentImbalanceZones[].volume | decimal | Volume on this candle. |
Request
GET https://api.realmarketapi.com/api/v1/orderflow/imbalance?apiKey=YOUR_API_KEY&symbolCode=BTCUSD&timeFrame=M15Response · 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 support/resistance where retail stop orders cluster (buffer = 0.5×ATR). Flags zones recently swept by a wick that closed back inside the range. Returns up to 5 support + 5 resistance stop clusters.
Query parameters
| Name | Type | Description |
|---|---|---|
| apiKeyrequired | string | Your API authentication key. |
| SymbolCoderequired | string | Trading symbol (e.g. BTCUSD, XAUUSD, EURUSD). |
| 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 | Calculation timestamp (UTC). |
| currentPrice | decimal | Current close price. |
| zones | array | Stop clusters sorted nearest-first. |
| zones[].price | decimal | Stop cluster price level. |
| zones[].type | string | BelowSupport | AboveResistance. |
| zones[].description | string | Human-readable zone description. |
| zones[].recentlyHunted | boolean | true if a candle in the last 10 wicked through and closed back inside the zone. |
| zones[].huntedAt | ISO 8601? | Timestamp of the most recent hunt event, or null if not hunted. |
Request
GET https://api.realmarketapi.com/api/v1/stop-hunt/zones?apiKey=YOUR_API_KEY&symbolCode=EURUSD&timeFrame=H1Response · 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 (candle range >2.5σ above average), UnusualVolume (volume >2.0σ above average), and FakeBreakout (wick through S/R that closes back inside). Returns up to 20 most recent anomalies.
Query parameters
| Name | Type | Description |
|---|---|---|
| apiKeyrequired | string | Your API authentication key. |
| SymbolCoderequired | string | Trading symbol (e.g. BTCUSD, XAUUSD, EURUSD). |
| 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 | Calculation timestamp (UTC). |
| hasAnomalies | boolean | true if at least one anomaly was detected in the last 50 candles. |
| anomalies | array | Array of anomaly events. |
| anomalies[].openTime | ISO 8601 | Candle open timestamp. |
| anomalies[].type | string | PriceSpike | UnusualVolume | FakeBreakout. |
| anomalies[].value | decimal | The measured value that triggered the anomaly detection. |
| anomalies[].threshold | decimal | The statistical threshold that was exceeded. |
| anomalies[].description | string | Human-readable description of the anomaly. |
Request
GET https://api.realmarketapi.com/api/v1/anomaly?apiKey=YOUR_API_KEY&symbolCode=BTCUSD&timeFrame=M15Response · 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 market manipulation probability over the last 20 candles using three factors: wick-to-body ratio, volume divergence (large price move on low volume), and fake breakout frequency. Returns a 0–100 risk score with contributing factors.
Query parameters
| Name | Type | Description |
|---|---|---|
| apiKeyrequired | string | Your API authentication key. |
| SymbolCoderequired | string | Trading symbol (e.g. BTCUSD, XAUUSD, EURUSD). |
| 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 | Calculation timestamp (UTC). |
| riskLevel | string | Low | Medium | High. |
| riskScore | int | 0 (no risk) to 100 (extreme manipulation risk). |
| factors | string[] | List of contributing risk factor descriptions. |
| avgWickToBodyRatio | decimal | Average total-wick ÷ body ratio over the 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=M15Response · 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
}Error codes
Common
ErrorCode values returned by Intelligence endpoints.| Code | HTTP | Description |
|---|---|---|
| ERR_0001_DATA_NOT_FOUND | 400 | No market data available for the requested symbol / timeframe |
| ERR_0005_INVALID_API_KEY | 400 | API key is missing, inactive, or not found |
| ERR_0007_INVALID_TIME_FRAME | 400 | Requested timeframe is not available on your plan |
| ERR_0008_SYMBOL_NOT_SUPPORTED | 400 | Requested symbol is not available on your plan |
| ERR_0012_EMAIL_NOT_VERIFIED | 400 | Account email has not been verified |
| ERR_0014_INVALID_PLAN | 400 | Pro plan or above is required to access this endpoint |
| ERR_0017_REQUEST_QUOTA_EXCEEDED | 429 | Monthly request quota has been reached |
Try it in the Playground
Send real requests and inspect live responses in the browser.