Market data
Prices, bars, order books, trades, funding, open interest and positioning, from the shared market-data service.
get_tick
Latest bid/ask/last (and mark/index for perps) with spread in bps. Available on every tier.
Capability: read · read-only · REST: POST /v1/tools/get_tick
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
symbol | string | yes | — | |
exchange | binance | bybit | okx | no | — |
Example request:
{
"symbol": "BTC/USDT:USDT"
}get_bars
OHLCV bars, up to 5000, order:"chronological" (oldest first). volume is in base units; quote_volume when the exchange provides it; partial_last_bar tells whether the last bar is still forming. Available on every tier.
Capability: read · read-only · REST: POST /v1/tools/get_bars
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
symbol | string | yes | — | |
timeframe | M1 | M5 | M15 | M30 | H1 | H4 | D1 | W1 | yes | — | |
count | integer | yes | — | |
end_time | integer | no | — | |
exchange | binance | bybit | okx | no | — |
Example request:
{
"symbol": "BTC/USDT:USDT",
"timeframe": "M1",
"count": 1
}get_symbols
Tradable USDT markets (spot and USDT-M perps) with 24h quote volume, order:"quote_volume_desc". Available on every tier.
Capability: read · read-only · REST: POST /v1/tools/get_symbols
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
market_type | spot | swap | no | — | |
min_quote_volume_24h | number | no | — | |
search | string | no | — | |
limit | integer | no | — |
Example request:
{}get_symbol_info
Market specification: tick_size, amount_step, contract_size, min_notional_usdt, max_leverage, fees, leverage tiers. Available on every tier.
Capability: read · read-only · REST: POST /v1/tools/get_symbol_info
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
symbol | string | yes | — |
Example request:
{
"symbol": "BTC/USDT:USDT"
}get_market_depth
Real L2 order book (levels<=50, best first; amounts in base units) with imbalance within 50 bps. Available on every tier.
Capability: read · read-only · REST: POST /v1/tools/get_market_depth
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
symbol | string | yes | — | |
levels | integer | no | 20 |
Example request:
{
"symbol": "BTC/USDT:USDT"
}get_recent_trades
Recent public trades with real aggressor side, order:"chronological", plus buy/sell volume and delta. Requires the analytics capability (Pro and above).
Capability: analytics · read-only · REST: POST /v1/tools/get_recent_trades
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
symbol | string | yes | — | |
count | integer | no | 200 | |
since | integer | no | — |
Example request:
{
"symbol": "BTC/USDT:USDT"
}get_order_flow
Footprint (volume-at-price, delta, POC, imbalances) per bar from recent public trades; bars older than the trade window report coverage:"insufficient". Requires the analytics capability (Pro and above).
Capability: analytics · read-only · REST: POST /v1/tools/get_order_flow
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
symbol | string | yes | — | |
timeframe | M1 | M5 | M15 | M30 | H1 | H4 | D1 | W1 | yes | — | |
bars | integer | no | 20 | |
level_size | number | no | — |
Example request:
{
"symbol": "BTC/USDT:USDT",
"timeframe": "M1"
}get_funding
Perp funding: current & predicted rate, next funding time, interval, annualized %, 30-day z-score, optional history (chronological) and cross-exchange comparison. Available on every tier.
Capability: read · read-only · REST: POST /v1/tools/get_funding
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
symbol | string | yes | — | |
history_count | integer | no | 0 | |
compare_exchanges | boolean | no | — |
Example request:
{
"symbol": "BTC/USDT:USDT"
}get_open_interest
Open interest (contracts and USDT), 1h/4h/24h change and the price-vs-OI quadrant (e.g. price_up_oi_up). Requires the analytics capability (Pro and above).
Capability: analytics · read-only · REST: POST /v1/tools/get_open_interest
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
symbol | string | yes | — | |
period | 5m | 15m | 30m | 1h | 4h | 1d | no | "1h" | |
limit | integer | no | 48 |
Example request:
{
"symbol": "BTC/USDT:USDT"
}get_positioning
Long/short account ratio history (raw numbers, no contrarian signal is derived). Requires the analytics capability (Pro and above).
Capability: analytics · read-only · REST: POST /v1/tools/get_positioning
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
symbol | string | yes | — | |
period | 5m | 15m | 30m | 1h | 4h | 1d | no | "1h" | |
limit | integer | no | 48 |
Example request:
{
"symbol": "BTC/USDT:USDT"
}get_liquidations
Liquidations from our own collector: per-side counts and USDT notional over a window and the largest events. coverage:"sampled" on Binance (lower bounds). Requires the analytics capability (Pro and above).
Capability: analytics · read-only · REST: POST /v1/tools/get_liquidations
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
symbol | string | no | — | |
window_minutes | integer | no | 60 | |
top | integer | no | 5 |
Example request:
{}get_basis
Perp mark vs spot premium %, funding-based annualization and optional hourly history. Requires the analytics capability (Pro and above).
Capability: analytics · read-only · REST: POST /v1/tools/get_basis
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
symbol | string | yes | — | |
history | integer | no | 0 |
Example request:
{
"symbol": "BTC/USDT:USDT"
}get_fear_greed
Crypto Fear & Greed index (alternative.me) with history; the attribution field must be shown when quoting it. Available on every tier.
Capability: read · read-only · REST: POST /v1/tools/get_fear_greed
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
limit | integer | no | 1 |
Example request:
{}