🧠

Docs/Intelligence API

Intelligence API

11 endpoints · Bias scoring · Trend detection · Confluence · Liquidity · Order flow · Anomaly · Manipulation risk · Pro plan and above

Next Forecast Trend Setup Confluence Score Multi-TF Liquidity Order Flow Stop Hunt Anomaly ManipulationBase URL https://api.realmarketapi.com/api/v1

🔑

Pro plan and above

All Intelligence API endpoints require an active Pro plan or higher. Free, Starter, and Plus plans do not have access to these endpoints. Authentication is via the apiKey query parameter. Parameters SymbolCode and TimeFrame use PascalCase.

GET

/api/v1/insight/next

Pro+

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
apiKey*	string	Your API authentication key.
SymbolCode*	string	Trading symbol (e.g. BTCUSD, XAUUSD, EURUSD).
TimeFrame*	string	Candle interval: M1 · M5 · M15 · H1 · H4 · D1.

Response Fields — 200 OK

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 /api/v1/insight/next

GEThttps://api.realmarketapi.com/api/v1/insight/next?apiKey=YOUR_API_KEY&SymbolCode=BTCUSD&TimeFrame=H1

Response — 200 OK

response.json

{
  "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" }
  ]
}

GET

/api/v1/insight/trend

Pro+

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
apiKey*	string	Your API authentication key.
SymbolCode*	string	Trading symbol (e.g. BTCUSD, XAUUSD, EURUSD).
TimeFrame*	string	Candle interval: M1 · M5 · M15 · H1 · H4 · D1.

Response Fields — 200 OK

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 /api/v1/insight/trend

GEThttps://api.realmarketapi.com/api/v1/insight/trend?apiKey=YOUR_API_KEY&SymbolCode=EURUSD&TimeFrame=H4

Response — 200 OK

response.json

{
  "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
}

GET

/api/v1/insight/setup

Pro+

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
apiKey*	string	Your API authentication key.
SymbolCode*	string	Trading symbol (e.g. BTCUSD, XAUUSD, EURUSD).
TimeFrame*	string	Candle interval: M1 · M5 · M15 · H1 · H4 · D1.

Response Fields — 200 OK

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 /api/v1/insight/setup

GEThttps://api.realmarketapi.com/api/v1/insight/setup?apiKey=YOUR_API_KEY&SymbolCode=XAUUSD&TimeFrame=M15

Response — 200 OK

response.json

{
  "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
}

GET

/api/v1/insight/confluence

Pro+

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
apiKey*	string	Your API authentication key.
SymbolCode*	string	Trading symbol (e.g. BTCUSD, XAUUSD, EURUSD).
TimeFrame*	string	Candle interval: M1 · M5 · M15 · H1 · H4 · D1.

Response Fields — 200 OK

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 /api/v1/insight/confluence

GEThttps://api.realmarketapi.com/api/v1/insight/confluence?apiKey=YOUR_API_KEY&SymbolCode=BTCUSD&TimeFrame=H1

Response — 200 OK

response.json

{
  "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
}

GET

/api/v1/insight/score

Pro+

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
apiKey*	string	Your API authentication key.
SymbolCode*	string	Trading symbol (e.g. BTCUSD, XAUUSD, EURUSD).
TimeFrame*	string	Candle interval: M1 · M5 · M15 · H1 · H4 · D1.

Response Fields — 200 OK

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 /api/v1/insight/score

GEThttps://api.realmarketapi.com/api/v1/insight/score?apiKey=YOUR_API_KEY&SymbolCode=EURUSD&TimeFrame=H1

Response — 200 OK

response.json

{
  "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"
  ]
}

GET

/api/v1/multi-timeframe

Pro+

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
apiKey*	string	Your API authentication key.
SymbolCode*	string	Trading symbol (e.g. BTCUSD, XAUUSD, EURUSD).

Response Fields — 200 OK

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 /api/v1/multi-timeframe

GEThttps://api.realmarketapi.com/api/v1/multi-timeframe?apiKey=YOUR_API_KEY&SymbolCode=BTCUSD

Response — 200 OK

response.json

{
  "symbolCode":   "BTCUSD",
  "calculatedAt": "2025-01-15T10:00:00+00:00",
  "timeframes": {
    "M5":  "Bullish",
    "M15": "StrongBullish",
    "H1":  "Neutral",
    "H4":  "Bearish",
    "D1":  "StrongBearish"
  }
}

GET

/api/v1/liquidity/zones

Pro+

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
apiKey*	string	Your API authentication key.
SymbolCode*	string	Trading symbol (e.g. BTCUSD, XAUUSD, EURUSD).
TimeFrame*	string	Candle interval: M1 · M5 · M15 · H1 · H4 · D1.

Response Fields — 200 OK

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 /api/v1/liquidity/zones

GEThttps://api.realmarketapi.com/api/v1/liquidity/zones?apiKey=YOUR_API_KEY&SymbolCode=XAUUSD&TimeFrame=H1

Response — 200 OK

response.json

{
  "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"
    }
  ]
}

GET

/api/v1/orderflow/imbalance

Pro+

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
apiKey*	string	Your API authentication key.
SymbolCode*	string	Trading symbol (e.g. BTCUSD, XAUUSD, EURUSD).
TimeFrame*	string	Candle interval: M1 · M5 · M15 · H1 · H4 · D1.

Response Fields — 200 OK

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 /api/v1/orderflow/imbalance

GEThttps://api.realmarketapi.com/api/v1/orderflow/imbalance?apiKey=YOUR_API_KEY&SymbolCode=BTCUSD&TimeFrame=M15

Response — 200 OK

response.json

{
  "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
    }
  ]
}

GET

/api/v1/stop-hunt/zones

Pro+

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
apiKey*	string	Your API authentication key.
SymbolCode*	string	Trading symbol (e.g. BTCUSD, XAUUSD, EURUSD).
TimeFrame*	string	Candle interval: M1 · M5 · M15 · H1 · H4 · D1.

Response Fields — 200 OK

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 /api/v1/stop-hunt/zones

GEThttps://api.realmarketapi.com/api/v1/stop-hunt/zones?apiKey=YOUR_API_KEY&SymbolCode=EURUSD&TimeFrame=H1

Response — 200 OK

response.json

{
  "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
    }
  ]
}

GET

/api/v1/anomaly

Pro+

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
apiKey*	string	Your API authentication key.
SymbolCode*	string	Trading symbol (e.g. BTCUSD, XAUUSD, EURUSD).
TimeFrame*	string	Candle interval: M1 · M5 · M15 · H1 · H4 · D1.

Response Fields — 200 OK

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 /api/v1/anomaly

GEThttps://api.realmarketapi.com/api/v1/anomaly?apiKey=YOUR_API_KEY&SymbolCode=BTCUSD&TimeFrame=M15

Response — 200 OK

response.json

{
  "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"
    }
  ]
}

GET

/api/v1/manipulation-risk

Pro+

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
apiKey*	string	Your API authentication key.
SymbolCode*	string	Trading symbol (e.g. BTCUSD, XAUUSD, EURUSD).
TimeFrame*	string	Candle interval: M1 · M5 · M15 · H1 · H4 · D1.

Response Fields — 200 OK

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 /api/v1/manipulation-risk

GEThttps://api.realmarketapi.com/api/v1/manipulation-risk?apiKey=YOUR_API_KEY&SymbolCode=XAUUSD&TimeFrame=M15

Response — 200 OK

response.json

{
  "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 Error Codes

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