Référence interactive de l’API
Chaque route de l’API, générée depuis son contrat OpenAPI : les paramètres avec leur valeur par défaut et leur plafond, chaque champ de la réponse avec son type et son unité, et une réponse réelle capturée en production. Rien sur cette page n’est écrit à la main : elle ne peut donc pas diverger de l’API.
Le même contrat, pour vos outils : openapi.json (OpenAPI 3.1, pour les générateurs de SDK et Swagger UI), une collection Postman, et llms-full.txt, toute la référence dans un seul fichier texte pour les agents IA.
#System
Health, per-feed freshness, the list of served symbols and what each symbol supports. /v1/health is the only route that needs no key.
GET /v1/capabilities
What a symbol supports. Which raw feeds were active over the last 24 h for symbol (required), and which derived metrics are available, blocked (with the missing feeds) or not applicable (stablecoins have no futures). Feed names are those of /v1/status.
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
symbol obligatoire | string | — | Trading pair, e.g. BTCUSDT. Required. The served pairs: GET /v1/symbols. Case-insensitive (btcusdt works; the envelope gives the canonical BTCUSDT). An unknown pair returns 422 invalid_symbol with the accepted list. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=asset_class. Unknown field: 422 unknown_field with a suggestion. |
25 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
asset_class | string | crypto or stablecoin (spot only, no futures metrics). | |
feeds_active_last_24h | object | Per source feed, under its /v1/status name (trades_spot, trades_kline_futures_seconds, oi, funding_rate, klines_1m...): whether it received data for this symbol in the last 24 h. | |
feeds_active_last_24h.klines_futures_1m | boolean | true when the klines_futures_1m feed delivered data in the last 24 hours; null when its probe did not conclude in time. | |
feeds_active_last_24h.trades_spot | boolean | true when the trades_spot feed delivered data in the last 24 hours; null when its probe did not conclude in time. | |
feeds_active_last_24h.trades_futures | boolean | true when the trades_futures feed delivered data in the last 24 hours; null when its probe did not conclude in time. | |
feeds_active_last_24h.oi | boolean | base asset quantity (BTC for BTCUSDT) | true when the oi feed delivered data in the last 24 hours; null when its probe did not conclude in time. |
feeds_active_last_24h.funding_rate | boolean | true when the funding_rate feed delivered data in the last 24 hours; null when its probe did not conclude in time. | |
feeds_active_last_24h.liquidations_events | boolean | true when the liquidations_events feed delivered data in the last 24 hours; null when its probe did not conclude in time. | |
feeds_active_last_24h.trades_kline_futures_seconds | boolean | true when the trades_kline_futures_seconds feed delivered data in the last 24 hours; null when its probe did not conclude in time. | |
feeds_active_last_24h.klines_futures_multi | boolean | true when the klines_futures_multi feed delivered data in the last 24 hours; null when its probe did not conclude in time. | |
feeds_active_last_24h.klines_1m | boolean | true when the klines_1m feed delivered data in the last 24 hours; null when its probe did not conclude in time. | |
feeds_active_last_24h.klines_multi | boolean | true when the klines_multi feed delivered data in the last 24 hours; null when its probe did not conclude in time. | |
feeds_active_last_24h.orderbook_1m | boolean | true when the orderbook_1m feed delivered data in the last 24 hours; null when its probe did not conclude in time. | |
computed_metrics_available | string[] | Derived metrics available for the symbol. | |
computed_metrics_blocked | object | Derived metrics unavailable, with the missing feeds. | |
feeds_not_applicable | string[] | Feeds that do not exist for this symbol (the futures feeds of a spot-only stablecoin), under their /v1/status names. | |
stablecoin_note | string | Spot-only stablecoin: why its futures feeds and derived metrics do not apply. Absent for any other symbol. | |
computed_metrics_not_applicable | object | Derived metrics that do not apply (stablecoins have no futures). | |
computed_metrics_not_applicable.basis | string | Why basis does not apply to this symbol. | |
computed_metrics_not_applicable.oi_change | string | base asset quantity (BTC for BTCUSDT) | Why oi_change does not apply to this symbol. |
computed_metrics_not_applicable.liquidations_cumulative | string | Why liquidations_cumulative does not apply to this symbol. | |
computed_metrics_not_applicable.liquidations_big_small_ratio | string | Why liquidations_big_small_ratio does not apply to this symbol. | |
computed_metrics_not_applicable.funding_cumulative | string | Why funding_cumulative does not apply to this symbol. | |
computed_metrics_not_applicable.indicators | string | Why indicators does not apply to this symbol. | |
computed_metrics_not_applicable.trades_kline_futures | string | Why trades_kline_futures does not apply to this symbol. |
Essayer
GET https://api.bytnode.com/v1/capabilities?symbol=BTCUSDT
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/capabilities?symbol=BTCUSDT"{
"status": "ok",
"server_time": "2026-11-08T12:51:16.337Z",
"data_type": "capabilities",
"symbol": "BTCUSDT",
"data": {
"asset_class": "crypto",
"feeds_active_last_24h": {
"klines_futures_1m": true,
"trades_spot": true,
"trades_futures": true,
"oi": true,
"funding_rate": true,
"liquidations_events": true,
"trades_kline_futures_seconds": true,
"klines_futures_multi": true,
"klines_1m": true,
"klines_multi": true,
"orderbook_1m": true
},
"computed_metrics_available": [
"basis",
"buy_sell_ratio",
"cvd"
],
"computed_metrics_blocked": {}
}
}GET /v1/healthsans clé
Service health. Liveness of the API and its database (data.database). No key needed, counted for nobody.
1 champ de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
database | string | connected when the service reaches its database. A failing check answers 503 service_unavailable with database in error.details. |
Essayer
GET https://api.bytnode.com/v1/health
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl "https://api.bytnode.com/v1/health"{
"status": "ok",
"server_time": "2026-11-08T12:51:13.156Z",
"data_type": "health",
"data": {
"database": "connected"
}
}GET /v1/limits
Your plan's limits. What your key may do, read from the plan that served THIS request: plan, the data families it includes (null = all), the history window per timeframe (window_s, in seconds, null = unlimited), the window of individual trades (trades_window_s), the number of individual liquidations (liquidations_events_count), and the per-minute rate and monthly quota with what is left (remaining_count). 0 = not in your plan, null = no limit. Use it to size limit and since_ms before paging instead of discovering the window through a 403 history_depth. Free: not counted in your quota. With an unmetered key, every limit is null.
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=plan,families. Unknown field: 422 unknown_field with a suggestion. |
18 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
plan | string | Your plan: free, traders, financial, startup or enterprise (legacy for an internal unmetered key: every limit below is then unset). | |
families | string[] | null | Data families your plan includes (price_volume, derivatives, microstructure, trades, snapshot, indicators, macro, options, onchain, etf, tokenomics, sentiment); null = all of them. A route outside them answers 403 plan_family. | |
history | object[] | History window per timeframe, one object per timeframe the API serves. | |
history[].timeframe | string | The timeframe the window applies to. | |
history[].window_s | integer | null | seconds | How far back this timeframe may be read, in seconds, measured from now; null = unlimited. Beyond it: 403 history_depth. |
trades_window_s | integer | null | seconds | How far back individual trades (/v1/trades/spot, /futures, /large) may be read, in seconds; 0 = not in your plan (family trades), null = unlimited. |
liquidations_events_count | integer | null | count | How many of the most recent individual liquidations /v1/liquidations/events may return, counted from the latest: 100 (Free), 500 (Traders), 1,000 (Financial), 10,000 (Startup); a larger limit answers 403 history_depth. null = no count set (Enterprise, or an unmetered key): up to 10,000 per call, the route's maximum. 0 = not in your plan (family derivatives). |
rate | object | null | The per-minute rate, as a token bucket; null = unlimited or unmetered key. The same values as the RateLimit headers (rate policy). | |
rate.requests_per_minute | integer | null | count | Requests per minute of your plan (the bucket refills at this pace). |
rate.burst_count | integer | count | Capacity of the bucket: requests you can send at once. |
rate.refill_s | integer | seconds | Seconds to refill the bucket from empty. |
rate.remaining_count | integer | null | count | Requests left right now (after this one). |
rate.reset_s | integer | null | seconds | Seconds until fully restored. |
quota | object | null | The monthly quota; null = unlimited or unmetered key. The same values as the RateLimit headers (quota policy). It resets on the 1st of the month, 00:00 UTC. | |
quota.monthly_count | integer | count | Requests included per calendar month. |
quota.month_length_s | integer | seconds | Length of the current calendar month, in seconds. |
quota.remaining_count | integer | null | count | Requests left right now (after this one). |
quota.reset_s | integer | null | seconds | Seconds until fully restored. |
Essayer
GET https://api.bytnode.com/v1/limits
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/limits"{
"status": "ok",
"server_time": "2026-11-08T12:51:15.222Z",
"data_type": "limits",
"data": {
"plan": "traders",
"families": [
"derivatives",
"indicators",
"macro",
"microstructure",
"options",
"price_volume",
"snapshot"
],
"history": [
{
"timeframe": "1m",
"window_s": 86400
},
{
"timeframe": "5m",
"window_s": 259200
},
{
"timeframe": "15m",
"window_s": 259200
},
{
"timeframe": "30m",
"window_s": 604800
},
{
"timeframe": "1h",
"window_s": 604800
},
{
"timeframe": "4h",
"window_s": 2592000
},
{
"timeframe": "1d",
"window_s": null
},
{
"timeframe": "1w",
"window_s": null
}
],
"trades_window_s": 0,
"liquidations_events_count": 500,
"rate": {
"requests_per_minute": 60,
"burst_count": 20,
"refill_s": 20,
"remaining_count": 19,
"reset_s": 1
},
"quota": {
"monthly_count": 200000,
"month_length_s": 2678400,
"remaining_count": 187342,
"reset_s": 1641600
}
}
}GET /v1/status
Freshness of every feed. One row per public feed, for EVERY data family (market, derivatives, options, on-chain, macro, ETF, tokenomics, sentiment): its name, its family, the public routes it supplies, its age and staleness threshold (1.5 × the feed's expected interval; a monthly macro series or a quarterly ETF filing legitimately has an age of weeks). data.state = ok, or degraded when a feed is stale or could not be checked (the envelope's status is ok whenever the request succeeded). Use it to tell 'no event' from 'feed down'. Counted as one request of the price & volume family.
15 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
computed_at | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | When the status was measured: the OLDEST of its measurements (each data family is measured on its own, cached up to 5 minutes for market feeds and 30 seconds for the others). Every age_s is measured at or after this instant, not at server_time. |
state | string | ok, or degraded when at least one feed is stale or failed its check. The envelope's status stays ok (the request succeeded). | |
feed_count | integer | count | Public feeds checked. |
stale_feed_count | integer | count | Feeds older than their threshold. |
error_feed_count | integer | count | Feeds that could not be checked. |
max_age_s | number | seconds | Age of the oldest feed. |
feeds | object[] | One row per public feed. | |
feeds[].feed | string | Public feed name. The closed list of this contract version; routes gives the routes each one supplies. | |
feeds[].family | string | Data family the feed belongs to, as in /v1/limits and the x-family of each route: price_volume, derivatives, microstructure, trades, options, onchain, macro, etf, tokenomics or sentiment. | |
feeds[].routes | string[] | The public routes (contract paths) this feed supplies: watch this feed to know whether they are fresh. A per-timeframe feed (cvd_1h) supplies them at that timeframe. | |
feeds[].age_s | number | null | seconds | Age of the latest row of the feed. For a feed made of several series (one per asset, per macro series, per ETF), the age of its OLDEST series. For the market-hours intraday series (macro_intraday_<tf>, not _continuous), counted on weekdays only, like their threshold. null if the feed is empty or could not be checked. |
feeds[].expected_interval_s | integer | seconds | Maximum legitimate age of the feed. |
feeds[].threshold_s | integer | seconds | Age above which the feed is stale (1.5 × expected_interval_s). |
feeds[].is_stale | boolean | null | Whether the feed is stale: older than threshold_s, or (series feed) at least one of its series is. null when the feed could not be checked (counted in error_feed_count). | |
feeds[].stale_venue_count | integer | null | count | Venues lagging on this feed; null when the feed is not split by venue (every non-market feed). |
Essayer
GET https://api.bytnode.com/v1/status
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/status"{
"status": "ok",
"server_time": "2026-11-08T12:51:14.698Z",
"data_type": "status",
"data": {
"computed_at": "2026-11-08T12:51:13.669Z",
"state": "ok",
"feed_count": 82,
"stale_feed_count": 0,
"error_feed_count": 0,
"max_age_s": 7649473.7,
"feeds": [
{
"feed": "klines_futures_1m",
"family": "price_volume",
"routes": [
"/v1/klines",
"/v1/klines/history"
],
"age_s": 73.7,
"expected_interval_s": 120,
"threshold_s": 180,
"is_stale": false,
"stale_venue_count": 0
},
{
"feed": "klines_1m",
"family": "price_volume",
"routes": [
"/v1/klines",
"/v1/klines/history"
],
"age_s": 73.7,
"expected_interval_s": 180,
"threshold_s": 270,
"is_stale": false,
"stale_venue_count": 0
},
{
"feed": "klines_multi",
"family": "price_volume",
"routes": [
"/v1/klines",
"/v1/klines/history"
],
"age_s": 373.7,
"expected_interval_s": 660,
"threshold_s": 990,
"is_stale": false,
"stale_venue_count": null
}
]
}
}GET /v1/symbols
List the served trading pairs. The served pairs: USDT-margined perpetual markets (the largest crypto assets by market capitalisation that the venues list as perpetuals) plus two spot-only stablecoin pairs (USDCUSDT, USDTUSDC). The response is the full list, with the name and base asset of each pair; GET /v1/capabilities says what each one supports.
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=symbol,base_asset. Unknown field: 422 unknown_field with a suggestion. |
5 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
[].symbol | string | Trading pair, e.g. BTCUSDT. | |
[].base_asset | string | Base asset of the pair. | |
[].name | string | Human-readable name. | |
[].quote_asset | string | Quote currency of the pair (USDT for BTCUSDT, USDC for USDTUSDC): the currency of its prices. | |
[].markets | string[] | Markets served for the pair: spot and futures (USDT-margined perpetual), or spot only for the two stablecoin pairs (their /futures routes answer unavailable: not_applicable). |
Essayer
GET https://api.bytnode.com/v1/symbols
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/symbols"{
"status": "ok",
"server_time": "2026-11-08T12:51:15.750Z",
"data_type": "symbols",
"data": [
{
"symbol": "AAVEUSDT",
"base_asset": "AAVE",
"name": "Aave",
"quote_asset": "USDT",
"markets": [
"spot",
"futures"
]
},
{
"symbol": "ADAUSDT",
"base_asset": "ADA",
"name": "Cardano",
"quote_asset": "USDT",
"markets": [
"spot",
"futures"
]
},
{
"symbol": "AEROUSDT",
"base_asset": "AERO",
"name": "Aerodrome Finance",
"quote_asset": "USDT",
"markets": [
"spot",
"futures"
]
}
]
}POST /v1/ws/token
Issue a short-lived WebSocket token. For a BROWSER (or any client you do not trust with your API key): your server calls this route with its key in the X-API-KEY header and hands the browser only the token, which opens the stream at wss://ws.bytnode.com/ws?token=…. The key never reaches the page, and nothing long-lived ends up in a URL (browser history, proxy logs). A token lasts 60 seconds and opens ONE connection: once used, or expired, it is refused (401 invalid_api_key, with a message saying so); request a new one for each connection or reconnection. It opens the WebSocket only, never a REST route. Same right as the stream itself: a plan without the WebSocket gets 403 plan_websocket. Not counted in your monthly quota (your per-minute rate applies). The rights are those of your key at the moment of the handshake: a key revoked in between no longer connects. Server-side code can keep sending the key in the X-API-KEY header of the handshake (or ?api_key=); the token is the form meant for web pages.
4 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
token | string | null | The WebSocket token (wst_…): pass it as ?token= when opening wss://ws.bytnode.com/ws (or wss://api.bytnode.com/ws). It opens ONE connection, within expires_in_s seconds; a reconnection needs a new token. | |
expires_at | date-time | null | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Instant after which the token no longer opens a connection. |
expires_in_s | integer | null | seconds | Lifetime of the token from its issue, in seconds (60). |
url | string | null | The stream URL with the token already in it, ready to open. |
Essayer
POST https://api.bytnode.com/v1/ws/token
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -X POST -H "X-API-KEY: $BYTNODE_API_KEY" https://api.bytnode.com/v1/ws/token{
"status": "ok",
"server_time": "2026-10-16T10:00:00.012Z",
"data_type": "ws_token",
"data": {
"token": "wst_MS5rMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMC4xNzkyMTQ0ODYwLjkwMDEzMjlhMGFjNTQ4MjRiZTQ4NDA0NQ.3Cmy-5glJ5KYvWTXz280DOGtq7YlerflhGS1UyVBp5w",
"expires_at": "2026-10-16T10:01:00.000Z",
"expires_in_s": 60,
"url": "wss://ws.bytnode.com/ws?token=wst_MS5rMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMC4xNzkyMTQ0ODYwLjkwMDEzMjlhMGFjNTQ4MjRiZTQ4NDA0NQ.3Cmy-5glJ5KYvWTXz280DOGtq7YlerflhGS1UyVBp5w"
}
}#Snapshot
One request, up to 51 fields for one symbol: the fastest way to fill a dashboard or give an AI agent full market context. Each field is name=depth (funding_rate=1, or true for depth 1); multi-timeframe fields are name@tf=depth (klines@1h=24, cvd@1h=24). Call it with only symbol to list the fields your plan includes.
GET /v1/snapshot
Many fields for one symbol in one request. 51 fields for one symbol in a single call (40 plain, 11 multi-timeframe): prices, flow, derivatives, liquidations, macro, on-chain, options. Each query key is a field and its value a depth: funding_rate=1 (or =true). Multi-timeframe fields take @tf: klines@1h=24, cvd@1h=24; klines also takes 1w. Every field has the name of its route, and ONE type whatever the depth: a field WITHOUT a timeframe is the response of its latest-value route, an object (depth 1, or true; 422 depth_too_large above, naming its /history route) — except the event series trades_spot, trades_futures, trades_kline_futures_seconds and liquidations_events, always a list of their latest N rows; a field WITH @tf is ALWAYS a list, the latest N rows of its /history at that timeframe (cvd@1h=1 is a list of one row). max_depth gives each ceiling. The timeframe is case-insensitive like everywhere (cvd@1H), except 1M. A market field serves all markets (the route without /spot or /futures). Call it with only symbol to get, under data, available_fields (fields without a timeframe), available_multi_tf_fields, multi_tf_syntax, timeframes, timeframes_by_field and max_depth. An empty field carries unavailable (not_applicable, no_api_key or no_data) so 'no measure' is never mistaken for 'nothing happened'. Response: symbol, data (an object keyed by field name) and is_partial (true if a field failed: that field is then an error object with code and message, with the codes of the error catalogue).
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
symbol obligatoire | string | — | Trading pair, e.g. BTCUSDT. Required. The served pairs: GET /v1/symbols. Case-insensitive (btcusdt works; the envelope gives the canonical BTCUSDT). An unknown pair returns 422 invalid_symbol with the accepted list. Alone, it returns the catalogue of the fields your plan includes. |
altcoin_season | integer · 1–1 | — | Altcoin Season Index. Same content as /v1/altcoin-season. Value: true (or 1): the latest value only. |
basis | integer · 1–1 | — | Futures-spot basis (latest value). Same content as /v1/basis. Value: true (or 1): the latest value only. |
btc_active_addresses | integer · 1–1 | — | Bitcoin active addresses. Same content as /v1/btc/active-addresses. Value: true (or 1): the latest value only. |
btc_fees | integer · 1–1 | — | Recommended Bitcoin fees. Same content as /v1/btc/fees. Value: true (or 1): the latest value only. |
btc_mempool | integer · 1–1 | — | Bitcoin mempool. Same content as /v1/btc/mempool. Value: true (or 1): the latest value only. |
btc_mining | integer · 1–1 | — | Mining pool concentration. Same content as /v1/btc/mining. Value: true (or 1): the latest value only. |
btc_mvrv | integer · 1–1 | — | Bitcoin MVRV. Same content as /v1/btc/mvrv. Value: true (or 1): the latest value only. |
btc_network | integer · 1–1 | — | Bitcoin network state. Same content as /v1/btc/network. Value: true (or 1): the latest value only. |
btc_nvt | integer · 1–1 | — | Bitcoin NVT. Same content as /v1/btc/nvt. Value: true (or 1): the latest value only. |
btc_revenue_per_difficulty | integer · 1–1 | — | Bitcoin revenue per difficulty. Same content as /v1/btc/revenue-per-difficulty. Value: true (or 1): the latest value only. |
cmc100 | integer · 1–1 | — | CoinMarketCap 100 Index and its constituents. Same content as /v1/indices/cmc100. Value: true (or 1): the latest value only. |
cmc20 | integer · 1–1 | — | CoinMarketCap 20 Index and its constituents. Same content as /v1/indices/cmc20. Value: true (or 1): the latest value only. |
eth_defi | integer · 1–1 | — | Ethereum DeFi. Same content as /v1/eth/defi. Value: true (or 1): the latest value only. |
eth_deflation | integer · 1–1 | — | ETH deflation. Same content as /v1/eth/deflation. Value: true (or 1): the latest value only. |
eth_gas | integer · 1–1 | — | Ethereum gas. Same content as /v1/eth/gas. Value: true (or 1): the latest value only. |
eth_gas_momentum | integer · 1–1 | — | Gas momentum. Same content as /v1/eth/gas-momentum. Value: true (or 1): the latest value only. |
eth_price_btc | integer · 1–1 | — | ETH price in BTC. Same content as /v1/eth/price-btc. Value: true (or 1): the latest value only. |
eth_squeeze | integer · 1–1 | — | ETH supply squeeze index. Same content as /v1/eth/squeeze. Value: true (or 1): the latest value only. |
eth_staking | integer · 1–1 | — | ETH staking. Same content as /v1/eth/staking. Value: true (or 1): the latest value only. |
eth_supply | integer · 1–1 | — | ETH supply and burn. Same content as /v1/eth/supply. Value: true (or 1): the latest value only. |
fear_greed | integer · 1–1 | — | Crypto Fear & Greed Index. Same content as /v1/fear-greed. Value: true (or 1): the latest value only. |
fear_greed_cmc | integer · 1–1 | — | CMC Crypto Fear & Greed Index. Same content as /v1/fear-greed/cmc. Value: true (or 1): the latest value only. |
funding_cumulative | integer · 1–1 | — | Funding summed over 24 h. Same content as /v1/funding/cumulative. Value: true (or 1): the latest value only. |
funding_next | integer · 1–1 | — | Next funding forecast. Same content as /v1/funding/next. Value: true (or 1): the latest value only. |
funding_rate | integer · 1–1 | — | Latest settled funding window. Same content as /v1/funding/rate. Value: true (or 1): the latest value only. |
global | integer · 1–1 | — | Total crypto market cap and dominance. Same content as /v1/global. Value: true (or 1): the latest value only. |
liquidations_cumulative | integer · 1–1 | — | Liquidations long/short USD over the last 5 minutes (latest value). Same content as /v1/liquidations/cumulative. Value: true (or 1): the latest value only. |
liquidations_events | integer · 1–10000 | — | Individual liquidations (N latest events, at most your plan's count). Same content as /v1/liquidations/events. Value: depth N (at most 10000), or true for 1. |
macro_correlations | integer · 1–1 | — | BTC correlation with DXY, S&P 500, gold, VIX. Same content as /v1/macro/correlations. Value: true (or 1): the latest value only. |
macro_momentum | integer · 1–1 | — | Macro momentum score. Same content as /v1/macro/momentum. Value: true (or 1): the latest value only. |
macro_net_liquidity | integer · 1–1 | — | US net liquidity. Same content as /v1/macro/net-liquidity. Value: true (or 1): the latest value only. |
macro_risk | integer · 1–1 | — | Risk-on / risk-off score. Same content as /v1/macro/risk. Value: true (or 1): the latest value only. |
macro_series | integer · 1–1 | — | Latest value of every FRED series. Same content as /v1/macro/series. Value: true (or 1): the latest value only. |
oi_change | integer · 1–1 | — | Open interest change (latest value). Same content as /v1/oi/change. Value: true (or 1): the latest value only. |
options_summary | integer · 1–1 | — | Options market summary for the symbol's asset. Same content as /v1/options/summary. Value: true (or 1): the latest value only. |
price_change | integer · 1–1 | — | Price change over 1m to 1w, in percent. Same content as /v1/price-change. Value: true (or 1): the latest value only. |
tokenomics | integer · 1–1 | — | Supply, market cap, FDV. Same content as /v1/tokenomics. Value: true (or 1): the latest value only. |
trades_futures | integer · 1–10000 | — | Individual futures trades (N trades), bounded by your plan's tick window. Same content as /v1/trades/futures. Value: depth N (at most 10000), or true for 1. |
trades_kline_futures_seconds | integer · 1–1000 | — | Futures trades aggregated per second (N seconds). Same content as /v1/trades-kline/futures/seconds. Value: depth N (at most 1000), or true for 1. |
trades_spot | integer · 1–10000 | — | Individual spot trades (N trades), bounded by your plan's tick window. Same content as /v1/trades/spot. Value: depth N (at most 10000), or true for 1. |
Plus 78 champs multi-unités de temps, nommés champ@tf (cvd@1h, trades_kline@5m…).
124 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
altcoin_season | object | any | null | Altcoin Season Index. Same content as /v1/altcoin-season. Value: true (or 1): the latest value only. | |
basis | object | any | null | Futures-spot basis (latest value). Same content as /v1/basis. Value: true (or 1): the latest value only. | |
btc_active_addresses | object | any | null | Bitcoin active addresses. Same content as /v1/btc/active-addresses. Value: true (or 1): the latest value only. | |
btc_fees | object | any | null | Recommended Bitcoin fees. Same content as /v1/btc/fees. Value: true (or 1): the latest value only. | |
btc_mempool | object | any | null | Bitcoin mempool. Same content as /v1/btc/mempool. Value: true (or 1): the latest value only. | |
btc_mining | object | any | null | Mining pool concentration. Same content as /v1/btc/mining. Value: true (or 1): the latest value only. | |
btc_mvrv | object | any | null | Bitcoin MVRV. Same content as /v1/btc/mvrv. Value: true (or 1): the latest value only. | |
btc_network | object | any | null | Bitcoin network state. Same content as /v1/btc/network. Value: true (or 1): the latest value only. | |
btc_nvt | object | any | null | Bitcoin NVT. Same content as /v1/btc/nvt. Value: true (or 1): the latest value only. | |
btc_revenue_per_difficulty | object | any | null | Bitcoin revenue per difficulty. Same content as /v1/btc/revenue-per-difficulty. Value: true (or 1): the latest value only. | |
cmc100 | object | any | null | CoinMarketCap 100 Index and its constituents. Same content as /v1/indices/cmc100. Value: true (or 1): the latest value only. | |
cmc20 | object | any | null | CoinMarketCap 20 Index and its constituents. Same content as /v1/indices/cmc20. Value: true (or 1): the latest value only. | |
eth_defi | object | any | null | Ethereum DeFi. Same content as /v1/eth/defi. Value: true (or 1): the latest value only. | |
eth_deflation | object | any | null | ETH deflation. Same content as /v1/eth/deflation. Value: true (or 1): the latest value only. | |
eth_gas | object | any | null | Ethereum gas. Same content as /v1/eth/gas. Value: true (or 1): the latest value only. | |
eth_gas_momentum | object | any | null | Gas momentum. Same content as /v1/eth/gas-momentum. Value: true (or 1): the latest value only. | |
eth_price_btc | object | any | null | ETH price in BTC. Same content as /v1/eth/price-btc. Value: true (or 1): the latest value only. | |
eth_squeeze | object | any | null | ETH supply squeeze index. Same content as /v1/eth/squeeze. Value: true (or 1): the latest value only. | |
eth_staking | object | any | null | ETH staking. Same content as /v1/eth/staking. Value: true (or 1): the latest value only. | |
eth_supply | object | any | null | ETH supply and burn. Same content as /v1/eth/supply. Value: true (or 1): the latest value only. | |
fear_greed | object | any | null | Crypto Fear & Greed Index. Same content as /v1/fear-greed. Value: true (or 1): the latest value only. | |
fear_greed_cmc | object | any | null | CMC Crypto Fear & Greed Index. Same content as /v1/fear-greed/cmc. Value: true (or 1): the latest value only. | |
funding_cumulative | object | any | null | Funding summed over 24 h. Same content as /v1/funding/cumulative. Value: true (or 1): the latest value only. | |
funding_next | object | any | null | Next funding forecast. Same content as /v1/funding/next. Value: true (or 1): the latest value only. | |
funding_rate | object | any | null | Latest settled funding window. Same content as /v1/funding/rate. Value: true (or 1): the latest value only. | |
global | object | any | null | Total crypto market cap and dominance. Same content as /v1/global. Value: true (or 1): the latest value only. | |
liquidations_cumulative | object | any | null | Liquidations long/short USD over the last 5 minutes (latest value). Same content as /v1/liquidations/cumulative. Value: true (or 1): the latest value only. | |
liquidations_events | object[] | object | any | null | Individual liquidations (N latest events, at most your plan's count). Same content as /v1/liquidations/events. Value: depth N (at most 10000), or true for 1. | |
macro_correlations | object | any | null | BTC correlation with DXY, S&P 500, gold, VIX. Same content as /v1/macro/correlations. Value: true (or 1): the latest value only. | |
macro_momentum | object | any | null | Macro momentum score. Same content as /v1/macro/momentum. Value: true (or 1): the latest value only. | |
macro_net_liquidity | object | any | null | US net liquidity. Same content as /v1/macro/net-liquidity. Value: true (or 1): the latest value only. | |
macro_risk | object | any | null | Risk-on / risk-off score. Same content as /v1/macro/risk. Value: true (or 1): the latest value only. | |
macro_series | object | any | null | Latest value of every FRED series. Same content as /v1/macro/series. Value: true (or 1): the latest value only. | |
oi_change | object | any | null | Open interest change (latest value). Same content as /v1/oi/change. Value: true (or 1): the latest value only. | |
options_summary | object | any | null | Options market summary for the symbol's asset. Same content as /v1/options/summary. Value: true (or 1): the latest value only. | |
price_change | object | any | null | Price change over 1m to 1w, in percent. Same content as /v1/price-change. Value: true (or 1): the latest value only. | |
tokenomics | object | any | null | Supply, market cap, FDV. Same content as /v1/tokenomics. Value: true (or 1): the latest value only. | |
trades_futures | object[] | object | any | null | Individual futures trades (N trades), bounded by your plan's tick window. Same content as /v1/trades/futures. Value: depth N (at most 10000), or true for 1. | |
trades_kline_futures_seconds | object[] | object | any | null | Futures trades aggregated per second (N seconds). Same content as /v1/trades-kline/futures/seconds. Value: depth N (at most 1000), or true for 1. | |
trades_spot | object[] | object | any | null | Individual spot trades (N trades), bounded by your plan's tick window. Same content as /v1/trades/spot. Value: depth N (at most 10000), or true for 1. | |
buy_sell_ratio@1m | object[] | object | Buy/sell volume ratio per bucket (buy_sell_ratio@<tf>=N: the N latest closed buckets). Timeframe 1m. Same content as /v1/buy-sell-ratio/history?timeframe=1m. | |
buy_sell_ratio@5m | object[] | object | Buy/sell volume ratio per bucket (buy_sell_ratio@<tf>=N: the N latest closed buckets). Timeframe 5m. Same content as /v1/buy-sell-ratio/history?timeframe=5m. | |
buy_sell_ratio@15m | object[] | object | Buy/sell volume ratio per bucket (buy_sell_ratio@<tf>=N: the N latest closed buckets). Timeframe 15m. Same content as /v1/buy-sell-ratio/history?timeframe=15m. | |
buy_sell_ratio@30m | object[] | object | Buy/sell volume ratio per bucket (buy_sell_ratio@<tf>=N: the N latest closed buckets). Timeframe 30m. Same content as /v1/buy-sell-ratio/history?timeframe=30m. | |
buy_sell_ratio@1h | object[] | object | Buy/sell volume ratio per bucket (buy_sell_ratio@<tf>=N: the N latest closed buckets). Timeframe 1h. Same content as /v1/buy-sell-ratio/history?timeframe=1h. | |
buy_sell_ratio@4h | object[] | object | Buy/sell volume ratio per bucket (buy_sell_ratio@<tf>=N: the N latest closed buckets). Timeframe 4h. Same content as /v1/buy-sell-ratio/history?timeframe=4h. | |
buy_sell_ratio@1d | object[] | object | Buy/sell volume ratio per bucket (buy_sell_ratio@<tf>=N: the N latest closed buckets). Timeframe 1d. Same content as /v1/buy-sell-ratio/history?timeframe=1d. | |
cvd@1m | object[] | object | CVD per bucket (cvd@<tf>=N: the N latest closed buckets). Timeframe 1m. Same content as /v1/cvd/history?timeframe=1m. | |
cvd@5m | object[] | object | CVD per bucket (cvd@<tf>=N: the N latest closed buckets). Timeframe 5m. Same content as /v1/cvd/history?timeframe=5m. | |
cvd@15m | object[] | object | CVD per bucket (cvd@<tf>=N: the N latest closed buckets). Timeframe 15m. Same content as /v1/cvd/history?timeframe=15m. | |
cvd@30m | object[] | object | CVD per bucket (cvd@<tf>=N: the N latest closed buckets). Timeframe 30m. Same content as /v1/cvd/history?timeframe=30m. | |
cvd@1h | object[] | object | CVD per bucket (cvd@<tf>=N: the N latest closed buckets). Timeframe 1h. Same content as /v1/cvd/history?timeframe=1h. | |
cvd@4h | object[] | object | CVD per bucket (cvd@<tf>=N: the N latest closed buckets). Timeframe 4h. Same content as /v1/cvd/history?timeframe=4h. | |
cvd@1d | object[] | object | CVD per bucket (cvd@<tf>=N: the N latest closed buckets). Timeframe 1d. Same content as /v1/cvd/history?timeframe=1d. | |
klines@1m | object[] | object | OHLCV candles (klines@<tf>=N: the N latest closed candles). Timeframe 1m. Same content as /v1/klines/history?timeframe=1m. | |
klines@5m | object[] | object | OHLCV candles (klines@<tf>=N: the N latest closed candles). Timeframe 5m. Same content as /v1/klines/history?timeframe=5m. | |
klines@15m | object[] | object | OHLCV candles (klines@<tf>=N: the N latest closed candles). Timeframe 15m. Same content as /v1/klines/history?timeframe=15m. | |
klines@30m | object[] | object | OHLCV candles (klines@<tf>=N: the N latest closed candles). Timeframe 30m. Same content as /v1/klines/history?timeframe=30m. | |
klines@1h | object[] | object | OHLCV candles (klines@<tf>=N: the N latest closed candles). Timeframe 1h. Same content as /v1/klines/history?timeframe=1h. | |
klines@4h | object[] | object | OHLCV candles (klines@<tf>=N: the N latest closed candles). Timeframe 4h. Same content as /v1/klines/history?timeframe=4h. | |
klines@1d | object[] | object | OHLCV candles (klines@<tf>=N: the N latest closed candles). Timeframe 1d. Same content as /v1/klines/history?timeframe=1d. | |
klines@1w | object[] | object | OHLCV candles (klines@<tf>=N: the N latest closed candles). Timeframe 1w. Same content as /v1/klines/history?timeframe=1w. | |
liquidations_big_small_ratio@1m | object[] | object | Big vs small liquidations per bucket (liquidations_big_small_ratio@<tf>=N: the N latest closed buckets with liquidations). Timeframe 1m. Same content as /v1/liquidations/big-small-ratio/history?timeframe=1m. | |
liquidations_big_small_ratio@5m | object[] | object | Big vs small liquidations per bucket (liquidations_big_small_ratio@<tf>=N: the N latest closed buckets with liquidations). Timeframe 5m. Same content as /v1/liquidations/big-small-ratio/history?timeframe=5m. | |
liquidations_big_small_ratio@15m | object[] | object | Big vs small liquidations per bucket (liquidations_big_small_ratio@<tf>=N: the N latest closed buckets with liquidations). Timeframe 15m. Same content as /v1/liquidations/big-small-ratio/history?timeframe=15m. | |
liquidations_big_small_ratio@30m | object[] | object | Big vs small liquidations per bucket (liquidations_big_small_ratio@<tf>=N: the N latest closed buckets with liquidations). Timeframe 30m. Same content as /v1/liquidations/big-small-ratio/history?timeframe=30m. | |
liquidations_big_small_ratio@1h | object[] | object | Big vs small liquidations per bucket (liquidations_big_small_ratio@<tf>=N: the N latest closed buckets with liquidations). Timeframe 1h. Same content as /v1/liquidations/big-small-ratio/history?timeframe=1h. | |
liquidations_big_small_ratio@4h | object[] | object | Big vs small liquidations per bucket (liquidations_big_small_ratio@<tf>=N: the N latest closed buckets with liquidations). Timeframe 4h. Same content as /v1/liquidations/big-small-ratio/history?timeframe=4h. | |
liquidations_big_small_ratio@1d | object[] | object | Big vs small liquidations per bucket (liquidations_big_small_ratio@<tf>=N: the N latest closed buckets with liquidations). Timeframe 1d. Same content as /v1/liquidations/big-small-ratio/history?timeframe=1d. | |
oi@1m | object[] | object | Total open interest per closed bucket (oi@<tf>=N: the N latest buckets). Timeframe 1m. Same content as /v1/oi/history?timeframe=1m. | |
oi@5m | object[] | object | Total open interest per closed bucket (oi@<tf>=N: the N latest buckets). Timeframe 5m. Same content as /v1/oi/history?timeframe=5m. | |
oi@15m | object[] | object | Total open interest per closed bucket (oi@<tf>=N: the N latest buckets). Timeframe 15m. Same content as /v1/oi/history?timeframe=15m. | |
oi@30m | object[] | object | Total open interest per closed bucket (oi@<tf>=N: the N latest buckets). Timeframe 30m. Same content as /v1/oi/history?timeframe=30m. | |
oi@1h | object[] | object | Total open interest per closed bucket (oi@<tf>=N: the N latest buckets). Timeframe 1h. Same content as /v1/oi/history?timeframe=1h. | |
oi@4h | object[] | object | Total open interest per closed bucket (oi@<tf>=N: the N latest buckets). Timeframe 4h. Same content as /v1/oi/history?timeframe=4h. | |
oi@1d | object[] | object | Total open interest per closed bucket (oi@<tf>=N: the N latest buckets). Timeframe 1d. Same content as /v1/oi/history?timeframe=1d. | |
orderbook@1m | object[] | object | Order book depth by price range per closed bucket (book at the end of the bucket), spot + futures (orderbook@1m=1 = a list with the latest closed minute). Timeframe 1m. Same content as /v1/orderbook?timeframe=1m. | |
orderbook@5m | object[] | object | Order book depth by price range per closed bucket (book at the end of the bucket), spot + futures (orderbook@1m=1 = a list with the latest closed minute). Timeframe 5m. Same content as /v1/orderbook?timeframe=5m. | |
orderbook@15m | object[] | object | Order book depth by price range per closed bucket (book at the end of the bucket), spot + futures (orderbook@1m=1 = a list with the latest closed minute). Timeframe 15m. Same content as /v1/orderbook?timeframe=15m. | |
orderbook@30m | object[] | object | Order book depth by price range per closed bucket (book at the end of the bucket), spot + futures (orderbook@1m=1 = a list with the latest closed minute). Timeframe 30m. Same content as /v1/orderbook?timeframe=30m. | |
orderbook@1h | object[] | object | Order book depth by price range per closed bucket (book at the end of the bucket), spot + futures (orderbook@1m=1 = a list with the latest closed minute). Timeframe 1h. Same content as /v1/orderbook?timeframe=1h. | |
orderbook@4h | object[] | object | Order book depth by price range per closed bucket (book at the end of the bucket), spot + futures (orderbook@1m=1 = a list with the latest closed minute). Timeframe 4h. Same content as /v1/orderbook?timeframe=4h. | |
orderbook@1d | object[] | object | Order book depth by price range per closed bucket (book at the end of the bucket), spot + futures (orderbook@1m=1 = a list with the latest closed minute). Timeframe 1d. Same content as /v1/orderbook?timeframe=1d. | |
spread_interexchange@1m | object[] | object | Inter-venue spread per bucket. Timeframe 1m. Same content as /v1/spread/interexchange?timeframe=1m. | |
spread_interexchange@5m | object[] | object | Inter-venue spread per bucket. Timeframe 5m. Same content as /v1/spread/interexchange?timeframe=5m. | |
spread_interexchange@15m | object[] | object | Inter-venue spread per bucket. Timeframe 15m. Same content as /v1/spread/interexchange?timeframe=15m. | |
spread_interexchange@30m | object[] | object | Inter-venue spread per bucket. Timeframe 30m. Same content as /v1/spread/interexchange?timeframe=30m. | |
spread_interexchange@1h | object[] | object | Inter-venue spread per bucket. Timeframe 1h. Same content as /v1/spread/interexchange?timeframe=1h. | |
spread_interexchange@4h | object[] | object | Inter-venue spread per bucket. Timeframe 4h. Same content as /v1/spread/interexchange?timeframe=4h. | |
spread_interexchange@1d | object[] | object | Inter-venue spread per bucket. Timeframe 1d. Same content as /v1/spread/interexchange?timeframe=1d. | |
trades_avg_size@1m | object[] | object | Average trade size per bucket (trades_avg_size@<tf>=N: the N latest closed buckets). Timeframe 1m. Same content as /v1/trades/avg-size/history?timeframe=1m. | |
trades_avg_size@5m | object[] | object | Average trade size per bucket (trades_avg_size@<tf>=N: the N latest closed buckets). Timeframe 5m. Same content as /v1/trades/avg-size/history?timeframe=5m. | |
trades_avg_size@15m | object[] | object | Average trade size per bucket (trades_avg_size@<tf>=N: the N latest closed buckets). Timeframe 15m. Same content as /v1/trades/avg-size/history?timeframe=15m. | |
trades_avg_size@30m | object[] | object | Average trade size per bucket (trades_avg_size@<tf>=N: the N latest closed buckets). Timeframe 30m. Same content as /v1/trades/avg-size/history?timeframe=30m. | |
trades_avg_size@1h | object[] | object | Average trade size per bucket (trades_avg_size@<tf>=N: the N latest closed buckets). Timeframe 1h. Same content as /v1/trades/avg-size/history?timeframe=1h. | |
trades_avg_size@4h | object[] | object | Average trade size per bucket (trades_avg_size@<tf>=N: the N latest closed buckets). Timeframe 4h. Same content as /v1/trades/avg-size/history?timeframe=4h. | |
trades_avg_size@1d | object[] | object | Average trade size per bucket (trades_avg_size@<tf>=N: the N latest closed buckets). Timeframe 1d. Same content as /v1/trades/avg-size/history?timeframe=1d. | |
trades_kline@1m | object[] | object | Trade candles, spot + futures (N latest closed buckets). Timeframe 1m. Same content as /v1/trades-kline?timeframe=1m. | |
trades_kline@5m | object[] | object | Trade candles, spot + futures (N latest closed buckets). Timeframe 5m. Same content as /v1/trades-kline?timeframe=5m. | |
trades_kline@15m | object[] | object | Trade candles, spot + futures (N latest closed buckets). Timeframe 15m. Same content as /v1/trades-kline?timeframe=15m. | |
trades_kline@30m | object[] | object | Trade candles, spot + futures (N latest closed buckets). Timeframe 30m. Same content as /v1/trades-kline?timeframe=30m. | |
trades_kline@1h | object[] | object | Trade candles, spot + futures (N latest closed buckets). Timeframe 1h. Same content as /v1/trades-kline?timeframe=1h. | |
trades_kline@4h | object[] | object | Trade candles, spot + futures (N latest closed buckets). Timeframe 4h. Same content as /v1/trades-kline?timeframe=4h. | |
trades_kline@1d | object[] | object | Trade candles, spot + futures (N latest closed buckets). Timeframe 1d. Same content as /v1/trades-kline?timeframe=1d. | |
trades_kline_futures@1m | object[] | object | Trade candles, futures only. Timeframe 1m. Same content as /v1/trades-kline/futures?timeframe=1m. | |
trades_kline_futures@5m | object[] | object | Trade candles, futures only. Timeframe 5m. Same content as /v1/trades-kline/futures?timeframe=5m. | |
trades_kline_futures@15m | object[] | object | Trade candles, futures only. Timeframe 15m. Same content as /v1/trades-kline/futures?timeframe=15m. | |
trades_kline_futures@30m | object[] | object | Trade candles, futures only. Timeframe 30m. Same content as /v1/trades-kline/futures?timeframe=30m. | |
trades_kline_futures@1h | object[] | object | Trade candles, futures only. Timeframe 1h. Same content as /v1/trades-kline/futures?timeframe=1h. | |
trades_kline_futures@4h | object[] | object | Trade candles, futures only. Timeframe 4h. Same content as /v1/trades-kline/futures?timeframe=4h. | |
trades_kline_futures@1d | object[] | object | Trade candles, futures only. Timeframe 1d. Same content as /v1/trades-kline/futures?timeframe=1d. | |
trades_kline_spot@1m | object[] | object | Trade candles, spot only. Timeframe 1m. Same content as /v1/trades-kline/spot?timeframe=1m. | |
trades_kline_spot@5m | object[] | object | Trade candles, spot only. Timeframe 5m. Same content as /v1/trades-kline/spot?timeframe=5m. | |
trades_kline_spot@15m | object[] | object | Trade candles, spot only. Timeframe 15m. Same content as /v1/trades-kline/spot?timeframe=15m. | |
trades_kline_spot@30m | object[] | object | Trade candles, spot only. Timeframe 30m. Same content as /v1/trades-kline/spot?timeframe=30m. | |
trades_kline_spot@1h | object[] | object | Trade candles, spot only. Timeframe 1h. Same content as /v1/trades-kline/spot?timeframe=1h. | |
trades_kline_spot@4h | object[] | object | Trade candles, spot only. Timeframe 4h. Same content as /v1/trades-kline/spot?timeframe=4h. | |
trades_kline_spot@1d | object[] | object | Trade candles, spot only. Timeframe 1d. Same content as /v1/trades-kline/spot?timeframe=1d. | |
available_fields | string[] | Catalogue (?symbol= alone): the single-value fields your plan includes. | |
available_multi_tf_fields | string[] | Catalogue: the fields requested per timeframe, as <field>@<tf>=<depth>. | |
multi_tf_syntax | string | Catalogue: how to request a multi-timeframe field. | |
timeframes | string[] | Catalogue: the timeframes a multi-timeframe field accepts by default. | |
timeframes_by_field | object | Catalogue: the fields whose timeframes differ from timeframes. | |
max_depth | object | Catalogue: the largest depth each field accepts (a larger one: 422 depth_too_large). |
Essayer
GET https://api.bytnode.com/v1/snapshot?symbol=BTCUSDT&basis=1&fear_greed=1&funding_rate=1&cvd@1h=2
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/snapshot?symbol=BTCUSDT&funding_rate=1&basis=1&fear_greed=1&cvd@1h=2"{
"status": "ok",
"server_time": "2026-11-08T12:51:18.109Z",
"data_type": "snapshot",
"symbol": "BTCUSDT",
"is_partial": false,
"data": {
"funding_rate": {
"time": "2026-11-08T00:00:00.000Z",
"period_end_at": "2026-11-08T08:00:00.000Z",
"settled_at": "2026-11-08T08:00:00.009Z",
"rate_pct": 0.00825097837214,
"apr_pct": 9.0348213175,
"is_closed": true
},
"basis": {
"time": "2026-11-08T12:50:33.003Z",
"basis_value": -34.2194290442,
"basis_pct": -0.0450600508554,
"futures_price": 75907.0553189,
"spot_price": 75941.2747479
},
"fear_greed": {
"time": "2026-11-08T00:00:00.000Z",
"value": 28,
"label": "fear"
},
"cvd@1h": [
{
"time": "2026-11-08T11:00:00.000Z",
"cvd_series": [
76.67484796,
120.35567509,
116.00015045
],
"net_volume": 339.27976095,
"buy_volume": 2160.77349106,
"sell_volume": 1821.49373011,
"sample_count": 60,
"buy_sell_coverage_ratio": 1,
"is_volume_estimated": false,
"is_closed": true
},
{
"time": "2026-11-08T10:00:00.000Z",
"cvd_series": [
1.04801064,
15.45497456,
-3.88956999
],
"net_volume": -65.56413162,
"buy_volume": 1508.80409631,
"sell_volume": 1574.36822793,
"sample_count": 60,
"buy_sell_coverage_ratio": 1,
"is_volume_estimated": false,
"is_closed": true
}
]
}
}#Market: prices & volumes
OHLCV candles, individual trades, price change and the aggregated order book. OHLC comes from one reference spot market per symbol; a candle's volume covers spot and perpetual futures, volume_spot and volume_futures one market each.
GET /v1/klines
Latest OHLCV candle. The latest CLOSED candle of timeframe (required: 1m to 1w): the first row of /v1/klines/history, an object, served as soon as its volumes are final (about 5 seconds after a 1m candle ends). OHLC from one reference SPOT market per symbol; volume, buy_volume and sell_volume cover ALL markets. Add ?live=1 for the candle IN PROGRESS (is_closed: false): its OHLC comes from the same reference market, its volumes are provisional and grow until it closes; with nothing traded yet in the period, the latest closed candle is returned.
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
timeframe obligatoire | string | — | Candle size, required: 1m, 5m, 15m, 30m, 1h, 4h, 1d or 1w (weekly candles start on Monday 00:00 UTC). Missing: 422 missing_parameter; other values: 422 invalid_timeframe with the accepted list. |
live | boolean | false | 1 or true to return the CURRENT, still-open period computed on the fly (is_closed: false). Default: the last closed period only. |
symbol obligatoire | string | — | Trading pair, e.g. BTCUSDT. Required. The served pairs: GET /v1/symbols. Case-insensitive (btcusdt works; the envelope gives the canonical BTCUSDT). An unknown pair returns 422 invalid_symbol with the accepted list. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,open. Unknown field: 422 unknown_field with a suggestion. |
18 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Start of the latest CLOSED candle of timeframe (the first row of /v1/klines/history); with ?live=1, of the candle in progress. |
open | number | quote currency (USDT for BTCUSDT) | Opening price of the candle. |
high | number | quote currency (USDT for BTCUSDT) | Highest price of the candle. |
low | number | quote currency (USDT for BTCUSDT) | Lowest price of the candle. |
close | number | quote currency (USDT for BTCUSDT) | Closing price of the candle (last price for the open candle). |
volume | number | null | base asset quantity (BTC for BTCUSDT) | Traded volume over the row, base asset units (BTC for BTCUSDT, NOT dollars), aggregated across venues, over the market(s) the route covers: spot + perpetual futures on /v1/klines and /v1/trades-kline, the path's market alone on a /spot or /futures route (a name without a market suffix covers every market of its route; volume_spot / volume_futures restrict). null when a market is not available (never a partial sum). |
buy_volume | number | null | base asset quantity (BTC for BTCUSDT) | Aggressive (taker) buy volume, base asset units, aggregated across venues. |
sell_volume | number | null | base asset quantity (BTC for BTCUSDT) | Aggressive (taker) sell volume, base asset units, aggregated across venues. |
is_volume_estimated | boolean | null | true when some base-asset quantities of this row were ESTIMATED from USD amounts (history where a source reported amounts but not quantities): a buy or sell amount is converted at that source's own average price when its total quantity is known, otherwise at the candle's typical price (high + low + close) / 3. Every quantity a source measured is kept as is. false = all measured. null when the volume itself is null (not available). | |
volume_spot | number | null | base asset quantity (BTC for BTCUSDT) | Volume traded on the SPOT market, summed across venues, base asset units. null while not available yet (never a partial sum). |
buy_volume_spot | number | null | base asset quantity (BTC for BTCUSDT) | Aggressive (taker) buy volume on the SPOT market, across venues. |
sell_volume_spot | number | null | base asset quantity (BTC for BTCUSDT) | Aggressive (taker) sell volume on the SPOT market, across venues. |
is_volume_spot_estimated | boolean | null | true when the spot quantities of this candle were ESTIMATED from USD amounts and the candle's typical price (high + low + close) / 3 (data written before quantities were recorded; mean error 0.04 % in 1m, 0.37 % in 1d); false = measured. null when the volume itself is null (not available). | |
volume_futures | number | null | base asset quantity (BTC for BTCUSDT) | Volume traded on PERPETUAL FUTURES, summed across venues, in base asset units. null when not available yet (never a partial sum). |
buy_volume_futures | number | null | base asset quantity (BTC for BTCUSDT) | Aggressive (taker) buy volume on PERPETUAL FUTURES, across venues. |
sell_volume_futures | number | null | base asset quantity (BTC for BTCUSDT) | Aggressive (taker) sell volume on PERPETUAL FUTURES, across venues. |
is_volume_futures_estimated | boolean | null | true when volume_futures was ESTIMATED from USD amounts and the candle's typical price; false = measured. null when the volume itself is null (not available). | |
is_closed | boolean | true = the row is final; false = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with ?live=1 on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades. |
Essayer
GET https://api.bytnode.com/v1/klines?timeframe=1h&symbol=BTCUSDT
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/klines?symbol=BTCUSDT&timeframe=1h"{
"status": "ok",
"server_time": "2026-11-08T12:51:18.718Z",
"data_type": "klines",
"symbol": "BTCUSDT",
"timeframe": "1h",
"data": {
"time": "2026-11-08T11:00:00.000Z",
"open": 75894.45,
"high": 76037.07,
"low": 75894.44,
"close": 75981.09,
"volume": 3982.26722117,
"buy_volume": 2160.77349106,
"sell_volume": 1821.49373011,
"is_volume_estimated": false,
"volume_spot": 524.78053117,
"buy_volume_spot": 329.14685106,
"sell_volume_spot": 195.63368011,
"is_volume_spot_estimated": false,
"volume_futures": 3457.48669,
"buy_volume_futures": 1831.62664,
"sell_volume_futures": 1625.86005,
"is_volume_futures_estimated": false,
"is_closed": true
}
}GET /v1/klines/history
OHLCV candles. Candles of timeframe (required: 1m to 1w) that have ENDED: the candle in progress is never served. OHLC from one reference SPOT market per symbol. volume, buy_volume and sell_volume cover ALL markets (spot + perpetual futures, summed across venues); volume_spot / volume_futures and their buy/sell split cover one market. is_closed says whether the candle's VOLUMES are final: false for a few seconds after its end (about 5 s for a 1m candle; they can still be null or change), then true (rare exception: trades a venue delivers late are added afterwards, see is_closed). To sync incrementally, resume FROM the oldest row still is_closed: false (read it again), not after it. Candles older than the trade history (BTCUSDT: before 2023-10-01, daily and weekly candles reach back to 2017) have null volumes. Most recent first, or oldest first with order=asc. Follow next to read the following page (it never repeats a row).
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
timeframe obligatoire | string | — | Candle size, required: 1m, 5m, 15m, 30m, 1h, 4h, 1d or 1w (weekly candles start on Monday 00:00 UTC). Missing: 422 missing_parameter; other values: 422 invalid_timeframe with the accepted list. |
since_ms | integer | — | Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range. |
until_ms | integer | — | Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next. |
limit | integer · 1–1000 | 100 | Number of rows to return, in the reading order (most recent first by default). Bounded by your plan's history window: an explicit limit (or since_ms) reaching beyond it returns 403 history_depth; without them the page simply stops at the window. |
symbol obligatoire | string | — | Trading pair, e.g. BTCUSDT. Required. The served pairs: GET /v1/symbols. Case-insensitive (btcusdt works; the envelope gives the canonical BTCUSDT). An unknown pair returns 422 invalid_symbol with the accepted list. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,open. Unknown field: 422 unknown_field with a suggestion. |
before_ms | integer | — | Upper time bound, EXCLUSIVE, in epoch milliseconds: rows strictly before it. Pass the oldest time you received to read the previous page without repeating a row. Not combinable with until_ms (422 invalid_time_range). |
order | string | desc | Reading order: desc (most recent first, the default) or asc (oldest first, reading forward from since_ms, which is then required). Follow next to read the following page. |
18 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
[].time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Start of the bucket the row covers: a 1h bucket at 14:00 covers 14:00:00 to 14:59:59.999. |
[].open | number | quote currency (USDT for BTCUSDT) | Opening price of the candle. |
[].high | number | quote currency (USDT for BTCUSDT) | Highest price of the candle. |
[].low | number | quote currency (USDT for BTCUSDT) | Lowest price of the candle. |
[].close | number | quote currency (USDT for BTCUSDT) | Closing price of the candle (last price for the open candle). |
[].volume | number | null | base asset quantity (BTC for BTCUSDT) | Traded volume over the row, base asset units (BTC for BTCUSDT, NOT dollars), aggregated across venues, over the market(s) the route covers: spot + perpetual futures on /v1/klines and /v1/trades-kline, the path's market alone on a /spot or /futures route (a name without a market suffix covers every market of its route; volume_spot / volume_futures restrict). null when a market is not available (never a partial sum). |
[].buy_volume | number | null | base asset quantity (BTC for BTCUSDT) | Aggressive (taker) buy volume, base asset units, aggregated across venues. |
[].sell_volume | number | null | base asset quantity (BTC for BTCUSDT) | Aggressive (taker) sell volume, base asset units, aggregated across venues. |
[].is_volume_estimated | boolean | null | true when some base-asset quantities of this row were ESTIMATED from USD amounts (history where a source reported amounts but not quantities): a buy or sell amount is converted at that source's own average price when its total quantity is known, otherwise at the candle's typical price (high + low + close) / 3. Every quantity a source measured is kept as is. false = all measured. null when the volume itself is null (not available). | |
[].volume_spot | number | null | base asset quantity (BTC for BTCUSDT) | Volume traded on the SPOT market, summed across venues, base asset units. null while not available yet (never a partial sum). |
[].buy_volume_spot | number | null | base asset quantity (BTC for BTCUSDT) | Aggressive (taker) buy volume on the SPOT market, across venues. |
[].sell_volume_spot | number | null | base asset quantity (BTC for BTCUSDT) | Aggressive (taker) sell volume on the SPOT market, across venues. |
[].is_volume_spot_estimated | boolean | null | true when the spot quantities of this candle were ESTIMATED from USD amounts and the candle's typical price (high + low + close) / 3 (data written before quantities were recorded; mean error 0.04 % in 1m, 0.37 % in 1d); false = measured. null when the volume itself is null (not available). | |
[].volume_futures | number | null | base asset quantity (BTC for BTCUSDT) | Volume traded on PERPETUAL FUTURES, summed across venues, in base asset units. null when not available yet (never a partial sum). |
[].buy_volume_futures | number | null | base asset quantity (BTC for BTCUSDT) | Aggressive (taker) buy volume on PERPETUAL FUTURES, across venues. |
[].sell_volume_futures | number | null | base asset quantity (BTC for BTCUSDT) | Aggressive (taker) sell volume on PERPETUAL FUTURES, across venues. |
[].is_volume_futures_estimated | boolean | null | true when volume_futures was ESTIMATED from USD amounts and the candle's typical price; false = measured. null when the volume itself is null (not available). | |
[].is_closed | boolean | true = the row is final; false = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with ?live=1 on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades. |
Essayer
GET https://api.bytnode.com/v1/klines/history?timeframe=1h&limit=3&symbol=BTCUSDT
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/klines/history?symbol=BTCUSDT&limit=3&timeframe=1h"{
"status": "ok",
"server_time": "2026-11-08T12:51:19.351Z",
"data_type": "klines_history",
"symbol": "BTCUSDT",
"timeframe": "1h",
"step": "1h",
"data": [
{
"time": "2026-11-08T11:00:00.000Z",
"open": 75894.45,
"high": 76037.07,
"low": 75894.44,
"close": 75981.09,
"volume": 3982.26722117,
"buy_volume": 2160.77349106,
"sell_volume": 1821.49373011,
"is_volume_estimated": false,
"volume_spot": 524.78053117,
"buy_volume_spot": 329.14685106,
"sell_volume_spot": 195.63368011,
"is_volume_spot_estimated": false,
"volume_futures": 3457.48669,
"buy_volume_futures": 1831.62664,
"sell_volume_futures": 1625.86005,
"is_volume_futures_estimated": false,
"is_closed": true
},
{
"time": "2026-11-08T10:00:00.000Z",
"open": 75933.45,
"high": 75933.46,
"low": 75803.75,
"close": 75894.45,
"volume": 3083.17232424,
"buy_volume": 1508.80409631,
"sell_volume": 1574.36822793,
"is_volume_estimated": false,
"volume_spot": 637.41856424,
"buy_volume_spot": 330.91496631,
"sell_volume_spot": 306.50359793,
"is_volume_spot_estimated": false,
"volume_futures": 2445.75376,
"buy_volume_futures": 1177.88913,
"sell_volume_futures": 1267.86463,
"is_volume_futures_estimated": false,
"is_closed": true
},
{
"time": "2026-11-08T09:00:00.000Z",
"open": 75942.25,
"high": 75969.17,
"low": 75878.24,
"close": 75933.46,
"volume": 3207.97793559,
"buy_volume": 1422.09755438,
"sell_volume": 1785.88038121,
"is_volume_estimated": false,
"volume_spot": 770.06978559,
"buy_volume_spot": 357.46647438,
"sell_volume_spot": 412.60331121,
"is_volume_spot_estimated": false,
"volume_futures": 2437.90815,
"buy_volume_futures": 1064.63108,
"sell_volume_futures": 1373.27707,
"is_volume_futures_estimated": false,
"is_closed": true
}
],
"next": "/v1/klines/history?symbol=BTCUSDT&limit=3&timeframe=1h&before_ms=1794128400000&order=desc"
}GET /v1/price-change
Price change over 1m to 1w. Rolling price change in percent over eight windows, from the LATEST PRICE: the last trade of the symbol's reference spot market, i.e. the close of /v1/klines?live=1 (time is the instant of that trade). Each window compares it with the one-minute close at or before that instant minus the window. Spot-based for stablecoins.
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
symbol obligatoire | string | — | Trading pair, e.g. BTCUSDT. Required. The served pairs: GET /v1/symbols. Case-insensitive (btcusdt works; the envelope gives the canonical BTCUSDT). An unknown pair returns 422 invalid_symbol with the accepted list. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,price. Unknown field: 422 unknown_field with a suggestion. |
11 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Instant of the latest trade of the reference spot market (price is that trade's price, the close of /v1/klines?live=1); if it has not traded since the latest closed one-minute candle, the end of that candle (price = its close). Exception: USDTUSDC, which no spot candle source lists, gives the instant of its latest trade, price being the volume-weighted price of its last 90 seconds. |
price | number | quote currency (USDT for BTCUSDT) | Price. |
changes_pct | object | Price change over each window, keyed by window (1m … 1w), in percent. | |
changes_pct.1m | number | percent | Price change over the last 1m, in percent. |
changes_pct.5m | number | percent | Price change over the last 5m, in percent. |
changes_pct.15m | number | percent | Price change over the last 15m, in percent. |
changes_pct.30m | number | percent | Price change over the last 30m, in percent. |
changes_pct.1h | number | percent | Price change over the last 1h, in percent. |
changes_pct.4h | number | null | percent | Price change over the last 4h, in percent. |
changes_pct.1d | number | null | percent | Price change over the last 1d, in percent. |
changes_pct.1w | number | null | percent | Price change over the last 1w, in percent. |
Essayer
GET https://api.bytnode.com/v1/price-change?symbol=BTCUSDT
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/price-change?symbol=BTCUSDT"{
"status": "ok",
"server_time": "2026-11-08T12:51:23.929Z",
"data_type": "price_change",
"symbol": "BTCUSDT",
"data": {
"time": "2026-11-08T12:51:20.728Z",
"price": 75946.6,
"changes_pct": {
"1m": 0.00596507311428,
"5m": 0.00877008857263,
"15m": -0.0652795711786,
"30m": -0.00447662936141,
"1h": -0.0585200339987,
"4h": 0.0235879217724,
"1d": 0.0908040175177,
"1w": -2.49510720498
}
}
}GET /v1/trades/futures
Individual futures trades. Perpetual futures executions ("trades") across venues, one row per trade, most recent first — the same trades, with the same id, as the WebSocket channel trades.futures. Kept 72 hours; your plan sets how far back you can read. Without range parameters: the last limit trades. To read a time range, give since_ms, until_ms and/or order (asc or desc): a page holds at most limit trades and covers at most 15 minutes, and next is the URL of the following page — call it as is — or null once the range is read. Following next returns every trade of the range exactly once, in order. Each trade has a stable id, the same as on the WebSocket.
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
limit | integer · 1–10000 | 100 | Number of rows to return, in the reading order (most recent first by default). Bounded by your plan's history window: an explicit limit (or since_ms) reaching beyond it returns 403 history_depth; without them the page simply stops at the window. |
since_ms | integer | — | Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range. |
until_ms | integer | — | Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next. |
before_ms | integer | — | Upper time bound, EXCLUSIVE, in epoch milliseconds: rows strictly before it. Pass the oldest time you received to read the previous page without repeating a row. Not combinable with until_ms (422 invalid_time_range). |
after_id | string | — | Resume right after this trade: the id of the last trade received, with its time as since_ms (order=asc) or until_ms (order=desc). Simplest: call the next URL of the previous response. Unknown or expired id: 422 invalid_parameter. |
order | string | — | Range reading: desc (most recent first, the default) or asc. Giving order, since_ms or until_ms switches the route to range reading. Either way, a full page carries next (the following page, older trades without range parameters) and the last page next: null. |
symbol obligatoire | string | — | Trading pair, e.g. BTCUSDT. Required. The served pairs: GET /v1/symbols. Case-insensitive (btcusdt works; the envelope gives the canonical BTCUSDT). An unknown pair returns 422 invalid_symbol with the accepted list. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,id. Unknown field: 422 unknown_field with a suggestion. |
6 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
[].time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Execution instant of the trade, as stated by the venue (milliseconds). |
[].id | string | Opaque, stable identifier of the trade (16 hex characters): the same trade always has the same id, so it can be used to deduplicate or resume. It reveals nothing about the venue. | |
[].side | string | Trades: buy or sell (aggressor side). Liquidations: long or short (the position liquidated). | |
[].price | number | quote currency (USDT for BTCUSDT) | Price. |
[].quantity | number | base asset quantity (BTC for BTCUSDT) | Quantity traded or liquidated, in base asset units. |
[].value_usd | number | USD | Notional value: price × quantity, in the pair's quote currency (USDT for BTCUSDT), taken as USD. |
Essayer
GET https://api.bytnode.com/v1/trades/futures?limit=3&symbol=BTCUSDT
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/trades/futures?symbol=BTCUSDT&limit=3"{
"status": "ok",
"server_time": "2026-11-08T12:51:21.435Z",
"data_type": "trades_futures",
"symbol": "BTCUSDT",
"market": "futures",
"data": [
{
"time": "2026-11-08T12:51:20.259Z",
"id": "9f114b68fe82a34c",
"side": "buy",
"price": 75911.2,
"quantity": 0.0013,
"value_usd": 98.68456
},
{
"time": "2026-11-08T12:51:20.108Z",
"id": "dd1a8c641f7a598a",
"side": "buy",
"price": 75911.2,
"quantity": 0.0008,
"value_usd": 60.72896
},
{
"time": "2026-11-08T12:51:19.966Z",
"id": "c540465acc5eac95",
"side": "sell",
"price": 75919.4,
"quantity": 0.013,
"value_usd": 986.9522
}
],
"next": "/v1/trades/futures?symbol=BTCUSDT&limit=3&before_ms=1794142279967&after_id=c540465acc5eac95&order=desc"
}GET /v1/trades/large
Large individual trades. Individual perpetual futures trades above min_usd (default 100,000 USD), all venues. The venue is not disclosed (aggregation-only contract). Read a time range like /v1/trades/futures: since_ms, until_ms, order, after_id, and follow next. Most recent first, or oldest first with order=asc. Follow next to read the following page (it never repeats a row).
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
min_usd | number | 100000 | Minimum notional in USD (default 100000, minimum 1000). |
limit | integer · 1–10000 | 100 | Number of rows to return, in the reading order (most recent first by default). Bounded by your plan's history window: an explicit limit (or since_ms) reaching beyond it returns 403 history_depth; without them the page simply stops at the window. |
since_ms | integer | — | Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range. |
until_ms | integer | — | Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next. |
before_ms | integer | — | Upper time bound, EXCLUSIVE, in epoch milliseconds: rows strictly before it. Pass the oldest time you received to read the previous page without repeating a row. Not combinable with until_ms (422 invalid_time_range). |
after_id | string | — | Resume right after this trade: the id of the last trade received, with its time as since_ms (order=asc) or until_ms (order=desc). Simplest: call the next URL of the previous response. Unknown or expired id: 422 invalid_parameter. |
order | string | — | Range reading: desc (most recent first, the default) or asc. Giving order, since_ms or until_ms switches the route to range reading. Either way, a full page carries next (the following page, older trades without range parameters) and the last page next: null. |
symbol obligatoire | string | — | Trading pair, e.g. BTCUSDT. Required. The served pairs: GET /v1/symbols. Case-insensitive (btcusdt works; the envelope gives the canonical BTCUSDT). An unknown pair returns 422 invalid_symbol with the accepted list. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,id. Unknown field: 422 unknown_field with a suggestion. |
6 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
[].time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Execution instant of the trade, as stated by the venue (milliseconds). |
[].id | string | Opaque, stable identifier of the trade (16 hex characters): the same trade always has the same id, so it can be used to deduplicate or resume. It reveals nothing about the venue. | |
[].side | string | Trades: buy or sell (aggressor side). Liquidations: long or short (the position liquidated). | |
[].price | number | quote currency (USDT for BTCUSDT) | Price. |
[].quantity | number | base asset quantity (BTC for BTCUSDT) | Quantity traded or liquidated, in base asset units. |
[].value_usd | number | USD | Notional value: price × quantity, in the pair's quote currency (USDT for BTCUSDT), taken as USD. |
Essayer
GET https://api.bytnode.com/v1/trades/large?min_usd=100000&limit=3&symbol=BTCUSDT
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/trades/large?symbol=BTCUSDT&min_usd=100000&limit=3"{
"status": "ok",
"server_time": "2026-11-08T12:51:20.402Z",
"data_type": "trades_large",
"symbol": "BTCUSDT",
"min_usd": 100000,
"market": "futures",
"data": [
{
"time": "2026-11-08T12:50:58.720Z",
"id": "c76d0ec895c1b68a",
"side": "buy",
"price": 75905.2,
"quantity": 2.772,
"value_usd": 210409.2144
},
{
"time": "2026-11-08T12:49:46.367Z",
"id": "4fb5997868f561e4",
"side": "buy",
"price": 75925,
"quantity": 1.34115,
"value_usd": 101826.81375
},
{
"time": "2026-11-08T12:49:09.646Z",
"id": "d8c366c0d3fadac2",
"side": "sell",
"price": 75905.1,
"quantity": 10,
"value_usd": 759051
}
],
"next": "/v1/trades/large?symbol=BTCUSDT&min_usd=100000&limit=3&before_ms=1794142149647&after_id=d8c366c0d3fadac2&order=desc"
}GET /v1/trades/spot
Individual spot trades. Spot executions ("trades") across venues, one row per trade, most recent first — the same trades, with the same id, as the WebSocket channel trades.spot. Kept 72 hours; your plan sets how far back you can read. Without range parameters: the last limit trades. To read a time range, give since_ms, until_ms and/or order (asc or desc): a page holds at most limit trades and covers at most 15 minutes, and next is the URL of the following page — call it as is — or null once the range is read. Following next returns every trade of the range exactly once, in order. Each trade has a stable id, the same as on the WebSocket.
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
limit | integer · 1–10000 | 100 | Number of rows to return, in the reading order (most recent first by default). Bounded by your plan's history window: an explicit limit (or since_ms) reaching beyond it returns 403 history_depth; without them the page simply stops at the window. |
since_ms | integer | — | Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range. |
until_ms | integer | — | Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next. |
before_ms | integer | — | Upper time bound, EXCLUSIVE, in epoch milliseconds: rows strictly before it. Pass the oldest time you received to read the previous page without repeating a row. Not combinable with until_ms (422 invalid_time_range). |
after_id | string | — | Resume right after this trade: the id of the last trade received, with its time as since_ms (order=asc) or until_ms (order=desc). Simplest: call the next URL of the previous response. Unknown or expired id: 422 invalid_parameter. |
order | string | — | Range reading: desc (most recent first, the default) or asc. Giving order, since_ms or until_ms switches the route to range reading. Either way, a full page carries next (the following page, older trades without range parameters) and the last page next: null. |
symbol obligatoire | string | — | Trading pair, e.g. BTCUSDT. Required. The served pairs: GET /v1/symbols. Case-insensitive (btcusdt works; the envelope gives the canonical BTCUSDT). An unknown pair returns 422 invalid_symbol with the accepted list. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,id. Unknown field: 422 unknown_field with a suggestion. |
6 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
[].time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Execution instant of the trade, as stated by the venue (milliseconds). |
[].id | string | Opaque, stable identifier of the trade (16 hex characters): the same trade always has the same id, so it can be used to deduplicate or resume. It reveals nothing about the venue. | |
[].side | string | Trades: buy or sell (aggressor side). Liquidations: long or short (the position liquidated). | |
[].price | number | quote currency (USDT for BTCUSDT) | Price. |
[].quantity | number | base asset quantity (BTC for BTCUSDT) | Quantity traded or liquidated, in base asset units. |
[].value_usd | number | USD | Notional value: price × quantity, in the pair's quote currency (USDT for BTCUSDT), taken as USD. |
Essayer
GET https://api.bytnode.com/v1/trades/spot?limit=3&symbol=BTCUSDT
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/trades/spot?symbol=BTCUSDT&limit=3"{
"status": "ok",
"server_time": "2026-11-08T12:51:20.919Z",
"data_type": "trades_spot",
"symbol": "BTCUSDT",
"market": "spot",
"data": [
{
"time": "2026-11-08T12:51:19.672Z",
"id": "8e87e9015d00b3a9",
"side": "buy",
"price": 75942.9129325,
"quantity": 0.02669817,
"value_usd": 2027.53679977
},
{
"time": "2026-11-08T12:51:19.628Z",
"id": "6061d91564d24637",
"side": "sell",
"price": 75942.922946,
"quantity": 0.00006201,
"value_usd": 4.70922065188
},
{
"time": "2026-11-08T12:51:19.605Z",
"id": "b68f80b5a8713fe2",
"side": "sell",
"price": 75936.52,
"quantity": 0.00009903,
"value_usd": 7.5199935756
}
],
"next": "/v1/trades/spot?symbol=BTCUSDT&limit=3&before_ms=1794142279606&after_id=b68f80b5a8713fe2&order=desc"
}#Order flow
Who is buying and who is selling: trade candles (trades-kline: spot, futures, combined), CVD, buy/sell ratio, average trade size and inter-venue spread. Every bucketed series says whether the value is final (is_closed).
GET /v1/buy-sell-ratio
Buy/sell volume ratio. Taker buy share of volume (buy_ratio, a fraction) of the latest CLOSED bucket of timeframe (required), all venues: the first row of /v1/buy-sell-ratio/history for the same timeframe, and the same buy and sell volumes as /v1/cvd for that bucket. Above 0.5 = buyers dominate. The market is in the PATH: no suffix = all markets (spot + perpetual futures), /spot, /futures; the envelope says which (market). Spot base-asset quantities are measured since 2026-09-27: before that date, spot and all-market buy/sell volumes are estimated from USD amounts (is_volume_estimated: true); /futures serves the full futures history.
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
timeframe obligatoire | string | — | Bucket size, required: 1m, 5m, 15m, 30m, 1h, 4h or 1d. Missing: 422 missing_parameter; other values: 422 invalid_timeframe with the accepted list. In any case (1H is 1h), except 1M: refused, since elsewhere it means a month and here 1m is one minute. |
symbol obligatoire | string | — | Trading pair, e.g. BTCUSDT. Required. The served pairs: GET /v1/symbols. Case-insensitive (btcusdt works; the envelope gives the canonical BTCUSDT). An unknown pair returns 422 invalid_symbol with the accepted list. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,buy_volume. Unknown field: 422 unknown_field with a suggestion. |
8 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Start of the latest closed bucket of timeframe — the first row of /v1/buy-sell-ratio/history for the same timeframe. |
buy_volume | number | null | base asset quantity (BTC for BTCUSDT) | Aggressive (taker) buy volume, base asset units, aggregated across venues. |
sell_volume | number | null | base asset quantity (BTC for BTCUSDT) | Aggressive (taker) sell volume, base asset units, aggregated across venues. |
buy_ratio | number | null | fraction (0.585 = 58.5 %) | buy_volume / (buy_volume + sell_volume). Above 0.5 = buyers dominate. |
sample_count | integer | null | count | Number of points of the CVD series behind the bucket — the sample_count of /v1/cvd for the same bucket. |
buy_sell_coverage_ratio | number | null | fraction (0.585 = 58.5 %) | Share of the volume (in USD) whose buy/sell split is known. 1 = every trade is split. Below 1 on part of the history, where some sources did not report the aggressor side: buy_volume and sell_volume then cover that share only, so buy_volume + sell_volume < volume; buy_ratio and the CVD describe the covered share. null when the bucket has no volume. |
is_volume_estimated | boolean | null | true when some base-asset quantities of this row were ESTIMATED from USD amounts (history where a source reported amounts but not quantities): a buy or sell amount is converted at that source's own average price when its total quantity is known, otherwise at the candle's typical price (high + low + close) / 3. Every quantity a source measured is kept as is. false = all measured. null when the volume itself is null (not available). | |
is_closed | boolean | true = the row is final; false = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with ?live=1 on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades. |
Essayer
GET https://api.bytnode.com/v1/buy-sell-ratio?timeframe=1h&symbol=BTCUSDT
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/buy-sell-ratio?symbol=BTCUSDT&timeframe=1h"{
"status": "ok",
"server_time": "2026-11-08T12:51:36.637Z",
"data_type": "buy_sell_ratio",
"symbol": "BTCUSDT",
"timeframe": "1h",
"market": "all",
"data": {
"time": "2026-11-08T11:00:00.000Z",
"buy_volume": 2160.77349106,
"sell_volume": 1821.49373011,
"buy_ratio": 0.542598818978,
"sample_count": 60,
"buy_sell_coverage_ratio": 1,
"is_volume_estimated": false,
"is_closed": true
}
}GET /v1/buy-sell-ratio/futures
Buy/sell volume ratio, perpetual futures only. Perpetual futures market only. Same as /v1/buy-sell-ratio, which serves every market.
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
timeframe obligatoire | string | — | Bucket size, required: 1m, 5m, 15m, 30m, 1h, 4h or 1d. Missing: 422 missing_parameter; other values: 422 invalid_timeframe with the accepted list. In any case (1H is 1h), except 1M: refused, since elsewhere it means a month and here 1m is one minute. |
symbol obligatoire | string | — | Trading pair, e.g. BTCUSDT. Required. The served pairs: GET /v1/symbols. Case-insensitive (btcusdt works; the envelope gives the canonical BTCUSDT). An unknown pair returns 422 invalid_symbol with the accepted list. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,buy_volume. Unknown field: 422 unknown_field with a suggestion. |
8 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Start of the latest closed bucket of timeframe — the first row of /v1/buy-sell-ratio/history for the same timeframe. |
buy_volume | number | null | base asset quantity (BTC for BTCUSDT) | Aggressive (taker) buy volume, base asset units, aggregated across venues. |
sell_volume | number | null | base asset quantity (BTC for BTCUSDT) | Aggressive (taker) sell volume, base asset units, aggregated across venues. |
buy_ratio | number | null | fraction (0.585 = 58.5 %) | buy_volume / (buy_volume + sell_volume). Above 0.5 = buyers dominate. |
sample_count | integer | null | count | Number of points of the CVD series behind the bucket — the sample_count of /v1/cvd for the same bucket. |
buy_sell_coverage_ratio | number | null | fraction (0.585 = 58.5 %) | Share of the volume (in USD) whose buy/sell split is known. 1 = every trade is split. Below 1 on part of the history, where some sources did not report the aggressor side: buy_volume and sell_volume then cover that share only, so buy_volume + sell_volume < volume; buy_ratio and the CVD describe the covered share. null when the bucket has no volume. |
is_volume_estimated | boolean | null | true when some base-asset quantities of this row were ESTIMATED from USD amounts (history where a source reported amounts but not quantities): a buy or sell amount is converted at that source's own average price when its total quantity is known, otherwise at the candle's typical price (high + low + close) / 3. Every quantity a source measured is kept as is. false = all measured. null when the volume itself is null (not available). | |
is_closed | boolean | true = the row is final; false = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with ?live=1 on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades. |
Essayer
GET https://api.bytnode.com/v1/buy-sell-ratio/futures?timeframe=1h&symbol=BTCUSDT
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/buy-sell-ratio/futures?symbol=BTCUSDT&timeframe=1h"{
"status": "ok",
"server_time": "2026-11-08T12:52:36.790Z",
"data_type": "buy_sell_ratio_futures",
"symbol": "BTCUSDT",
"timeframe": "1h",
"market": "futures",
"data": {
"time": "2026-11-08T11:00:00.000Z",
"buy_volume": 1831.62664,
"sell_volume": 1625.86005,
"buy_ratio": 0.529756671312,
"sample_count": 60,
"buy_sell_coverage_ratio": 1,
"is_volume_estimated": false,
"is_closed": true
}
}GET /v1/buy-sell-ratio/futures/history
Buy/sell ratio history, perpetual futures only. Perpetual futures market only. Same as /v1/buy-sell-ratio/history, which serves every market.
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
since_ms | integer | — | Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range. |
until_ms | integer | — | Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next. |
limit | integer · 1–1000 | 100 | Number of rows to return, in the reading order (most recent first by default). Bounded by your plan's history window: an explicit limit (or since_ms) reaching beyond it returns 403 history_depth; without them the page simply stops at the window. |
timeframe obligatoire | string | — | Required: 1m, 5m, 15m, 30m, 1h, 4h or 1d. One row per closed bucket, holding the totals of the WHOLE bucket. Missing: 422 missing_parameter. |
symbol obligatoire | string | — | Trading pair, e.g. BTCUSDT. Required. The served pairs: GET /v1/symbols. Case-insensitive (btcusdt works; the envelope gives the canonical BTCUSDT). An unknown pair returns 422 invalid_symbol with the accepted list. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,buy_volume. Unknown field: 422 unknown_field with a suggestion. |
before_ms | integer | — | Upper time bound, EXCLUSIVE, in epoch milliseconds: rows strictly before it. Pass the oldest time you received to read the previous page without repeating a row. Not combinable with until_ms (422 invalid_time_range). |
order | string | desc | Reading order: desc (most recent first, the default) or asc (oldest first, reading forward from since_ms, which is then required). Follow next to read the following page. |
8 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
[].time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Start of the bucket. The row covers the WHOLE bucket, from time to time + the envelope's step (excluded). |
[].buy_volume | number | null | base asset quantity (BTC for BTCUSDT) | Aggressive (taker) buy volume, base asset units, aggregated across venues. |
[].sell_volume | number | null | base asset quantity (BTC for BTCUSDT) | Aggressive (taker) sell volume, base asset units, aggregated across venues. |
[].buy_ratio | number | null | fraction (0.585 = 58.5 %) | buy_volume / (buy_volume + sell_volume). Above 0.5 = buyers dominate. |
[].sample_count | integer | null | count | Number of points of the CVD series behind the bucket — the sample_count of /v1/cvd/history for the same bucket. |
[].buy_sell_coverage_ratio | number | null | fraction (0.585 = 58.5 %) | Share of the volume (in USD) whose buy/sell split is known. 1 = every trade is split. Below 1 on part of the history, where some sources did not report the aggressor side: buy_volume and sell_volume then cover that share only, so buy_volume + sell_volume < volume; buy_ratio and the CVD describe the covered share. null when the bucket has no volume. |
[].is_volume_estimated | boolean | null | true when some base-asset quantities of this row were ESTIMATED from USD amounts (history where a source reported amounts but not quantities): a buy or sell amount is converted at that source's own average price when its total quantity is known, otherwise at the candle's typical price (high + low + close) / 3. Every quantity a source measured is kept as is. false = all measured. null when the volume itself is null (not available). | |
[].is_closed | boolean | true = the row is final; false = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with ?live=1 on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades. |
Essayer
GET https://api.bytnode.com/v1/buy-sell-ratio/futures/history?limit=3&timeframe=1h&symbol=BTCUSDT
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/buy-sell-ratio/futures/history?symbol=BTCUSDT&limit=3&timeframe=1h"{
"status": "ok",
"server_time": "2026-11-08T12:52:37.873Z",
"data_type": "buy_sell_ratio_futures_history",
"symbol": "BTCUSDT",
"timeframe": "1h",
"market": "futures",
"step": "1h",
"data": [
{
"time": "2026-11-08T11:00:00.000Z",
"buy_volume": 1831.62664,
"sell_volume": 1625.86005,
"buy_ratio": 0.529756671312,
"sample_count": 60,
"buy_sell_coverage_ratio": 1,
"is_volume_estimated": false,
"is_closed": true
},
{
"time": "2026-11-08T10:00:00.000Z",
"buy_volume": 1177.88913,
"sell_volume": 1267.86463,
"buy_ratio": 0.481605772938,
"sample_count": 60,
"buy_sell_coverage_ratio": 1,
"is_volume_estimated": false,
"is_closed": true
},
{
"time": "2026-11-08T09:00:00.000Z",
"buy_volume": 1064.63108,
"sell_volume": 1373.27707,
"buy_ratio": 0.436698601627,
"sample_count": 60,
"buy_sell_coverage_ratio": 1,
"is_volume_estimated": false,
"is_closed": true
}
],
"next": "/v1/buy-sell-ratio/futures/history?symbol=BTCUSDT&limit=3&timeframe=1h&before_ms=1794128400000&order=desc"
}GET /v1/buy-sell-ratio/history
Buy/sell ratio history. One row per closed bucket of timeframe (required): the taker buy and sell volumes of the WHOLE bucket — the same volumes as /v1/cvd/history for the same market and bucket — and the buy share of their sum. The market is in the PATH: no suffix = all markets (spot + perpetual futures), /spot, /futures; the envelope says which (market). Spot base-asset quantities are measured since 2026-09-27: before that date, spot and all-market buy/sell volumes are estimated from USD amounts (is_volume_estimated: true); /futures serves the full futures history. Most recent first, or oldest first with order=asc. Follow next to read the following page (it never repeats a row).
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
since_ms | integer | — | Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range. |
until_ms | integer | — | Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next. |
limit | integer · 1–1000 | 100 | Number of rows to return, in the reading order (most recent first by default). Bounded by your plan's history window: an explicit limit (or since_ms) reaching beyond it returns 403 history_depth; without them the page simply stops at the window. |
timeframe obligatoire | string | — | Required: 1m, 5m, 15m, 30m, 1h, 4h or 1d. One row per closed bucket, holding the totals of the WHOLE bucket. Missing: 422 missing_parameter. |
symbol obligatoire | string | — | Trading pair, e.g. BTCUSDT. Required. The served pairs: GET /v1/symbols. Case-insensitive (btcusdt works; the envelope gives the canonical BTCUSDT). An unknown pair returns 422 invalid_symbol with the accepted list. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,buy_volume. Unknown field: 422 unknown_field with a suggestion. |
before_ms | integer | — | Upper time bound, EXCLUSIVE, in epoch milliseconds: rows strictly before it. Pass the oldest time you received to read the previous page without repeating a row. Not combinable with until_ms (422 invalid_time_range). |
order | string | desc | Reading order: desc (most recent first, the default) or asc (oldest first, reading forward from since_ms, which is then required). Follow next to read the following page. |
8 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
[].time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Start of the bucket. The row covers the WHOLE bucket, from time to time + the envelope's step (excluded). |
[].buy_volume | number | null | base asset quantity (BTC for BTCUSDT) | Aggressive (taker) buy volume, base asset units, aggregated across venues. |
[].sell_volume | number | null | base asset quantity (BTC for BTCUSDT) | Aggressive (taker) sell volume, base asset units, aggregated across venues. |
[].buy_ratio | number | null | fraction (0.585 = 58.5 %) | buy_volume / (buy_volume + sell_volume). Above 0.5 = buyers dominate. |
[].sample_count | integer | null | count | Number of points of the CVD series behind the bucket — the sample_count of /v1/cvd/history for the same bucket. |
[].buy_sell_coverage_ratio | number | null | fraction (0.585 = 58.5 %) | Share of the volume (in USD) whose buy/sell split is known. 1 = every trade is split. Below 1 on part of the history, where some sources did not report the aggressor side: buy_volume and sell_volume then cover that share only, so buy_volume + sell_volume < volume; buy_ratio and the CVD describe the covered share. null when the bucket has no volume. |
[].is_volume_estimated | boolean | null | true when some base-asset quantities of this row were ESTIMATED from USD amounts (history where a source reported amounts but not quantities): a buy or sell amount is converted at that source's own average price when its total quantity is known, otherwise at the candle's typical price (high + low + close) / 3. Every quantity a source measured is kept as is. false = all measured. null when the volume itself is null (not available). | |
[].is_closed | boolean | true = the row is final; false = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with ?live=1 on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades. |
Essayer
GET https://api.bytnode.com/v1/buy-sell-ratio/history?limit=3&timeframe=1h&symbol=BTCUSDT
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/buy-sell-ratio/history?symbol=BTCUSDT&limit=3&timeframe=1h"{
"status": "ok",
"server_time": "2026-11-08T12:51:37.225Z",
"data_type": "buy_sell_ratio_history",
"symbol": "BTCUSDT",
"timeframe": "1h",
"market": "all",
"step": "1h",
"data": [
{
"time": "2026-11-08T11:00:00.000Z",
"buy_volume": 2160.77349106,
"sell_volume": 1821.49373011,
"buy_ratio": 0.542598818978,
"sample_count": 60,
"buy_sell_coverage_ratio": 1,
"is_volume_estimated": false,
"is_closed": true
},
{
"time": "2026-11-08T10:00:00.000Z",
"buy_volume": 1508.80409631,
"sell_volume": 1574.36822793,
"buy_ratio": 0.489367423432,
"sample_count": 60,
"buy_sell_coverage_ratio": 1,
"is_volume_estimated": false,
"is_closed": true
},
{
"time": "2026-11-08T09:00:00.000Z",
"buy_volume": 1422.09755438,
"sell_volume": 1785.88038121,
"buy_ratio": 0.443300291627,
"sample_count": 60,
"buy_sell_coverage_ratio": 1,
"is_volume_estimated": false,
"is_closed": true
}
],
"next": "/v1/buy-sell-ratio/history?symbol=BTCUSDT&limit=3&timeframe=1h&before_ms=1794128400000&order=desc"
}GET /v1/buy-sell-ratio/spot
Buy/sell volume ratio, spot only. Spot market only. Same as /v1/buy-sell-ratio, which serves every market.
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
timeframe obligatoire | string | — | Bucket size, required: 1m, 5m, 15m, 30m, 1h, 4h or 1d. Missing: 422 missing_parameter; other values: 422 invalid_timeframe with the accepted list. In any case (1H is 1h), except 1M: refused, since elsewhere it means a month and here 1m is one minute. |
symbol obligatoire | string | — | Trading pair, e.g. BTCUSDT. Required. The served pairs: GET /v1/symbols. Case-insensitive (btcusdt works; the envelope gives the canonical BTCUSDT). An unknown pair returns 422 invalid_symbol with the accepted list. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,buy_volume. Unknown field: 422 unknown_field with a suggestion. |
8 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Start of the latest closed bucket of timeframe — the first row of /v1/buy-sell-ratio/history for the same timeframe. |
buy_volume | number | null | base asset quantity (BTC for BTCUSDT) | Aggressive (taker) buy volume, base asset units, aggregated across venues. |
sell_volume | number | null | base asset quantity (BTC for BTCUSDT) | Aggressive (taker) sell volume, base asset units, aggregated across venues. |
buy_ratio | number | null | fraction (0.585 = 58.5 %) | buy_volume / (buy_volume + sell_volume). Above 0.5 = buyers dominate. |
sample_count | integer | null | count | Number of points of the CVD series behind the bucket — the sample_count of /v1/cvd for the same bucket. |
buy_sell_coverage_ratio | number | null | fraction (0.585 = 58.5 %) | Share of the volume (in USD) whose buy/sell split is known. 1 = every trade is split. Below 1 on part of the history, where some sources did not report the aggressor side: buy_volume and sell_volume then cover that share only, so buy_volume + sell_volume < volume; buy_ratio and the CVD describe the covered share. null when the bucket has no volume. |
is_volume_estimated | boolean | null | true when some base-asset quantities of this row were ESTIMATED from USD amounts (history where a source reported amounts but not quantities): a buy or sell amount is converted at that source's own average price when its total quantity is known, otherwise at the candle's typical price (high + low + close) / 3. Every quantity a source measured is kept as is. false = all measured. null when the volume itself is null (not available). | |
is_closed | boolean | true = the row is final; false = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with ?live=1 on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades. |
Essayer
GET https://api.bytnode.com/v1/buy-sell-ratio/spot?timeframe=1h&symbol=BTCUSDT
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/buy-sell-ratio/spot?symbol=BTCUSDT&timeframe=1h"{
"status": "ok",
"server_time": "2026-11-08T12:52:36.250Z",
"data_type": "buy_sell_ratio_spot",
"symbol": "BTCUSDT",
"timeframe": "1h",
"market": "spot",
"data": {
"time": "2026-11-08T11:00:00.000Z",
"buy_volume": 329.14685106,
"sell_volume": 195.63368011,
"buy_ratio": 0.627208578653,
"sample_count": 60,
"buy_sell_coverage_ratio": 1,
"is_volume_estimated": false,
"is_closed": true
}
}GET /v1/buy-sell-ratio/spot/history
Buy/sell ratio history, spot only. Spot market only. Same as /v1/buy-sell-ratio/history, which serves every market.
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
since_ms | integer | — | Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range. |
until_ms | integer | — | Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next. |
limit | integer · 1–1000 | 100 | Number of rows to return, in the reading order (most recent first by default). Bounded by your plan's history window: an explicit limit (or since_ms) reaching beyond it returns 403 history_depth; without them the page simply stops at the window. |
timeframe obligatoire | string | — | Required: 1m, 5m, 15m, 30m, 1h, 4h or 1d. One row per closed bucket, holding the totals of the WHOLE bucket. Missing: 422 missing_parameter. |
symbol obligatoire | string | — | Trading pair, e.g. BTCUSDT. Required. The served pairs: GET /v1/symbols. Case-insensitive (btcusdt works; the envelope gives the canonical BTCUSDT). An unknown pair returns 422 invalid_symbol with the accepted list. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,buy_volume. Unknown field: 422 unknown_field with a suggestion. |
before_ms | integer | — | Upper time bound, EXCLUSIVE, in epoch milliseconds: rows strictly before it. Pass the oldest time you received to read the previous page without repeating a row. Not combinable with until_ms (422 invalid_time_range). |
order | string | desc | Reading order: desc (most recent first, the default) or asc (oldest first, reading forward from since_ms, which is then required). Follow next to read the following page. |
8 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
[].time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Start of the bucket. The row covers the WHOLE bucket, from time to time + the envelope's step (excluded). |
[].buy_volume | number | null | base asset quantity (BTC for BTCUSDT) | Aggressive (taker) buy volume, base asset units, aggregated across venues. |
[].sell_volume | number | null | base asset quantity (BTC for BTCUSDT) | Aggressive (taker) sell volume, base asset units, aggregated across venues. |
[].buy_ratio | number | null | fraction (0.585 = 58.5 %) | buy_volume / (buy_volume + sell_volume). Above 0.5 = buyers dominate. |
[].sample_count | integer | null | count | Number of points of the CVD series behind the bucket — the sample_count of /v1/cvd/history for the same bucket. |
[].buy_sell_coverage_ratio | number | null | fraction (0.585 = 58.5 %) | Share of the volume (in USD) whose buy/sell split is known. 1 = every trade is split. Below 1 on part of the history, where some sources did not report the aggressor side: buy_volume and sell_volume then cover that share only, so buy_volume + sell_volume < volume; buy_ratio and the CVD describe the covered share. null when the bucket has no volume. |
[].is_volume_estimated | boolean | null | true when some base-asset quantities of this row were ESTIMATED from USD amounts (history where a source reported amounts but not quantities): a buy or sell amount is converted at that source's own average price when its total quantity is known, otherwise at the candle's typical price (high + low + close) / 3. Every quantity a source measured is kept as is. false = all measured. null when the volume itself is null (not available). | |
[].is_closed | boolean | true = the row is final; false = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with ?live=1 on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades. |
Essayer
GET https://api.bytnode.com/v1/buy-sell-ratio/spot/history?limit=3&timeframe=1h&symbol=BTCUSDT
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/buy-sell-ratio/spot/history?symbol=BTCUSDT&limit=3&timeframe=1h"{
"status": "ok",
"server_time": "2026-11-08T12:52:37.329Z",
"data_type": "buy_sell_ratio_spot_history",
"symbol": "BTCUSDT",
"timeframe": "1h",
"market": "spot",
"step": "1h",
"data": [
{
"time": "2026-11-08T11:00:00.000Z",
"buy_volume": 329.14685106,
"sell_volume": 195.63368011,
"buy_ratio": 0.627208578653,
"sample_count": 60,
"buy_sell_coverage_ratio": 1,
"is_volume_estimated": false,
"is_closed": true
},
{
"time": "2026-11-08T10:00:00.000Z",
"buy_volume": 330.91496631,
"sell_volume": 306.50359793,
"buy_ratio": 0.519148617368,
"sample_count": 60,
"buy_sell_coverage_ratio": 1,
"is_volume_estimated": false,
"is_closed": true
},
{
"time": "2026-11-08T09:00:00.000Z",
"buy_volume": 357.46647438,
"sell_volume": 412.60331121,
"buy_ratio": 0.464200103769,
"sample_count": 60,
"buy_sell_coverage_ratio": 1,
"is_volume_estimated": false,
"is_closed": true
}
],
"next": "/v1/buy-sell-ratio/spot/history?symbol=BTCUSDT&limit=3&timeframe=1h&before_ms=1794128400000&order=desc"
}GET /v1/cvd
Cumulative volume delta per bucket. Net taker delta of the latest closed bucket, with its path inside the bucket (cvd_series: one point per minute up to 1h, per 5 minutes in 4h, per 15 minutes in 1d), aggregated across venues. Its buy and sell volumes are those of /v1/trades-kline for the same market and bucket. The market is in the PATH: no suffix = all markets (spot + perpetual futures), /spot, /futures; the envelope says which (market). Spot base-asset quantities are measured since 2026-09-27: before that date, spot and all-market buy/sell volumes are estimated from USD amounts (is_volume_estimated: true); /futures serves the full futures history. Bucketed: is_closed says whether the value is final. Add ?live=1 for the open period.
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
timeframe obligatoire | string | — | Bucket size, required: 1m, 5m, 15m, 30m, 1h, 4h or 1d. Missing: 422 missing_parameter; other values: 422 invalid_timeframe with the accepted list. In any case (1H is 1h), except 1M: refused, since elsewhere it means a month and here 1m is one minute. |
live | boolean | false | 1 or true to return the CURRENT, still-open period computed on the fly (is_closed: false). Default: the last closed period only. |
symbol obligatoire | string | — | Trading pair, e.g. BTCUSDT. Required. The served pairs: GET /v1/symbols. Case-insensitive (btcusdt works; the envelope gives the canonical BTCUSDT). An unknown pair returns 422 invalid_symbol with the accepted list. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,net_volume. Unknown field: 422 unknown_field with a suggestion. |
9 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Start of the bucket the row covers: a 1h bucket at 14:00 covers 14:00:00 to 14:59:59.999. |
cvd_series | number[] | null | base asset quantity (BTC for BTCUSDT) | Cumulative volume delta inside the bucket, one point per step of finer candles (1 minute up to 1h, 5 minutes in 4h, 15 minutes in 1d), starting from 0 at the bucket start. null when those finer candles do not cover the bucket (before 2026-06-05; in 1d, before 2023-12; or a collection gap): buy_volume, sell_volume and net_volume then come from the bucket's own candle, as on /v1/trades-kline, and sample_count is 1. |
net_volume | number | null | base asset quantity (BTC for BTCUSDT) | buy_volume - sell_volume over the row, base asset units. Positive = net buying. |
buy_volume | number | null | base asset quantity (BTC for BTCUSDT) | Aggressive (taker) buy volume, base asset units, aggregated across venues. |
sell_volume | number | null | base asset quantity (BTC for BTCUSDT) | Aggressive (taker) sell volume, base asset units, aggregated across venues. |
sample_count | integer | null | count | Number of points in cvd_series; 1 when cvd_series is null (the bucket's candle alone). |
buy_sell_coverage_ratio | number | null | fraction (0.585 = 58.5 %) | Share of the volume (in USD) whose buy/sell split is known. 1 = every trade is split. Below 1 on part of the history, where some sources did not report the aggressor side: buy_volume and sell_volume then cover that share only, so buy_volume + sell_volume < volume; buy_ratio and the CVD describe the covered share. null when the bucket has no volume. |
is_volume_estimated | boolean | null | true when some base-asset quantities of this row were ESTIMATED from USD amounts (history where a source reported amounts but not quantities): a buy or sell amount is converted at that source's own average price when its total quantity is known, otherwise at the candle's typical price (high + low + close) / 3. Every quantity a source measured is kept as is. false = all measured. null when the volume itself is null (not available). | |
is_closed | boolean | true = the row is final; false = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with ?live=1 on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades. |
Essayer
GET https://api.bytnode.com/v1/cvd?timeframe=1h&symbol=BTCUSDT
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/cvd?symbol=BTCUSDT&timeframe=1h"{
"status": "ok",
"server_time": "2026-11-08T12:51:32.286Z",
"data_type": "cvd",
"symbol": "BTCUSDT",
"timeframe": "1h",
"market": "all",
"data": {
"time": "2026-11-08T11:00:00.000Z",
"cvd_series": [
76.67484796,
120.35567509,
116.00015045
],
"net_volume": 339.27976095,
"buy_volume": 2160.77349106,
"sell_volume": 1821.49373011,
"sample_count": 60,
"buy_sell_coverage_ratio": 1,
"is_volume_estimated": false,
"is_closed": true
}
}GET /v1/cvd/futures
Cumulative volume delta per bucket, perpetual futures only. Perpetual futures market only. Same as /v1/cvd, which serves every market.
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
timeframe obligatoire | string | — | Bucket size, required: 1m, 5m, 15m, 30m, 1h, 4h or 1d. Missing: 422 missing_parameter; other values: 422 invalid_timeframe with the accepted list. In any case (1H is 1h), except 1M: refused, since elsewhere it means a month and here 1m is one minute. |
live | boolean | false | 1 or true to return the CURRENT, still-open period computed on the fly (is_closed: false). Default: the last closed period only. |
symbol obligatoire | string | — | Trading pair, e.g. BTCUSDT. Required. The served pairs: GET /v1/symbols. Case-insensitive (btcusdt works; the envelope gives the canonical BTCUSDT). An unknown pair returns 422 invalid_symbol with the accepted list. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,net_volume. Unknown field: 422 unknown_field with a suggestion. |
9 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Start of the bucket the row covers: a 1h bucket at 14:00 covers 14:00:00 to 14:59:59.999. |
cvd_series | number[] | null | base asset quantity (BTC for BTCUSDT) | Cumulative volume delta inside the bucket, one point per step of finer candles (1 minute up to 1h, 5 minutes in 4h, 15 minutes in 1d), starting from 0 at the bucket start. null when those finer candles do not cover the bucket (before 2026-06-05; in 1d, before 2023-12; or a collection gap): buy_volume, sell_volume and net_volume then come from the bucket's own candle, as on /v1/trades-kline, and sample_count is 1. |
net_volume | number | null | base asset quantity (BTC for BTCUSDT) | buy_volume - sell_volume over the row, base asset units. Positive = net buying. |
buy_volume | number | null | base asset quantity (BTC for BTCUSDT) | Aggressive (taker) buy volume, base asset units, aggregated across venues. |
sell_volume | number | null | base asset quantity (BTC for BTCUSDT) | Aggressive (taker) sell volume, base asset units, aggregated across venues. |
sample_count | integer | null | count | Number of points in cvd_series; 1 when cvd_series is null (the bucket's candle alone). |
buy_sell_coverage_ratio | number | null | fraction (0.585 = 58.5 %) | Share of the volume (in USD) whose buy/sell split is known. 1 = every trade is split. Below 1 on part of the history, where some sources did not report the aggressor side: buy_volume and sell_volume then cover that share only, so buy_volume + sell_volume < volume; buy_ratio and the CVD describe the covered share. null when the bucket has no volume. |
is_volume_estimated | boolean | null | true when some base-asset quantities of this row were ESTIMATED from USD amounts (history where a source reported amounts but not quantities): a buy or sell amount is converted at that source's own average price when its total quantity is known, otherwise at the candle's typical price (high + low + close) / 3. Every quantity a source measured is kept as is. false = all measured. null when the volume itself is null (not available). | |
is_closed | boolean | true = the row is final; false = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with ?live=1 on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades. |
Essayer
GET https://api.bytnode.com/v1/cvd/futures?timeframe=1h&symbol=BTCUSDT
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/cvd/futures?symbol=BTCUSDT&timeframe=1h"{
"status": "ok",
"server_time": "2026-11-08T12:52:34.628Z",
"data_type": "cvd_futures",
"symbol": "BTCUSDT",
"timeframe": "1h",
"market": "futures",
"data": {
"time": "2026-11-08T11:00:00.000Z",
"cvd_series": [
67.28073,
109.66785,
108.81996
],
"net_volume": 205.76659,
"buy_volume": 1831.62664,
"sell_volume": 1625.86005,
"sample_count": 60,
"buy_sell_coverage_ratio": 1,
"is_volume_estimated": false,
"is_closed": true
}
}GET /v1/cvd/futures/history
Cumulative volume delta history, perpetual futures only. Perpetual futures market only. Same as /v1/cvd/history, which serves every market.
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
timeframe obligatoire | string | — | Bucket size, required: 1m, 5m, 15m, 30m, 1h, 4h or 1d. Missing: 422 missing_parameter; other values: 422 invalid_timeframe with the accepted list. In any case (1H is 1h), except 1M: refused, since elsewhere it means a month and here 1m is one minute. |
since_ms | integer | — | Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range. |
until_ms | integer | — | Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next. |
limit | integer · 1–1000 | 100 | Number of rows to return, in the reading order (most recent first by default). Bounded by your plan's history window: an explicit limit (or since_ms) reaching beyond it returns 403 history_depth; without them the page simply stops at the window. |
symbol obligatoire | string | — | Trading pair, e.g. BTCUSDT. Required. The served pairs: GET /v1/symbols. Case-insensitive (btcusdt works; the envelope gives the canonical BTCUSDT). An unknown pair returns 422 invalid_symbol with the accepted list. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,net_volume. Unknown field: 422 unknown_field with a suggestion. |
before_ms | integer | — | Upper time bound, EXCLUSIVE, in epoch milliseconds: rows strictly before it. Pass the oldest time you received to read the previous page without repeating a row. Not combinable with until_ms (422 invalid_time_range). |
order | string | desc | Reading order: desc (most recent first, the default) or asc (oldest first, reading forward from since_ms, which is then required). Follow next to read the following page. |
9 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
[].time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Start of the bucket the row covers: a 1h bucket at 14:00 covers 14:00:00 to 14:59:59.999. |
[].cvd_series | number[] | null | base asset quantity (BTC for BTCUSDT) | Cumulative volume delta inside the bucket, one point per step of finer candles (1 minute up to 1h, 5 minutes in 4h, 15 minutes in 1d), starting from 0 at the bucket start. null when those finer candles do not cover the bucket (before 2026-06-05; in 1d, before 2023-12; or a collection gap): buy_volume, sell_volume and net_volume then come from the bucket's own candle, as on /v1/trades-kline, and sample_count is 1. |
[].net_volume | number | null | base asset quantity (BTC for BTCUSDT) | buy_volume - sell_volume over the row, base asset units. Positive = net buying. |
[].buy_volume | number | null | base asset quantity (BTC for BTCUSDT) | Aggressive (taker) buy volume, base asset units, aggregated across venues. |
[].sell_volume | number | null | base asset quantity (BTC for BTCUSDT) | Aggressive (taker) sell volume, base asset units, aggregated across venues. |
[].sample_count | integer | null | count | Number of points in cvd_series; 1 when cvd_series is null (the bucket's candle alone). |
[].buy_sell_coverage_ratio | number | null | fraction (0.585 = 58.5 %) | Share of the volume (in USD) whose buy/sell split is known. 1 = every trade is split. Below 1 on part of the history, where some sources did not report the aggressor side: buy_volume and sell_volume then cover that share only, so buy_volume + sell_volume < volume; buy_ratio and the CVD describe the covered share. null when the bucket has no volume. |
[].is_volume_estimated | boolean | null | true when some base-asset quantities of this row were ESTIMATED from USD amounts (history where a source reported amounts but not quantities): a buy or sell amount is converted at that source's own average price when its total quantity is known, otherwise at the candle's typical price (high + low + close) / 3. Every quantity a source measured is kept as is. false = all measured. null when the volume itself is null (not available). | |
[].is_closed | boolean | true = the row is final; false = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with ?live=1 on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades. |
Essayer
GET https://api.bytnode.com/v1/cvd/futures/history?timeframe=1h&limit=3&symbol=BTCUSDT
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/cvd/futures/history?symbol=BTCUSDT&timeframe=1h&limit=3"{
"status": "ok",
"server_time": "2026-11-08T12:52:35.711Z",
"data_type": "cvd_futures_history",
"symbol": "BTCUSDT",
"timeframe": "1h",
"market": "futures",
"step": "1h",
"data": [
{
"time": "2026-11-08T11:00:00.000Z",
"cvd_series": [
67.28073,
109.66785,
108.81996
],
"net_volume": 205.76659,
"buy_volume": 1831.62664,
"sell_volume": 1625.86005,
"sample_count": 60,
"buy_sell_coverage_ratio": 1,
"is_volume_estimated": false,
"is_closed": true
},
{
"time": "2026-11-08T10:00:00.000Z",
"cvd_series": [
1.0232,
14.24714,
-3.18641
],
"net_volume": -89.9755,
"buy_volume": 1177.88913,
"sell_volume": 1267.86463,
"sample_count": 60,
"buy_sell_coverage_ratio": 1,
"is_volume_estimated": false,
"is_closed": true
},
{
"time": "2026-11-08T09:00:00.000Z",
"cvd_series": [
-0.7662,
-54.10799,
4.82661
],
"net_volume": -308.64599,
"buy_volume": 1064.63108,
"sell_volume": 1373.27707,
"sample_count": 60,
"buy_sell_coverage_ratio": 1,
"is_volume_estimated": false,
"is_closed": true
}
],
"next": "/v1/cvd/futures/history?symbol=BTCUSDT&timeframe=1h&limit=3&before_ms=1794128400000&order=desc"
}GET /v1/cvd/history
Cumulative volume delta history. Same as /v1/cvd, one row per closed bucket. Older buckets (before 2026-06-05 when the finer candles start; in 1d, before 2023-12) carry the buy and sell volumes of their own candle with cvd_series: null; where some sources did not report the aggressor side, buy_sell_coverage_ratio < 1 says which share of the volume is split. The market is in the PATH: no suffix = all markets (spot + perpetual futures), /spot, /futures; the envelope says which (market). Spot base-asset quantities are measured since 2026-09-27: before that date, spot and all-market buy/sell volumes are estimated from USD amounts (is_volume_estimated: true); /futures serves the full futures history. Most recent first, or oldest first with order=asc. Follow next to read the following page (it never repeats a row).
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
timeframe obligatoire | string | — | Bucket size, required: 1m, 5m, 15m, 30m, 1h, 4h or 1d. Missing: 422 missing_parameter; other values: 422 invalid_timeframe with the accepted list. In any case (1H is 1h), except 1M: refused, since elsewhere it means a month and here 1m is one minute. |
since_ms | integer | — | Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range. |
until_ms | integer | — | Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next. |
limit | integer · 1–1000 | 100 | Number of rows to return, in the reading order (most recent first by default). Bounded by your plan's history window: an explicit limit (or since_ms) reaching beyond it returns 403 history_depth; without them the page simply stops at the window. |
symbol obligatoire | string | — | Trading pair, e.g. BTCUSDT. Required. The served pairs: GET /v1/symbols. Case-insensitive (btcusdt works; the envelope gives the canonical BTCUSDT). An unknown pair returns 422 invalid_symbol with the accepted list. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,net_volume. Unknown field: 422 unknown_field with a suggestion. |
before_ms | integer | — | Upper time bound, EXCLUSIVE, in epoch milliseconds: rows strictly before it. Pass the oldest time you received to read the previous page without repeating a row. Not combinable with until_ms (422 invalid_time_range). |
order | string | desc | Reading order: desc (most recent first, the default) or asc (oldest first, reading forward from since_ms, which is then required). Follow next to read the following page. |
9 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
[].time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Start of the bucket the row covers: a 1h bucket at 14:00 covers 14:00:00 to 14:59:59.999. |
[].cvd_series | number[] | null | base asset quantity (BTC for BTCUSDT) | Cumulative volume delta inside the bucket, one point per step of finer candles (1 minute up to 1h, 5 minutes in 4h, 15 minutes in 1d), starting from 0 at the bucket start. null when those finer candles do not cover the bucket (before 2026-06-05; in 1d, before 2023-12; or a collection gap): buy_volume, sell_volume and net_volume then come from the bucket's own candle, as on /v1/trades-kline, and sample_count is 1. |
[].net_volume | number | null | base asset quantity (BTC for BTCUSDT) | buy_volume - sell_volume over the row, base asset units. Positive = net buying. |
[].buy_volume | number | null | base asset quantity (BTC for BTCUSDT) | Aggressive (taker) buy volume, base asset units, aggregated across venues. |
[].sell_volume | number | null | base asset quantity (BTC for BTCUSDT) | Aggressive (taker) sell volume, base asset units, aggregated across venues. |
[].sample_count | integer | null | count | Number of points in cvd_series; 1 when cvd_series is null (the bucket's candle alone). |
[].buy_sell_coverage_ratio | number | null | fraction (0.585 = 58.5 %) | Share of the volume (in USD) whose buy/sell split is known. 1 = every trade is split. Below 1 on part of the history, where some sources did not report the aggressor side: buy_volume and sell_volume then cover that share only, so buy_volume + sell_volume < volume; buy_ratio and the CVD describe the covered share. null when the bucket has no volume. |
[].is_volume_estimated | boolean | null | true when some base-asset quantities of this row were ESTIMATED from USD amounts (history where a source reported amounts but not quantities): a buy or sell amount is converted at that source's own average price when its total quantity is known, otherwise at the candle's typical price (high + low + close) / 3. Every quantity a source measured is kept as is. false = all measured. null when the volume itself is null (not available). | |
[].is_closed | boolean | true = the row is final; false = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with ?live=1 on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades. |
Essayer
GET https://api.bytnode.com/v1/cvd/history?timeframe=1h&limit=3&symbol=BTCUSDT
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/cvd/history?symbol=BTCUSDT&timeframe=1h&limit=3"{
"status": "ok",
"server_time": "2026-11-08T12:51:32.851Z",
"data_type": "cvd_history",
"symbol": "BTCUSDT",
"timeframe": "1h",
"market": "all",
"step": "1h",
"data": [
{
"time": "2026-11-08T11:00:00.000Z",
"cvd_series": [
76.67484796,
120.35567509,
116.00015045
],
"net_volume": 339.27976095,
"buy_volume": 2160.77349106,
"sell_volume": 1821.49373011,
"sample_count": 60,
"buy_sell_coverage_ratio": 1,
"is_volume_estimated": false,
"is_closed": true
},
{
"time": "2026-11-08T10:00:00.000Z",
"cvd_series": [
1.04801064,
15.45497456,
-3.88956999
],
"net_volume": -65.56413162,
"buy_volume": 1508.80409631,
"sell_volume": 1574.36822793,
"sample_count": 60,
"buy_sell_coverage_ratio": 1,
"is_volume_estimated": false,
"is_closed": true
},
{
"time": "2026-11-08T09:00:00.000Z",
"cvd_series": [
-0.41455736,
-76.26172923,
-9.28884403
],
"net_volume": -363.78282683,
"buy_volume": 1422.09755438,
"sell_volume": 1785.88038121,
"sample_count": 60,
"buy_sell_coverage_ratio": 1,
"is_volume_estimated": false,
"is_closed": true
}
],
"next": "/v1/cvd/history?symbol=BTCUSDT&timeframe=1h&limit=3&before_ms=1794128400000&order=desc"
}GET /v1/cvd/spot
Cumulative volume delta per bucket, spot only. Spot market only. Same as /v1/cvd, which serves every market.
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
timeframe obligatoire | string | — | Bucket size, required: 1m, 5m, 15m, 30m, 1h, 4h or 1d. Missing: 422 missing_parameter; other values: 422 invalid_timeframe with the accepted list. In any case (1H is 1h), except 1M: refused, since elsewhere it means a month and here 1m is one minute. |
live | boolean | false | 1 or true to return the CURRENT, still-open period computed on the fly (is_closed: false). Default: the last closed period only. |
symbol obligatoire | string | — | Trading pair, e.g. BTCUSDT. Required. The served pairs: GET /v1/symbols. Case-insensitive (btcusdt works; the envelope gives the canonical BTCUSDT). An unknown pair returns 422 invalid_symbol with the accepted list. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,net_volume. Unknown field: 422 unknown_field with a suggestion. |
9 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Start of the bucket the row covers: a 1h bucket at 14:00 covers 14:00:00 to 14:59:59.999. |
cvd_series | number[] | null | base asset quantity (BTC for BTCUSDT) | Cumulative volume delta inside the bucket, one point per step of finer candles (1 minute up to 1h, 5 minutes in 4h, 15 minutes in 1d), starting from 0 at the bucket start. null when those finer candles do not cover the bucket (before 2026-06-05; in 1d, before 2023-12; or a collection gap): buy_volume, sell_volume and net_volume then come from the bucket's own candle, as on /v1/trades-kline, and sample_count is 1. |
net_volume | number | null | base asset quantity (BTC for BTCUSDT) | buy_volume - sell_volume over the row, base asset units. Positive = net buying. |
buy_volume | number | null | base asset quantity (BTC for BTCUSDT) | Aggressive (taker) buy volume, base asset units, aggregated across venues. |
sell_volume | number | null | base asset quantity (BTC for BTCUSDT) | Aggressive (taker) sell volume, base asset units, aggregated across venues. |
sample_count | integer | null | count | Number of points in cvd_series; 1 when cvd_series is null (the bucket's candle alone). |
buy_sell_coverage_ratio | number | null | fraction (0.585 = 58.5 %) | Share of the volume (in USD) whose buy/sell split is known. 1 = every trade is split. Below 1 on part of the history, where some sources did not report the aggressor side: buy_volume and sell_volume then cover that share only, so buy_volume + sell_volume < volume; buy_ratio and the CVD describe the covered share. null when the bucket has no volume. |
is_volume_estimated | boolean | null | true when some base-asset quantities of this row were ESTIMATED from USD amounts (history where a source reported amounts but not quantities): a buy or sell amount is converted at that source's own average price when its total quantity is known, otherwise at the candle's typical price (high + low + close) / 3. Every quantity a source measured is kept as is. false = all measured. null when the volume itself is null (not available). | |
is_closed | boolean | true = the row is final; false = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with ?live=1 on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades. |
Essayer
GET https://api.bytnode.com/v1/cvd/spot?timeframe=1h&symbol=BTCUSDT
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/cvd/spot?symbol=BTCUSDT&timeframe=1h"{
"status": "ok",
"server_time": "2026-11-08T12:52:34.084Z",
"data_type": "cvd_spot",
"symbol": "BTCUSDT",
"timeframe": "1h",
"market": "spot",
"data": {
"time": "2026-11-08T11:00:00.000Z",
"cvd_series": [
9.39411796,
10.68782509,
7.18019045
],
"net_volume": 133.51317095,
"buy_volume": 329.14685106,
"sell_volume": 195.63368011,
"sample_count": 60,
"buy_sell_coverage_ratio": 1,
"is_volume_estimated": false,
"is_closed": true
}
}GET /v1/cvd/spot/history
Cumulative volume delta history, spot only. Spot market only. Same as /v1/cvd/history, which serves every market.
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
timeframe obligatoire | string | — | Bucket size, required: 1m, 5m, 15m, 30m, 1h, 4h or 1d. Missing: 422 missing_parameter; other values: 422 invalid_timeframe with the accepted list. In any case (1H is 1h), except 1M: refused, since elsewhere it means a month and here 1m is one minute. |
since_ms | integer | — | Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range. |
until_ms | integer | — | Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next. |
limit | integer · 1–1000 | 100 | Number of rows to return, in the reading order (most recent first by default). Bounded by your plan's history window: an explicit limit (or since_ms) reaching beyond it returns 403 history_depth; without them the page simply stops at the window. |
symbol obligatoire | string | — | Trading pair, e.g. BTCUSDT. Required. The served pairs: GET /v1/symbols. Case-insensitive (btcusdt works; the envelope gives the canonical BTCUSDT). An unknown pair returns 422 invalid_symbol with the accepted list. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,net_volume. Unknown field: 422 unknown_field with a suggestion. |
before_ms | integer | — | Upper time bound, EXCLUSIVE, in epoch milliseconds: rows strictly before it. Pass the oldest time you received to read the previous page without repeating a row. Not combinable with until_ms (422 invalid_time_range). |
order | string | desc | Reading order: desc (most recent first, the default) or asc (oldest first, reading forward from since_ms, which is then required). Follow next to read the following page. |
9 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
[].time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Start of the bucket the row covers: a 1h bucket at 14:00 covers 14:00:00 to 14:59:59.999. |
[].cvd_series | number[] | null | base asset quantity (BTC for BTCUSDT) | Cumulative volume delta inside the bucket, one point per step of finer candles (1 minute up to 1h, 5 minutes in 4h, 15 minutes in 1d), starting from 0 at the bucket start. null when those finer candles do not cover the bucket (before 2026-06-05; in 1d, before 2023-12; or a collection gap): buy_volume, sell_volume and net_volume then come from the bucket's own candle, as on /v1/trades-kline, and sample_count is 1. |
[].net_volume | number | null | base asset quantity (BTC for BTCUSDT) | buy_volume - sell_volume over the row, base asset units. Positive = net buying. |
[].buy_volume | number | null | base asset quantity (BTC for BTCUSDT) | Aggressive (taker) buy volume, base asset units, aggregated across venues. |
[].sell_volume | number | null | base asset quantity (BTC for BTCUSDT) | Aggressive (taker) sell volume, base asset units, aggregated across venues. |
[].sample_count | integer | null | count | Number of points in cvd_series; 1 when cvd_series is null (the bucket's candle alone). |
[].buy_sell_coverage_ratio | number | null | fraction (0.585 = 58.5 %) | Share of the volume (in USD) whose buy/sell split is known. 1 = every trade is split. Below 1 on part of the history, where some sources did not report the aggressor side: buy_volume and sell_volume then cover that share only, so buy_volume + sell_volume < volume; buy_ratio and the CVD describe the covered share. null when the bucket has no volume. |
[].is_volume_estimated | boolean | null | true when some base-asset quantities of this row were ESTIMATED from USD amounts (history where a source reported amounts but not quantities): a buy or sell amount is converted at that source's own average price when its total quantity is known, otherwise at the candle's typical price (high + low + close) / 3. Every quantity a source measured is kept as is. false = all measured. null when the volume itself is null (not available). | |
[].is_closed | boolean | true = the row is final; false = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with ?live=1 on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades. |
Essayer
GET https://api.bytnode.com/v1/cvd/spot/history?timeframe=1h&limit=3&symbol=BTCUSDT
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/cvd/spot/history?symbol=BTCUSDT&timeframe=1h&limit=3"{
"status": "ok",
"server_time": "2026-11-08T12:52:35.172Z",
"data_type": "cvd_spot_history",
"symbol": "BTCUSDT",
"timeframe": "1h",
"market": "spot",
"step": "1h",
"data": [
{
"time": "2026-11-08T11:00:00.000Z",
"cvd_series": [
9.39411796,
10.68782509,
7.18019045
],
"net_volume": 133.51317095,
"buy_volume": 329.14685106,
"sell_volume": 195.63368011,
"sample_count": 60,
"buy_sell_coverage_ratio": 1,
"is_volume_estimated": false,
"is_closed": true
},
{
"time": "2026-11-08T10:00:00.000Z",
"cvd_series": [
0.02481064,
1.20783456,
-0.70315999
],
"net_volume": 24.41136838,
"buy_volume": 330.91496631,
"sell_volume": 306.50359793,
"sample_count": 60,
"buy_sell_coverage_ratio": 1,
"is_volume_estimated": false,
"is_closed": true
},
{
"time": "2026-11-08T09:00:00.000Z",
"cvd_series": [
0.35164264,
-22.15373923,
-14.11545403
],
"net_volume": -55.13683683,
"buy_volume": 357.46647438,
"sell_volume": 412.60331121,
"sample_count": 60,
"buy_sell_coverage_ratio": 1,
"is_volume_estimated": false,
"is_closed": true
}
],
"next": "/v1/cvd/spot/history?symbol=BTCUSDT&timeframe=1h&limit=3&before_ms=1794128400000&order=desc"
}GET /v1/orderbook
Order book depth by price range, per bucket. Liquidity resting within ±0.25 to ±10 % of the mid price (eight ranges), bids and asks, in coins and USD, summed across venues, for the latest CLOSED bucket of timeframe (required; 1m = the latest closed minute). The value of a bucket is the book as it stood at the END of the bucket (a snapshot, not an average); time is the start of the bucket. No suffix: spot and perpetual futures books summed; /v1/orderbook/spot and /v1/orderbook/futures: one market. Every row is final (is_closed: true): there is no open period to return, so live is not accepted.
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
timeframe obligatoire | string | — | Bucket size, required: 1m, 5m, 15m, 30m, 1h, 4h or 1d. Missing: 422 missing_parameter; other values: 422 invalid_timeframe with the accepted list. In any case (1H is 1h), except 1M: refused, since elsewhere it means a month and here 1m is one minute. |
symbol obligatoire | string | — | Trading pair, e.g. BTCUSDT. Required. The served pairs: GET /v1/symbols. Case-insensitive (btcusdt works; the envelope gives the canonical BTCUSDT). An unknown pair returns 422 invalid_symbol with the accepted list. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,is_closed. Unknown field: 422 unknown_field with a suggestion. |
9 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Start of the bucket; the depth is the photo of the order book at the END of the bucket. |
is_closed | boolean | true = the row is final; false = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with ?live=1 on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades. | |
ranges | object[] | One entry per price range around the mid price, from the tightest (±0.25 %) to the widest (±10 %). Each range is cumulative: ±1 % includes everything inside ±0.5 %. | |
ranges[].range_pct | number | percent (58.5 = 58.5 %) | Half-width of the range around each venue's mid price ((best bid + best ask) / 2): 1.0 = bids down to -1 % and asks up to +1 %. |
ranges[].bids_quantity | number | null | base asset quantity (BTC for BTCUSDT) | Resting BUY orders inside the range (price >= mid × (1 - range_pct/100)), summed across venues. null = no venue publishes its book that deep. |
ranges[].asks_quantity | number | null | base asset quantity (BTC for BTCUSDT) | Resting SELL orders inside the range (price <= mid × (1 + range_pct/100)), summed across venues. null = not measured. |
ranges[].bids_usd | number | USD | USD value (Σ price × quantity) of the buy orders inside the range. |
ranges[].asks_usd | number | USD | USD value (Σ price × quantity) of the sell orders inside the range. |
ranges[].imbalance_ratio | number | null | fraction from -1 to 1 | (bids_usd - asks_usd) / (bids_usd + asks_usd). Positive = more bids than asks. null when one side is not measured. |
Essayer
GET https://api.bytnode.com/v1/orderbook?timeframe=1h&symbol=BTCUSDT
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/orderbook?symbol=BTCUSDT&timeframe=1h"{
"status": "ok",
"server_time": "2026-11-08T12:51:33.398Z",
"data_type": "orderbook",
"symbol": "BTCUSDT",
"timeframe": "1h",
"market": "all",
"data": {
"time": "2026-11-08T11:00:00.000Z",
"is_closed": true,
"ranges": [
{
"range_pct": 0.25,
"bids_quantity": 3288.02098415,
"asks_quantity": 3681.09429588,
"bids_usd": 249438129.609,
"asks_usd": 279881515.199,
"imbalance_ratio": -0.0575141804917
},
{
"range_pct": 0.5,
"bids_quantity": 4406.41287953,
"asks_quantity": 4937.81380599,
"bids_usd": 334075167.289,
"asks_usd": 375683358.8,
"imbalance_ratio": -0.0586230245665
},
{
"range_pct": 0.75,
"bids_quantity": 5220.72183647,
"asks_quantity": 5672.74224279,
"bids_usd": 395538737.423,
"asks_usd": 431850975.935,
"imbalance_ratio": -0.0438877084463
}
]
}
}GET /v1/orderbook/futures
Order book depth by price range, per bucket, perpetual futures only. Perpetual futures market only. Same as /v1/orderbook, which serves every market.
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
timeframe obligatoire | string | — | Bucket size, required: 1m, 5m, 15m, 30m, 1h, 4h or 1d. Missing: 422 missing_parameter; other values: 422 invalid_timeframe with the accepted list. In any case (1H is 1h), except 1M: refused, since elsewhere it means a month and here 1m is one minute. |
symbol obligatoire | string | — | Trading pair, e.g. BTCUSDT. Required. The served pairs: GET /v1/symbols. Case-insensitive (btcusdt works; the envelope gives the canonical BTCUSDT). An unknown pair returns 422 invalid_symbol with the accepted list. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,is_closed. Unknown field: 422 unknown_field with a suggestion. |
9 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Start of the bucket; the depth is the photo of the order book at the END of the bucket. |
is_closed | boolean | true = the row is final; false = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with ?live=1 on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades. | |
ranges | object[] | One entry per price range around the mid price, from the tightest (±0.25 %) to the widest (±10 %). Each range is cumulative: ±1 % includes everything inside ±0.5 %. | |
ranges[].range_pct | number | percent (58.5 = 58.5 %) | Half-width of the range around each venue's mid price ((best bid + best ask) / 2): 1.0 = bids down to -1 % and asks up to +1 %. |
ranges[].bids_quantity | number | null | base asset quantity (BTC for BTCUSDT) | Resting BUY orders inside the range (price >= mid × (1 - range_pct/100)), summed across venues. null = no venue publishes its book that deep. |
ranges[].asks_quantity | number | null | base asset quantity (BTC for BTCUSDT) | Resting SELL orders inside the range (price <= mid × (1 + range_pct/100)), summed across venues. null = not measured. |
ranges[].bids_usd | number | USD | USD value (Σ price × quantity) of the buy orders inside the range. |
ranges[].asks_usd | number | USD | USD value (Σ price × quantity) of the sell orders inside the range. |
ranges[].imbalance_ratio | number | null | fraction from -1 to 1 | (bids_usd - asks_usd) / (bids_usd + asks_usd). Positive = more bids than asks. null when one side is not measured. |
Essayer
GET https://api.bytnode.com/v1/orderbook/futures?timeframe=1h&symbol=BTCUSDT
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/orderbook/futures?symbol=BTCUSDT&timeframe=1h"{
"status": "ok",
"server_time": "2026-11-08T12:52:43.304Z",
"data_type": "orderbook_futures",
"symbol": "BTCUSDT",
"timeframe": "1h",
"market": "futures",
"data": {
"time": "2026-11-08T11:00:00.000Z",
"is_closed": true,
"ranges": [
{
"range_pct": 0.25,
"bids_quantity": 2776.7397,
"asks_quantity": 3192.7682,
"bids_usd": 210641348.785,
"asks_usd": 242735712.452,
"imbalance_ratio": -0.0707895621802
},
{
"range_pct": 0.5,
"bids_quantity": 3717.916,
"asks_quantity": 4215.8214,
"bids_usd": 281863426.608,
"asks_usd": 320718288.896,
"imbalance_ratio": -0.0644806526457
},
{
"range_pct": 0.75,
"bids_quantity": 4435.2177,
"asks_quantity": 4875.7346,
"bids_usd": 336001953.289,
"asks_usd": 371151372.022,
"imbalance_ratio": -0.0497055128996
}
]
}
}GET /v1/orderbook/futures/history
Order book depth by price range, history, perpetual futures only. Perpetual futures market only. Same as /v1/orderbook/history, which serves every market.
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
timeframe obligatoire | string | — | Bucket size, required: 1m, 5m, 15m, 30m, 1h, 4h or 1d. Missing: 422 missing_parameter; other values: 422 invalid_timeframe with the accepted list. In any case (1H is 1h), except 1M: refused, since elsewhere it means a month and here 1m is one minute. |
since_ms | integer | — | Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range. |
until_ms | integer | — | Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next. |
limit | integer · 1–1000 | 100 | Number of rows to return, in the reading order (most recent first by default). Bounded by your plan's history window: an explicit limit (or since_ms) reaching beyond it returns 403 history_depth; without them the page simply stops at the window. |
symbol obligatoire | string | — | Trading pair, e.g. BTCUSDT. Required. The served pairs: GET /v1/symbols. Case-insensitive (btcusdt works; the envelope gives the canonical BTCUSDT). An unknown pair returns 422 invalid_symbol with the accepted list. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,is_closed. Unknown field: 422 unknown_field with a suggestion. |
before_ms | integer | — | Upper time bound, EXCLUSIVE, in epoch milliseconds: rows strictly before it. Pass the oldest time you received to read the previous page without repeating a row. Not combinable with until_ms (422 invalid_time_range). |
order | string | desc | Reading order: desc (most recent first, the default) or asc (oldest first, reading forward from since_ms, which is then required). Follow next to read the following page. |
9 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
[].time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Start of the bucket; the depth is the photo of the order book at the END of the bucket. |
[].is_closed | boolean | true = the row is final; false = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with ?live=1 on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades. | |
[].ranges | object[] | One entry per price range around the mid price, from the tightest (±0.25 %) to the widest (±10 %). Each range is cumulative: ±1 % includes everything inside ±0.5 %. | |
[].ranges[].range_pct | number | percent (58.5 = 58.5 %) | Half-width of the range around each venue's mid price ((best bid + best ask) / 2): 1.0 = bids down to -1 % and asks up to +1 %. |
[].ranges[].bids_quantity | number | null | base asset quantity (BTC for BTCUSDT) | Resting BUY orders inside the range (price >= mid × (1 - range_pct/100)), summed across venues. null = no venue publishes its book that deep. |
[].ranges[].asks_quantity | number | null | base asset quantity (BTC for BTCUSDT) | Resting SELL orders inside the range (price <= mid × (1 + range_pct/100)), summed across venues. null = not measured. |
[].ranges[].bids_usd | number | USD | USD value (Σ price × quantity) of the buy orders inside the range. |
[].ranges[].asks_usd | number | USD | USD value (Σ price × quantity) of the sell orders inside the range. |
[].ranges[].imbalance_ratio | number | null | fraction from -1 to 1 | (bids_usd - asks_usd) / (bids_usd + asks_usd). Positive = more bids than asks. null when one side is not measured. |
Essayer
GET https://api.bytnode.com/v1/orderbook/futures/history?timeframe=1h&limit=3&symbol=BTCUSDT
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/orderbook/futures/history?symbol=BTCUSDT&timeframe=1h&limit=3"{
"status": "ok",
"server_time": "2026-11-08T12:52:44.397Z",
"data_type": "orderbook_futures_history",
"symbol": "BTCUSDT",
"timeframe": "1h",
"market": "futures",
"step": "1h",
"data": [
{
"time": "2026-11-08T11:00:00.000Z",
"is_closed": true,
"ranges": [
{
"range_pct": 0.25,
"bids_quantity": 2776.7397,
"asks_quantity": 3192.7682,
"bids_usd": 210641348.785,
"asks_usd": 242735712.452,
"imbalance_ratio": -0.0707895621802
},
{
"range_pct": 0.5,
"bids_quantity": 3717.916,
"asks_quantity": 4215.8214,
"bids_usd": 281863426.608,
"asks_usd": 320718288.896,
"imbalance_ratio": -0.0644806526457
},
{
"range_pct": 0.75,
"bids_quantity": 4435.2177,
"asks_quantity": 4875.7346,
"bids_usd": 336001953.289,
"asks_usd": 371151372.022,
"imbalance_ratio": -0.0497055128996
}
]
},
{
"time": "2026-11-08T10:00:00.000Z",
"is_closed": true,
"ranges": [
{
"range_pct": 0.25,
"bids_quantity": 2925.3089,
"asks_quantity": 2867.4057,
"bids_usd": 221671877.609,
"asks_usd": 217767558.919,
"imbalance_ratio": 0.00888477083566
},
{
"range_pct": 0.5,
"bids_quantity": 3899.4933,
"asks_quantity": 4105.4268,
"bids_usd": 295299948.203,
"asks_usd": 312009288.013,
"imbalance_ratio": -0.0275137258153
},
{
"range_pct": 0.75,
"bids_quantity": 4611.0328,
"asks_quantity": 4787.3947,
"bids_usd": 348930541.354,
"asks_usd": 364062571.402,
"imbalance_ratio": -0.0212232485516
}
]
},
{
"time": "2026-11-08T09:00:00.000Z",
"is_closed": true,
"ranges": [
{
"range_pct": 0.25,
"bids_quantity": 2650.2015,
"asks_quantity": 3021.0781,
"bids_usd": 200927342.308,
"asks_usd": 229552155.757,
"imbalance_ratio": -0.0664951840399
},
{
"range_pct": 0.5,
"bids_quantity": 3643.3951,
"asks_quantity": 4082.6751,
"bids_usd": 276041425.652,
"asks_usd": 310417164.95,
"imbalance_ratio": -0.0586157997337
},
{
"range_pct": 0.75,
"bids_quantity": 4325.8369,
"asks_quantity": 4695.5904,
"bids_usd": 327521416.495,
"asks_usd": 357221306.01,
"imbalance_ratio": -0.0433737935998
}
]
}
],
"next": "/v1/orderbook/futures/history?symbol=BTCUSDT&timeframe=1h&limit=3&before_ms=1794128400000&order=desc"
}GET /v1/orderbook/history
Order book depth by price range, history. Same as /v1/orderbook, one row per closed bucket; timeframe is required. since_ms / until_ms apply to the start of the bucket. Most recent first, or oldest first with order=asc. Follow next to read the following page (it never repeats a row).
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
timeframe obligatoire | string | — | Bucket size, required: 1m, 5m, 15m, 30m, 1h, 4h or 1d. Missing: 422 missing_parameter; other values: 422 invalid_timeframe with the accepted list. In any case (1H is 1h), except 1M: refused, since elsewhere it means a month and here 1m is one minute. |
since_ms | integer | — | Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range. |
until_ms | integer | — | Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next. |
limit | integer · 1–1000 | 100 | Number of rows to return, in the reading order (most recent first by default). Bounded by your plan's history window: an explicit limit (or since_ms) reaching beyond it returns 403 history_depth; without them the page simply stops at the window. |
symbol obligatoire | string | — | Trading pair, e.g. BTCUSDT. Required. The served pairs: GET /v1/symbols. Case-insensitive (btcusdt works; the envelope gives the canonical BTCUSDT). An unknown pair returns 422 invalid_symbol with the accepted list. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,is_closed. Unknown field: 422 unknown_field with a suggestion. |
before_ms | integer | — | Upper time bound, EXCLUSIVE, in epoch milliseconds: rows strictly before it. Pass the oldest time you received to read the previous page without repeating a row. Not combinable with until_ms (422 invalid_time_range). |
order | string | desc | Reading order: desc (most recent first, the default) or asc (oldest first, reading forward from since_ms, which is then required). Follow next to read the following page. |
9 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
[].time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Start of the bucket; the depth is the photo of the order book at the END of the bucket. |
[].is_closed | boolean | true = the row is final; false = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with ?live=1 on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades. | |
[].ranges | object[] | One entry per price range around the mid price, from the tightest (±0.25 %) to the widest (±10 %). Each range is cumulative: ±1 % includes everything inside ±0.5 %. | |
[].ranges[].range_pct | number | percent (58.5 = 58.5 %) | Half-width of the range around each venue's mid price ((best bid + best ask) / 2): 1.0 = bids down to -1 % and asks up to +1 %. |
[].ranges[].bids_quantity | number | null | base asset quantity (BTC for BTCUSDT) | Resting BUY orders inside the range (price >= mid × (1 - range_pct/100)), summed across venues. null = no venue publishes its book that deep. |
[].ranges[].asks_quantity | number | null | base asset quantity (BTC for BTCUSDT) | Resting SELL orders inside the range (price <= mid × (1 + range_pct/100)), summed across venues. null = not measured. |
[].ranges[].bids_usd | number | USD | USD value (Σ price × quantity) of the buy orders inside the range. |
[].ranges[].asks_usd | number | USD | USD value (Σ price × quantity) of the sell orders inside the range. |
[].ranges[].imbalance_ratio | number | null | fraction from -1 to 1 | (bids_usd - asks_usd) / (bids_usd + asks_usd). Positive = more bids than asks. null when one side is not measured. |
Essayer
GET https://api.bytnode.com/v1/orderbook/history?timeframe=1h&limit=3&symbol=BTCUSDT
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/orderbook/history?symbol=BTCUSDT&timeframe=1h&limit=3"{
"status": "ok",
"server_time": "2026-11-08T12:51:33.983Z",
"data_type": "orderbook_history",
"symbol": "BTCUSDT",
"timeframe": "1h",
"market": "all",
"step": "1h",
"data": [
{
"time": "2026-11-08T11:00:00.000Z",
"is_closed": true,
"ranges": [
{
"range_pct": 0.25,
"bids_quantity": 3288.02098415,
"asks_quantity": 3681.09429588,
"bids_usd": 249438129.609,
"asks_usd": 279881515.199,
"imbalance_ratio": -0.0575141804917
},
{
"range_pct": 0.5,
"bids_quantity": 4406.41287953,
"asks_quantity": 4937.81380599,
"bids_usd": 334075167.289,
"asks_usd": 375683358.8,
"imbalance_ratio": -0.0586230245665
},
{
"range_pct": 0.75,
"bids_quantity": 5220.72183647,
"asks_quantity": 5672.74224279,
"bids_usd": 395538737.423,
"asks_usd": 431850975.935,
"imbalance_ratio": -0.0438877084463
}
]
},
{
"time": "2026-11-08T10:00:00.000Z",
"is_closed": true,
"ranges": [
{
"range_pct": 0.25,
"bids_quantity": 3399.18640262,
"asks_quantity": 3361.25463657,
"bids_usd": 257594690.558,
"asks_usd": 255292996.385,
"imbalance_ratio": 0.00448771579167
},
{
"range_pct": 0.5,
"bids_quantity": 4582.72762673,
"asks_quantity": 4826.16905662,
"bids_usd": 347053609.992,
"asks_usd": 366821076.134,
"imbalance_ratio": -0.0276903867381
},
{
"range_pct": 0.75,
"bids_quantity": 5387.10105351,
"asks_quantity": 5575.39600077,
"bids_usd": 407689998.796,
"asks_usd": 424009911.429,
"imbalance_ratio": -0.019622357093
}
]
},
{
"time": "2026-11-08T09:00:00.000Z",
"is_closed": true,
"ranges": [
{
"range_pct": 0.25,
"bids_quantity": 3175.56337698,
"asks_quantity": 3542.86811988,
"bids_usd": 240769237.659,
"asks_usd": 269216031.345,
"imbalance_ratio": -0.0557796379914
},
{
"range_pct": 0.5,
"bids_quantity": 4349.49762544,
"asks_quantity": 4808.27567706,
"bids_usd": 329556002.29,
"asks_usd": 365614849.941,
"imbalance_ratio": -0.0518704826803
},
{
"range_pct": 0.75,
"bids_quantity": 5135.66209623,
"asks_quantity": 5509.3206173,
"bids_usd": 388865048.387,
"asks_usd": 419151641.766,
"imbalance_ratio": -0.0374826334015
}
]
}
],
"next": "/v1/orderbook/history?symbol=BTCUSDT&timeframe=1h&limit=3&before_ms=1794128400000&order=desc"
}GET /v1/orderbook/spot
Order book depth by price range, per bucket, spot only. Spot market only. Same as /v1/orderbook, which serves every market.
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
timeframe obligatoire | string | — | Bucket size, required: 1m, 5m, 15m, 30m, 1h, 4h or 1d. Missing: 422 missing_parameter; other values: 422 invalid_timeframe with the accepted list. In any case (1H is 1h), except 1M: refused, since elsewhere it means a month and here 1m is one minute. |
symbol obligatoire | string | — | Trading pair, e.g. BTCUSDT. Required. The served pairs: GET /v1/symbols. Case-insensitive (btcusdt works; the envelope gives the canonical BTCUSDT). An unknown pair returns 422 invalid_symbol with the accepted list. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,is_closed. Unknown field: 422 unknown_field with a suggestion. |
9 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Start of the bucket; the depth is the photo of the order book at the END of the bucket. |
is_closed | boolean | true = the row is final; false = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with ?live=1 on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades. | |
ranges | object[] | One entry per price range around the mid price, from the tightest (±0.25 %) to the widest (±10 %). Each range is cumulative: ±1 % includes everything inside ±0.5 %. | |
ranges[].range_pct | number | percent (58.5 = 58.5 %) | Half-width of the range around each venue's mid price ((best bid + best ask) / 2): 1.0 = bids down to -1 % and asks up to +1 %. |
ranges[].bids_quantity | number | null | base asset quantity (BTC for BTCUSDT) | Resting BUY orders inside the range (price >= mid × (1 - range_pct/100)), summed across venues. null = no venue publishes its book that deep. |
ranges[].asks_quantity | number | null | base asset quantity (BTC for BTCUSDT) | Resting SELL orders inside the range (price <= mid × (1 + range_pct/100)), summed across venues. null = not measured. |
ranges[].bids_usd | number | USD | USD value (Σ price × quantity) of the buy orders inside the range. |
ranges[].asks_usd | number | USD | USD value (Σ price × quantity) of the sell orders inside the range. |
ranges[].imbalance_ratio | number | null | fraction from -1 to 1 | (bids_usd - asks_usd) / (bids_usd + asks_usd). Positive = more bids than asks. null when one side is not measured. |
Essayer
GET https://api.bytnode.com/v1/orderbook/spot?timeframe=1h&symbol=BTCUSDT
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/orderbook/spot?symbol=BTCUSDT&timeframe=1h"{
"status": "ok",
"server_time": "2026-11-08T12:52:42.783Z",
"data_type": "orderbook_spot",
"symbol": "BTCUSDT",
"timeframe": "1h",
"market": "spot",
"data": {
"time": "2026-11-08T11:00:00.000Z",
"is_closed": true,
"ranges": [
{
"range_pct": 0.25,
"bids_quantity": 511.28128415,
"asks_quantity": 488.32609588,
"bids_usd": 38796780.8248,
"asks_usd": 37145802.7466,
"imbalance_ratio": 0.0217398197499
},
{
"range_pct": 0.5,
"bids_quantity": 688.49687953,
"asks_quantity": 721.99240599,
"bids_usd": 52211740.6815,
"asks_usd": 54965069.9048,
"imbalance_ratio": -0.0256895984136
},
{
"range_pct": 0.75,
"bids_quantity": 785.50413647,
"asks_quantity": 797.00764279,
"bids_usd": 59536784.1346,
"asks_usd": 60699603.9126,
"imbalance_ratio": -0.00967111368665
}
]
}
}GET /v1/orderbook/spot/history
Order book depth by price range, history, spot only. Spot market only. Same as /v1/orderbook/history, which serves every market.
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
timeframe obligatoire | string | — | Bucket size, required: 1m, 5m, 15m, 30m, 1h, 4h or 1d. Missing: 422 missing_parameter; other values: 422 invalid_timeframe with the accepted list. In any case (1H is 1h), except 1M: refused, since elsewhere it means a month and here 1m is one minute. |
since_ms | integer | — | Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range. |
until_ms | integer | — | Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next. |
limit | integer · 1–1000 | 100 | Number of rows to return, in the reading order (most recent first by default). Bounded by your plan's history window: an explicit limit (or since_ms) reaching beyond it returns 403 history_depth; without them the page simply stops at the window. |
symbol obligatoire | string | — | Trading pair, e.g. BTCUSDT. Required. The served pairs: GET /v1/symbols. Case-insensitive (btcusdt works; the envelope gives the canonical BTCUSDT). An unknown pair returns 422 invalid_symbol with the accepted list. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,is_closed. Unknown field: 422 unknown_field with a suggestion. |
before_ms | integer | — | Upper time bound, EXCLUSIVE, in epoch milliseconds: rows strictly before it. Pass the oldest time you received to read the previous page without repeating a row. Not combinable with until_ms (422 invalid_time_range). |
order | string | desc | Reading order: desc (most recent first, the default) or asc (oldest first, reading forward from since_ms, which is then required). Follow next to read the following page. |
9 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
[].time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Start of the bucket; the depth is the photo of the order book at the END of the bucket. |
[].is_closed | boolean | true = the row is final; false = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with ?live=1 on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades. | |
[].ranges | object[] | One entry per price range around the mid price, from the tightest (±0.25 %) to the widest (±10 %). Each range is cumulative: ±1 % includes everything inside ±0.5 %. | |
[].ranges[].range_pct | number | percent (58.5 = 58.5 %) | Half-width of the range around each venue's mid price ((best bid + best ask) / 2): 1.0 = bids down to -1 % and asks up to +1 %. |
[].ranges[].bids_quantity | number | null | base asset quantity (BTC for BTCUSDT) | Resting BUY orders inside the range (price >= mid × (1 - range_pct/100)), summed across venues. null = no venue publishes its book that deep. |
[].ranges[].asks_quantity | number | null | base asset quantity (BTC for BTCUSDT) | Resting SELL orders inside the range (price <= mid × (1 + range_pct/100)), summed across venues. null = not measured. |
[].ranges[].bids_usd | number | USD | USD value (Σ price × quantity) of the buy orders inside the range. |
[].ranges[].asks_usd | number | USD | USD value (Σ price × quantity) of the sell orders inside the range. |
[].ranges[].imbalance_ratio | number | null | fraction from -1 to 1 | (bids_usd - asks_usd) / (bids_usd + asks_usd). Positive = more bids than asks. null when one side is not measured. |
Essayer
GET https://api.bytnode.com/v1/orderbook/spot/history?timeframe=1h&limit=3&symbol=BTCUSDT
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/orderbook/spot/history?symbol=BTCUSDT&timeframe=1h&limit=3"{
"status": "ok",
"server_time": "2026-11-08T12:52:43.860Z",
"data_type": "orderbook_spot_history",
"symbol": "BTCUSDT",
"timeframe": "1h",
"market": "spot",
"step": "1h",
"data": [
{
"time": "2026-11-08T11:00:00.000Z",
"is_closed": true,
"ranges": [
{
"range_pct": 0.25,
"bids_quantity": 511.28128415,
"asks_quantity": 488.32609588,
"bids_usd": 38796780.8248,
"asks_usd": 37145802.7466,
"imbalance_ratio": 0.0217398197499
},
{
"range_pct": 0.5,
"bids_quantity": 688.49687953,
"asks_quantity": 721.99240599,
"bids_usd": 52211740.6815,
"asks_usd": 54965069.9048,
"imbalance_ratio": -0.0256895984136
},
{
"range_pct": 0.75,
"bids_quantity": 785.50413647,
"asks_quantity": 797.00764279,
"bids_usd": 59536784.1346,
"asks_usd": 60699603.9126,
"imbalance_ratio": -0.00967111368665
}
]
},
{
"time": "2026-11-08T10:00:00.000Z",
"is_closed": true,
"ranges": [
{
"range_pct": 0.25,
"bids_quantity": 473.87750262,
"asks_quantity": 493.84893657,
"bids_usd": 35922812.9489,
"asks_usd": 37525437.4665,
"imbalance_ratio": -0.0218197779878
},
{
"range_pct": 0.5,
"bids_quantity": 683.23432673,
"asks_quantity": 720.74225662,
"bids_usd": 51753661.7897,
"asks_usd": 54811788.1207,
"imbalance_ratio": -0.028697165297
},
{
"range_pct": 0.75,
"bids_quantity": 776.06825351,
"asks_quantity": 788.00130077,
"bids_usd": 58759457.4422,
"asks_usd": 59947340.0272,
"imbalance_ratio": -0.0100068623731
}
]
},
{
"time": "2026-11-08T09:00:00.000Z",
"is_closed": true,
"ranges": [
{
"range_pct": 0.25,
"bids_quantity": 525.36187698,
"asks_quantity": 521.79001988,
"bids_usd": 39841895.351,
"asks_usd": 39663875.5877,
"imbalance_ratio": 0.00223907976936
},
{
"range_pct": 0.5,
"bids_quantity": 706.10252544,
"asks_quantity": 725.60057706,
"bids_usd": 53514576.6385,
"asks_usd": 55197684.9901,
"imbalance_ratio": -0.0154822310417
},
{
"range_pct": 0.75,
"bids_quantity": 809.82519623,
"asks_quantity": 813.7302173,
"bids_usd": 61343631.8922,
"asks_usd": 61930335.7566,
"imbalance_ratio": -0.00475934924163
}
]
}
],
"next": "/v1/orderbook/spot/history?symbol=BTCUSDT&timeframe=1h&limit=3&before_ms=1794128400000&order=desc"
}GET /v1/spread/interexchange
Inter-venue price spread. Each venue's premium versus the volume-weighted reference price over the bucket, and the widest gap between two venues. The only route that names venues. Bucketed: is_closed says whether the value is final. Add ?live=1 for the open period.
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
timeframe obligatoire | string | — | Bucket size, required: 1m, 5m, 15m, 30m, 1h, 4h or 1d. Missing: 422 missing_parameter; other values: 422 invalid_timeframe with the accepted list. In any case (1H is 1h), except 1M: refused, since elsewhere it means a month and here 1m is one minute. |
live | boolean | false | 1 or true to return the CURRENT, still-open period computed on the fly (is_closed: false). Default: the last closed period only. |
symbol obligatoire | string | — | Trading pair, e.g. BTCUSDT. Required. The served pairs: GET /v1/symbols. Case-insensitive (btcusdt works; the envelope gives the canonical BTCUSDT). An unknown pair returns 422 invalid_symbol with the accepted list. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,is_closed. Unknown field: 422 unknown_field with a suggestion. |
13 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Start of the bucket the row covers: a 1h bucket at 14:00 covers 14:00:00 to 14:59:59.999. |
is_closed | boolean | true = the row is final; false = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with ?live=1 on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades. | |
ref_price | number | quote currency (USDT for BTCUSDT) | Reference price: the volume-weighted average price across venues over the bucket. Not the latest trade price: that is the price of /v1/price-change, i.e. the close of /v1/klines?live=1. |
weighting | string | How venues are combined: oi (open-interest weighted) or volume (volume weighted). | |
max_spread_bps | number | basis points (1 bp = 0.01 %) | Gap between the highest and the lowest venue price, relative to ref_price. |
high_venue | string | Venue with the highest price over the bucket. | |
high_price | number | quote currency (USDT for BTCUSDT) | Its volume-weighted price over the bucket. |
low_venue | string | Venue with the lowest price over the bucket. | |
low_price | number | quote currency (USDT for BTCUSDT) | Its volume-weighted price over the bucket. |
venues | object[] | Per-venue prices and premiums ([{venue, price, premium_bps}]). | |
venues[].venue | string | Venue name (with the liquidations, the only data that names its venues). | |
venues[].price | number | quote currency (USDT for BTCUSDT) | Volume-weighted price of the venue over the bucket. |
venues[].premium_bps | number | basis points (1 bp = 0.01 %) | Venue price premium (positive) or discount (negative) versus ref_price. |
Essayer
GET https://api.bytnode.com/v1/spread/interexchange?timeframe=1h&symbol=BTCUSDT
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/spread/interexchange?symbol=BTCUSDT&timeframe=1h"{
"status": "ok",
"server_time": "2026-11-08T12:51:34.514Z",
"data_type": "spread_interexchange",
"symbol": "BTCUSDT",
"timeframe": "1h",
"market": "futures",
"data": {
"time": "2026-11-08T11:00:00.000Z",
"is_closed": true,
"ref_price": 75950.5278981,
"weighting": "volume",
"max_spread_bps": 5.34437632792,
"high_venue": "venue_a",
"high_price": 75982.1248593,
"low_venue": "venue_b",
"low_price": 75941.534039,
"venues": [
{
"venue": "venue_a",
"price": 75982.1248593,
"premium_bps": 4.16020296993
},
{
"venue": "venue_c",
"price": 75970.8085769,
"premium_bps": 2.67024856533
},
{
"venue": "venue_d",
"price": 75967.9680854,
"premium_bps": 2.29625622696
}
]
}
}GET /v1/spread/interexchange/history
Inter-venue spread history. Same as /v1/spread/interexchange, one row per closed bucket. Most recent first, or oldest first with order=asc. Follow next to read the following page (it never repeats a row).
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
timeframe obligatoire | string | — | Bucket size, required: 1m, 5m, 15m, 30m, 1h, 4h or 1d. Missing: 422 missing_parameter; other values: 422 invalid_timeframe with the accepted list. In any case (1H is 1h), except 1M: refused, since elsewhere it means a month and here 1m is one minute. |
since_ms | integer | — | Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range. |
until_ms | integer | — | Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next. |
limit | integer · 1–1000 | 100 | Number of rows to return, in the reading order (most recent first by default). Bounded by your plan's history window: an explicit limit (or since_ms) reaching beyond it returns 403 history_depth; without them the page simply stops at the window. |
symbol obligatoire | string | — | Trading pair, e.g. BTCUSDT. Required. The served pairs: GET /v1/symbols. Case-insensitive (btcusdt works; the envelope gives the canonical BTCUSDT). An unknown pair returns 422 invalid_symbol with the accepted list. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,is_closed. Unknown field: 422 unknown_field with a suggestion. |
before_ms | integer | — | Upper time bound, EXCLUSIVE, in epoch milliseconds: rows strictly before it. Pass the oldest time you received to read the previous page without repeating a row. Not combinable with until_ms (422 invalid_time_range). |
order | string | desc | Reading order: desc (most recent first, the default) or asc (oldest first, reading forward from since_ms, which is then required). Follow next to read the following page. |
13 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
[].time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Start of the bucket the row covers: a 1h bucket at 14:00 covers 14:00:00 to 14:59:59.999. |
[].is_closed | boolean | true = the row is final; false = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with ?live=1 on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades. | |
[].ref_price | number | quote currency (USDT for BTCUSDT) | Reference price: the volume-weighted average price across venues over the bucket. Not the latest trade price: that is the price of /v1/price-change, i.e. the close of /v1/klines?live=1. |
[].weighting | string | How venues are combined: oi (open-interest weighted) or volume (volume weighted). | |
[].max_spread_bps | number | basis points (1 bp = 0.01 %) | Gap between the highest and the lowest venue price, relative to ref_price. |
[].high_venue | string | Venue with the highest price over the bucket. | |
[].high_price | number | quote currency (USDT for BTCUSDT) | Its volume-weighted price over the bucket. |
[].low_venue | string | Venue with the lowest price over the bucket. | |
[].low_price | number | quote currency (USDT for BTCUSDT) | Its volume-weighted price over the bucket. |
[].venues | object[] | Per-venue prices and premiums ([{venue, price, premium_bps}]). | |
[].venues[].venue | string | Venue name (with the liquidations, the only data that names its venues). | |
[].venues[].price | number | quote currency (USDT for BTCUSDT) | Volume-weighted price of the venue over the bucket. |
[].venues[].premium_bps | number | basis points (1 bp = 0.01 %) | Venue price premium (positive) or discount (negative) versus ref_price. |
Essayer
GET https://api.bytnode.com/v1/spread/interexchange/history?timeframe=1h&limit=3&symbol=BTCUSDT
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/spread/interexchange/history?symbol=BTCUSDT&timeframe=1h&limit=3"{
"status": "ok",
"server_time": "2026-11-08T12:51:36.077Z",
"data_type": "spread_interexchange_history",
"symbol": "BTCUSDT",
"timeframe": "1h",
"market": "futures",
"step": "1h",
"data": [
{
"time": "2026-11-08T11:00:00.000Z",
"is_closed": true,
"ref_price": 75950.5278981,
"weighting": "volume",
"max_spread_bps": 5.34437632792,
"high_venue": "venue_a",
"high_price": 75982.1248593,
"low_venue": "venue_b",
"low_price": 75941.534039,
"venues": [
{
"venue": "venue_a",
"price": 75982.1248593,
"premium_bps": 4.16020296993
},
{
"venue": "venue_c",
"price": 75970.8085769,
"premium_bps": 2.67024856533
},
{
"venue": "venue_d",
"price": 75967.9680854,
"premium_bps": 2.29625622696
}
]
},
{
"time": "2026-11-08T10:00:00.000Z",
"is_closed": true,
"ref_price": 75846.5673372,
"weighting": "volume",
"max_spread_bps": 4.95987254335,
"high_venue": "venue_d",
"high_price": 75876.7194793,
"low_venue": "venue_e",
"low_price": 75839.1005486,
"venues": [
{
"venue": "venue_d",
"price": 75876.7194793,
"premium_bps": 3.97541288352
},
{
"venue": "venue_c",
"price": 75875.8821227,
"premium_bps": 3.86501150195
},
{
"venue": "venue_a",
"price": 75872.9560977,
"premium_bps": 3.47922937663
}
]
},
{
"time": "2026-11-08T09:00:00.000Z",
"is_closed": true,
"ref_price": 75884.915377,
"weighting": "volume",
"max_spread_bps": 5.03932395192,
"high_venue": "venue_a",
"high_price": 75917.1906238,
"low_venue": "venue_f",
"low_price": 75878.9497566,
"venues": [
{
"venue": "venue_a",
"price": 75917.1906238,
"premium_bps": 4.25318347396
},
{
"venue": "venue_c",
"price": 75914.6708924,
"premium_bps": 3.92113706824
},
{
"venue": "venue_d",
"price": 75898.6176024,
"premium_bps": 1.80565865997
}
]
}
],
"next": "/v1/spread/interexchange/history?symbol=BTCUSDT&timeframe=1h&limit=3&before_ms=1794128400000&order=desc"
}GET /v1/trades-kline
Trade candle, spot + futures combined. The trades of the latest closed bucket aggregated into a candle ("trades kline"): trade count, volume, buy/sell volume, net volume, average size and rate, all venues, spot and futures. Volumes are in BASE ASSET units (BTC for BTCUSDT). The individual trades are /v1/trades/spot and /v1/trades/futures. Bucketed: is_closed says whether the value is final. Add ?live=1 for the open period.
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
symbol obligatoire | string | — | Trading pair, e.g. BTCUSDT. Required. The served pairs: GET /v1/symbols. Case-insensitive (btcusdt works; the envelope gives the canonical BTCUSDT). An unknown pair returns 422 invalid_symbol with the accepted list. |
timeframe obligatoire | string | — | Bucket size, required: 1m, 5m, 15m, 30m, 1h, 4h or 1d. Missing: 422 missing_parameter; other values: 422 invalid_timeframe with the accepted list. In any case (1H is 1h), except 1M: refused, since elsewhere it means a month and here 1m is one minute. |
live | boolean | false | 1 or true to return the CURRENT, still-open period computed on the fly (is_closed: false). Default: the last closed period only. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,trade_count. Unknown field: 422 unknown_field with a suggestion. |
11 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Start of the bucket the row covers: a 1h bucket at 14:00 covers 14:00:00 to 14:59:59.999. |
trade_count | integer | null | count | Number of trades. null when the number is not known: history imported from an outside source carries the buy and sell volumes, not the trade count. |
avg_trade_size | number | null | base asset quantity (BTC for BTCUSDT) | Average trade size, base asset units (NOT dollars: multiply by the price for a notional). |
volume | number | null | base asset quantity (BTC for BTCUSDT) | Traded volume over the row, base asset units (BTC for BTCUSDT, NOT dollars), aggregated across venues, over the market(s) the route covers: spot + perpetual futures on /v1/klines and /v1/trades-kline, the path's market alone on a /spot or /futures route (a name without a market suffix covers every market of its route; volume_spot / volume_futures restrict). null when a market is not available (never a partial sum). |
buy_volume | number | null | base asset quantity (BTC for BTCUSDT) | Aggressive (taker) buy volume, base asset units, aggregated across venues. |
sell_volume | number | null | base asset quantity (BTC for BTCUSDT) | Aggressive (taker) sell volume, base asset units, aggregated across venues. |
net_volume | number | null | base asset quantity (BTC for BTCUSDT) | buy_volume - sell_volume over the row, base asset units. Positive = net buying. |
buy_sell_coverage_ratio | number | null | fraction (0.585 = 58.5 %) | Share of the volume (in USD) whose buy/sell split is known. 1 = every trade is split. Below 1 on part of the history, where some sources did not report the aggressor side: buy_volume and sell_volume then cover that share only, so buy_volume + sell_volume < volume; buy_ratio and the CVD describe the covered share. null when the bucket has no volume. |
trade_rate | number | null | trades per second | Average number of trades per second over the bucket. null when trade_count is. |
is_volume_estimated | boolean | null | true when some base-asset quantities of this row were ESTIMATED from USD amounts (history where a source reported amounts but not quantities): a buy or sell amount is converted at that source's own average price when its total quantity is known, otherwise at the candle's typical price (high + low + close) / 3. Every quantity a source measured is kept as is. false = all measured. null when the volume itself is null (not available). | |
is_closed | boolean | true = the row is final; false = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with ?live=1 on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades. |
Essayer
GET https://api.bytnode.com/v1/trades-kline?symbol=BTCUSDT&timeframe=1h
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/trades-kline?symbol=BTCUSDT&timeframe=1h"{
"status": "ok",
"server_time": "2026-11-08T12:51:24.582Z",
"data_type": "trades_kline",
"symbol": "BTCUSDT",
"timeframe": "1h",
"market": "all",
"data": {
"time": "2026-11-08T11:00:00.000Z",
"trade_count": 156658,
"avg_trade_size": 0.0254201331638,
"volume": 3982.26722117,
"buy_volume": 2160.77349106,
"sell_volume": 1821.49373011,
"net_volume": 339.27976095,
"buy_sell_coverage_ratio": 1,
"trade_rate": 43.5161111111,
"is_volume_estimated": false,
"is_closed": true
}
}GET /v1/trades-kline/futures
Trade candle, futures only. Same as /v1/trades-kline, perpetual futures only. Stablecoins have no futures: data: null with unavailable. Bucketed: is_closed says whether the value is final. Add ?live=1 for the open period.
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
symbol obligatoire | string | — | Trading pair, e.g. BTCUSDT. Required. The served pairs: GET /v1/symbols. Case-insensitive (btcusdt works; the envelope gives the canonical BTCUSDT). An unknown pair returns 422 invalid_symbol with the accepted list. |
timeframe obligatoire | string | — | Bucket size, required: 1m, 5m, 15m, 30m, 1h, 4h or 1d. Missing: 422 missing_parameter; other values: 422 invalid_timeframe with the accepted list. In any case (1H is 1h), except 1M: refused, since elsewhere it means a month and here 1m is one minute. |
live | boolean | false | 1 or true to return the CURRENT, still-open period computed on the fly (is_closed: false). Default: the last closed period only. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,trade_count. Unknown field: 422 unknown_field with a suggestion. |
11 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Start of the bucket the row covers: a 1h bucket at 14:00 covers 14:00:00 to 14:59:59.999. |
trade_count | integer | null | count | Number of trades. null when the number is not known: history imported from an outside source carries the buy and sell volumes, not the trade count. |
avg_trade_size | number | null | base asset quantity (BTC for BTCUSDT) | Average trade size, base asset units (NOT dollars: multiply by the price for a notional). |
volume | number | null | base asset quantity (BTC for BTCUSDT) | Traded volume over the row, base asset units (BTC for BTCUSDT, NOT dollars), aggregated across venues, over the market(s) the route covers: spot + perpetual futures on /v1/klines and /v1/trades-kline, the path's market alone on a /spot or /futures route (a name without a market suffix covers every market of its route; volume_spot / volume_futures restrict). null when a market is not available (never a partial sum). |
buy_volume | number | null | base asset quantity (BTC for BTCUSDT) | Aggressive (taker) buy volume, base asset units, aggregated across venues. |
sell_volume | number | null | base asset quantity (BTC for BTCUSDT) | Aggressive (taker) sell volume, base asset units, aggregated across venues. |
net_volume | number | null | base asset quantity (BTC for BTCUSDT) | buy_volume - sell_volume over the row, base asset units. Positive = net buying. |
buy_sell_coverage_ratio | number | null | fraction (0.585 = 58.5 %) | Share of the volume (in USD) whose buy/sell split is known. 1 = every trade is split. Below 1 on part of the history, where some sources did not report the aggressor side: buy_volume and sell_volume then cover that share only, so buy_volume + sell_volume < volume; buy_ratio and the CVD describe the covered share. null when the bucket has no volume. |
trade_rate | number | null | trades per second | Average number of trades per second over the bucket. null when trade_count is. |
is_volume_estimated | boolean | null | true when some base-asset quantities of this row were ESTIMATED from USD amounts (history where a source reported amounts but not quantities): a buy or sell amount is converted at that source's own average price when its total quantity is known, otherwise at the candle's typical price (high + low + close) / 3. Every quantity a source measured is kept as is. false = all measured. null when the volume itself is null (not available). | |
is_closed | boolean | true = the row is final; false = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with ?live=1 on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades. |
Essayer
GET https://api.bytnode.com/v1/trades-kline/futures?symbol=BTCUSDT&timeframe=1h
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/trades-kline/futures?symbol=BTCUSDT&timeframe=1h"{
"status": "ok",
"server_time": "2026-11-08T12:51:27.559Z",
"data_type": "trades_kline_futures",
"symbol": "BTCUSDT",
"timeframe": "1h",
"market": "futures",
"data": {
"time": "2026-11-08T11:00:00.000Z",
"trade_count": 77834,
"avg_trade_size": 0.0444212900532,
"volume": 3457.48669,
"buy_volume": 1831.62664,
"sell_volume": 1625.86005,
"net_volume": 205.76659,
"buy_sell_coverage_ratio": 1,
"trade_rate": 21.6205555556,
"is_volume_estimated": false,
"is_closed": true
}
}GET /v1/trades-kline/futures/history
Trade candles history, futures only. Same as /v1/trades-kline/futures, one row per closed bucket. Most recent first, or oldest first with order=asc. Follow next to read the following page (it never repeats a row).
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
symbol obligatoire | string | — | Trading pair, e.g. BTCUSDT. Required. The served pairs: GET /v1/symbols. Case-insensitive (btcusdt works; the envelope gives the canonical BTCUSDT). An unknown pair returns 422 invalid_symbol with the accepted list. |
timeframe obligatoire | string | — | Bucket size, required: 1m, 5m, 15m, 30m, 1h, 4h or 1d. Missing: 422 missing_parameter; other values: 422 invalid_timeframe with the accepted list. In any case (1H is 1h), except 1M: refused, since elsewhere it means a month and here 1m is one minute. |
since_ms | integer | — | Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range. |
until_ms | integer | — | Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next. |
limit | integer · 1–1000 | 100 | Number of rows to return, in the reading order (most recent first by default). Bounded by your plan's history window: an explicit limit (or since_ms) reaching beyond it returns 403 history_depth; without them the page simply stops at the window. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,trade_count. Unknown field: 422 unknown_field with a suggestion. |
before_ms | integer | — | Upper time bound, EXCLUSIVE, in epoch milliseconds: rows strictly before it. Pass the oldest time you received to read the previous page without repeating a row. Not combinable with until_ms (422 invalid_time_range). |
order | string | desc | Reading order: desc (most recent first, the default) or asc (oldest first, reading forward from since_ms, which is then required). Follow next to read the following page. |
11 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
[].time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Start of the bucket the row covers: a 1h bucket at 14:00 covers 14:00:00 to 14:59:59.999. |
[].trade_count | integer | null | count | Number of trades. null when the number is not known: history imported from an outside source carries the buy and sell volumes, not the trade count. |
[].avg_trade_size | number | null | base asset quantity (BTC for BTCUSDT) | Average trade size, base asset units (NOT dollars: multiply by the price for a notional). |
[].volume | number | null | base asset quantity (BTC for BTCUSDT) | Traded volume over the row, base asset units (BTC for BTCUSDT, NOT dollars), aggregated across venues, over the market(s) the route covers: spot + perpetual futures on /v1/klines and /v1/trades-kline, the path's market alone on a /spot or /futures route (a name without a market suffix covers every market of its route; volume_spot / volume_futures restrict). null when a market is not available (never a partial sum). |
[].buy_volume | number | null | base asset quantity (BTC for BTCUSDT) | Aggressive (taker) buy volume, base asset units, aggregated across venues. |
[].sell_volume | number | null | base asset quantity (BTC for BTCUSDT) | Aggressive (taker) sell volume, base asset units, aggregated across venues. |
[].net_volume | number | null | base asset quantity (BTC for BTCUSDT) | buy_volume - sell_volume over the row, base asset units. Positive = net buying. |
[].buy_sell_coverage_ratio | number | null | fraction (0.585 = 58.5 %) | Share of the volume (in USD) whose buy/sell split is known. 1 = every trade is split. Below 1 on part of the history, where some sources did not report the aggressor side: buy_volume and sell_volume then cover that share only, so buy_volume + sell_volume < volume; buy_ratio and the CVD describe the covered share. null when the bucket has no volume. |
[].trade_rate | number | null | trades per second | Average number of trades per second over the bucket. null when trade_count is. |
[].is_volume_estimated | boolean | null | true when some base-asset quantities of this row were ESTIMATED from USD amounts (history where a source reported amounts but not quantities): a buy or sell amount is converted at that source's own average price when its total quantity is known, otherwise at the candle's typical price (high + low + close) / 3. Every quantity a source measured is kept as is. false = all measured. null when the volume itself is null (not available). | |
[].is_closed | boolean | true = the row is final; false = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with ?live=1 on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades. |
Essayer
GET https://api.bytnode.com/v1/trades-kline/futures/history?symbol=BTCUSDT&timeframe=1h&limit=3
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/trades-kline/futures/history?symbol=BTCUSDT&timeframe=1h&limit=3"{
"status": "ok",
"server_time": "2026-11-08T12:51:28.080Z",
"data_type": "trades_kline_futures_history",
"symbol": "BTCUSDT",
"timeframe": "1h",
"market": "futures",
"step": "1h",
"data": [
{
"time": "2026-11-08T11:00:00.000Z",
"trade_count": 77834,
"avg_trade_size": 0.0444212900532,
"volume": 3457.48669,
"buy_volume": 1831.62664,
"sell_volume": 1625.86005,
"net_volume": 205.76659,
"buy_sell_coverage_ratio": 1,
"trade_rate": 21.6205555556,
"is_volume_estimated": false,
"is_closed": true
},
{
"time": "2026-11-08T10:00:00.000Z",
"trade_count": 62682,
"avg_trade_size": 0.0390184384672,
"volume": 2445.75376,
"buy_volume": 1177.88913,
"sell_volume": 1267.86463,
"net_volume": -89.9755,
"buy_sell_coverage_ratio": 1,
"trade_rate": 17.4116666667,
"is_volume_estimated": false,
"is_closed": true
},
{
"time": "2026-11-08T09:00:00.000Z",
"trade_count": 64198,
"avg_trade_size": 0.0379748302128,
"volume": 2437.90815,
"buy_volume": 1064.63108,
"sell_volume": 1373.27707,
"net_volume": -308.64599,
"buy_sell_coverage_ratio": 1,
"trade_rate": 17.8327777778,
"is_volume_estimated": false,
"is_closed": true
}
],
"next": "/v1/trades-kline/futures/history?symbol=BTCUSDT&timeframe=1h&limit=3&before_ms=1794128400000&order=desc"
}GET /v1/trades-kline/futures/seconds
Trades aggregated per second. Every PERPETUAL FUTURES trade of every venue summed per second: volume, trade count, taker buy and sell, and is_closed (a second is final 21 s after it ends: a venue can still deliver a late trade before; a trade delivered later still is added afterwards, so the seconds of a minute always add up to its trades). Kept 72 hours. Without range parameters: the last limit seconds, and a full page carries next (the older seconds). With since_ms, until_ms or order: a page of limit seconds of the range, and next is the URL of the following page (null at the end of the range). Most recent first, or oldest first with order=asc. Follow next to read the following page (it never repeats a row).
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
limit | integer · 1–1000 | 100 | Number of seconds to return (one row per second with trades). In range reading, a page covers limit seconds of time. |
since_ms | integer | — | Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range. |
until_ms | integer | — | Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next. |
order | string | — | Range reading: desc (most recent first, the default) or asc. Giving order, since_ms or until_ms switches the route to range reading. Either way, a full page carries next (the following page, older trades without range parameters) and the last page next: null. |
symbol obligatoire | string | — | Trading pair, e.g. BTCUSDT. Required. The served pairs: GET /v1/symbols. Case-insensitive (btcusdt works; the envelope gives the canonical BTCUSDT). An unknown pair returns 422 invalid_symbol with the accepted list. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,volume. Unknown field: 422 unknown_field with a suggestion. |
before_ms | integer | — | Upper time bound, EXCLUSIVE, in epoch milliseconds: rows strictly before it. Pass the oldest time you received to read the previous page without repeating a row. Not combinable with until_ms (422 invalid_time_range). |
10 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
[].time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Start of the second the row covers. |
[].volume | number | null | base asset quantity (BTC for BTCUSDT) | Traded volume over the row, base asset units (BTC for BTCUSDT, NOT dollars), aggregated across venues, over the market(s) the route covers: spot + perpetual futures on /v1/klines and /v1/trades-kline, the path's market alone on a /spot or /futures route (a name without a market suffix covers every market of its route; volume_spot / volume_futures restrict). null when a market is not available (never a partial sum). |
[].trade_count | integer | null | count | Number of trades. null when the number is not known: history imported from an outside source carries the buy and sell volumes, not the trade count. |
[].buy_volume | number | null | base asset quantity (BTC for BTCUSDT) | Aggressive (taker) buy volume, base asset units, aggregated across venues. |
[].sell_volume | number | null | base asset quantity (BTC for BTCUSDT) | Aggressive (taker) sell volume, base asset units, aggregated across venues. |
[].is_closed | boolean | true = the row is final; false = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with ?live=1 on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades. | |
[].net_volume | number | null | base asset quantity (BTC for BTCUSDT) | buy_volume - sell_volume over the row, base asset units. Positive = net buying. |
[].avg_trade_size | number | null | base asset quantity (BTC for BTCUSDT) | Average trade size, base asset units (NOT dollars: multiply by the price for a notional). |
[].trade_rate | number | null | trades per second | Average number of trades per second over the bucket. null when trade_count is. |
[].is_volume_estimated | boolean | null | true when some base-asset quantities of this row were ESTIMATED from USD amounts (history where a source reported amounts but not quantities): a buy or sell amount is converted at that source's own average price when its total quantity is known, otherwise at the candle's typical price (high + low + close) / 3. Every quantity a source measured is kept as is. false = all measured. null when the volume itself is null (not available). |
Essayer
GET https://api.bytnode.com/v1/trades-kline/futures/seconds?limit=3&symbol=BTCUSDT
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/trades-kline/futures/seconds?symbol=BTCUSDT&limit=3"{
"status": "ok",
"server_time": "2026-11-08T12:51:19.872Z",
"data_type": "trades_kline_futures_seconds",
"symbol": "BTCUSDT",
"market": "futures",
"data": [
{
"time": "2026-11-08T12:50:58.000Z",
"volume": 16.34145,
"trade_count": 330,
"buy_volume": 16.29375,
"sell_volume": 0.0477,
"is_closed": true,
"net_volume": 16.24605,
"avg_trade_size": 0.0495195454545,
"trade_rate": 330,
"is_volume_estimated": false
},
{
"time": "2026-11-08T12:50:57.000Z",
"volume": 0.04436,
"trade_count": 7,
"buy_volume": 0.01646,
"sell_volume": 0.0279,
"is_closed": true,
"net_volume": -0.01144,
"avg_trade_size": 0.00633714285714,
"trade_rate": 7,
"is_volume_estimated": false
},
{
"time": "2026-11-08T12:50:56.000Z",
"volume": 0.0559,
"trade_count": 7,
"buy_volume": 0.0288,
"sell_volume": 0.0271,
"is_closed": true,
"net_volume": 0.0017,
"avg_trade_size": 0.00798571428571,
"trade_rate": 7,
"is_volume_estimated": false
}
],
"next": "/v1/trades-kline/futures/seconds?symbol=BTCUSDT&limit=3&before_ms=1794142256000&order=desc"
}GET /v1/trades-kline/history
Trade candles history, combined. Same as /v1/trades-kline, one row per closed bucket. Most recent first, or oldest first with order=asc. Follow next to read the following page (it never repeats a row).
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
symbol obligatoire | string | — | Trading pair, e.g. BTCUSDT. Required. The served pairs: GET /v1/symbols. Case-insensitive (btcusdt works; the envelope gives the canonical BTCUSDT). An unknown pair returns 422 invalid_symbol with the accepted list. |
timeframe obligatoire | string | — | Bucket size, required: 1m, 5m, 15m, 30m, 1h, 4h or 1d. Missing: 422 missing_parameter; other values: 422 invalid_timeframe with the accepted list. In any case (1H is 1h), except 1M: refused, since elsewhere it means a month and here 1m is one minute. |
since_ms | integer | — | Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range. |
until_ms | integer | — | Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next. |
limit | integer · 1–1000 | 100 | Number of rows to return, in the reading order (most recent first by default). Bounded by your plan's history window: an explicit limit (or since_ms) reaching beyond it returns 403 history_depth; without them the page simply stops at the window. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,trade_count. Unknown field: 422 unknown_field with a suggestion. |
before_ms | integer | — | Upper time bound, EXCLUSIVE, in epoch milliseconds: rows strictly before it. Pass the oldest time you received to read the previous page without repeating a row. Not combinable with until_ms (422 invalid_time_range). |
order | string | desc | Reading order: desc (most recent first, the default) or asc (oldest first, reading forward from since_ms, which is then required). Follow next to read the following page. |
11 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
[].time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Start of the bucket the row covers: a 1h bucket at 14:00 covers 14:00:00 to 14:59:59.999. |
[].trade_count | integer | null | count | Number of trades. null when the number is not known: history imported from an outside source carries the buy and sell volumes, not the trade count. |
[].avg_trade_size | number | null | base asset quantity (BTC for BTCUSDT) | Average trade size, base asset units (NOT dollars: multiply by the price for a notional). |
[].volume | number | null | base asset quantity (BTC for BTCUSDT) | Traded volume over the row, base asset units (BTC for BTCUSDT, NOT dollars), aggregated across venues, over the market(s) the route covers: spot + perpetual futures on /v1/klines and /v1/trades-kline, the path's market alone on a /spot or /futures route (a name without a market suffix covers every market of its route; volume_spot / volume_futures restrict). null when a market is not available (never a partial sum). |
[].buy_volume | number | null | base asset quantity (BTC for BTCUSDT) | Aggressive (taker) buy volume, base asset units, aggregated across venues. |
[].sell_volume | number | null | base asset quantity (BTC for BTCUSDT) | Aggressive (taker) sell volume, base asset units, aggregated across venues. |
[].net_volume | number | null | base asset quantity (BTC for BTCUSDT) | buy_volume - sell_volume over the row, base asset units. Positive = net buying. |
[].buy_sell_coverage_ratio | number | null | fraction (0.585 = 58.5 %) | Share of the volume (in USD) whose buy/sell split is known. 1 = every trade is split. Below 1 on part of the history, where some sources did not report the aggressor side: buy_volume and sell_volume then cover that share only, so buy_volume + sell_volume < volume; buy_ratio and the CVD describe the covered share. null when the bucket has no volume. |
[].trade_rate | number | null | trades per second | Average number of trades per second over the bucket. null when trade_count is. |
[].is_volume_estimated | boolean | null | true when some base-asset quantities of this row were ESTIMATED from USD amounts (history where a source reported amounts but not quantities): a buy or sell amount is converted at that source's own average price when its total quantity is known, otherwise at the candle's typical price (high + low + close) / 3. Every quantity a source measured is kept as is. false = all measured. null when the volume itself is null (not available). | |
[].is_closed | boolean | true = the row is final; false = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with ?live=1 on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades. |
Essayer
GET https://api.bytnode.com/v1/trades-kline/history?symbol=BTCUSDT&timeframe=1h&limit=3
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/trades-kline/history?symbol=BTCUSDT&timeframe=1h&limit=3"{
"status": "ok",
"server_time": "2026-11-08T12:51:25.906Z",
"data_type": "trades_kline_history",
"symbol": "BTCUSDT",
"timeframe": "1h",
"market": "all",
"step": "1h",
"data": [
{
"time": "2026-11-08T11:00:00.000Z",
"trade_count": 156658,
"avg_trade_size": 0.0254201331638,
"volume": 3982.26722117,
"buy_volume": 2160.77349106,
"sell_volume": 1821.49373011,
"net_volume": 339.27976095,
"buy_sell_coverage_ratio": 1,
"trade_rate": 43.5161111111,
"is_volume_estimated": false,
"is_closed": true
},
{
"time": "2026-11-08T10:00:00.000Z",
"trade_count": 132046,
"avg_trade_size": 0.0233492292401,
"volume": 3083.17232424,
"buy_volume": 1508.80409631,
"sell_volume": 1574.36822793,
"net_volume": -65.56413162,
"buy_sell_coverage_ratio": 1,
"trade_rate": 36.6794444444,
"is_volume_estimated": false,
"is_closed": true
},
{
"time": "2026-11-08T09:00:00.000Z",
"trade_count": 134340,
"avg_trade_size": 0.02387954396,
"volume": 3207.97793559,
"buy_volume": 1422.09755438,
"sell_volume": 1785.88038121,
"net_volume": -363.78282683,
"buy_sell_coverage_ratio": 1,
"trade_rate": 37.3166666667,
"is_volume_estimated": false,
"is_closed": true
}
],
"next": "/v1/trades-kline/history?symbol=BTCUSDT&timeframe=1h&limit=3&before_ms=1794128400000&order=desc"
}GET /v1/trades-kline/spot
Trade candle, spot only. Same as /v1/trades-kline, spot venues only. Bucketed: is_closed says whether the value is final. Add ?live=1 for the open period.
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
symbol obligatoire | string | — | Trading pair, e.g. BTCUSDT. Required. The served pairs: GET /v1/symbols. Case-insensitive (btcusdt works; the envelope gives the canonical BTCUSDT). An unknown pair returns 422 invalid_symbol with the accepted list. |
timeframe obligatoire | string | — | Bucket size, required: 1m, 5m, 15m, 30m, 1h, 4h or 1d. Missing: 422 missing_parameter; other values: 422 invalid_timeframe with the accepted list. In any case (1H is 1h), except 1M: refused, since elsewhere it means a month and here 1m is one minute. |
live | boolean | false | 1 or true to return the CURRENT, still-open period computed on the fly (is_closed: false). Default: the last closed period only. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,trade_count. Unknown field: 422 unknown_field with a suggestion. |
11 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Start of the bucket the row covers: a 1h bucket at 14:00 covers 14:00:00 to 14:59:59.999. |
trade_count | integer | null | count | Number of trades. null when the number is not known: history imported from an outside source carries the buy and sell volumes, not the trade count. |
avg_trade_size | number | null | base asset quantity (BTC for BTCUSDT) | Average trade size, base asset units (NOT dollars: multiply by the price for a notional). |
volume | number | null | base asset quantity (BTC for BTCUSDT) | Traded volume over the row, base asset units (BTC for BTCUSDT, NOT dollars), aggregated across venues, over the market(s) the route covers: spot + perpetual futures on /v1/klines and /v1/trades-kline, the path's market alone on a /spot or /futures route (a name without a market suffix covers every market of its route; volume_spot / volume_futures restrict). null when a market is not available (never a partial sum). |
buy_volume | number | null | base asset quantity (BTC for BTCUSDT) | Aggressive (taker) buy volume, base asset units, aggregated across venues. |
sell_volume | number | null | base asset quantity (BTC for BTCUSDT) | Aggressive (taker) sell volume, base asset units, aggregated across venues. |
net_volume | number | null | base asset quantity (BTC for BTCUSDT) | buy_volume - sell_volume over the row, base asset units. Positive = net buying. |
buy_sell_coverage_ratio | number | null | fraction (0.585 = 58.5 %) | Share of the volume (in USD) whose buy/sell split is known. 1 = every trade is split. Below 1 on part of the history, where some sources did not report the aggressor side: buy_volume and sell_volume then cover that share only, so buy_volume + sell_volume < volume; buy_ratio and the CVD describe the covered share. null when the bucket has no volume. |
trade_rate | number | null | trades per second | Average number of trades per second over the bucket. null when trade_count is. |
is_volume_estimated | boolean | null | true when some base-asset quantities of this row were ESTIMATED from USD amounts (history where a source reported amounts but not quantities): a buy or sell amount is converted at that source's own average price when its total quantity is known, otherwise at the candle's typical price (high + low + close) / 3. Every quantity a source measured is kept as is. false = all measured. null when the volume itself is null (not available). | |
is_closed | boolean | true = the row is final; false = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with ?live=1 on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades. |
Essayer
GET https://api.bytnode.com/v1/trades-kline/spot?symbol=BTCUSDT&timeframe=1h
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/trades-kline/spot?symbol=BTCUSDT&timeframe=1h"{
"status": "ok",
"server_time": "2026-11-08T12:51:26.524Z",
"data_type": "trades_kline_spot",
"symbol": "BTCUSDT",
"timeframe": "1h",
"market": "spot",
"data": {
"time": "2026-11-08T11:00:00.000Z",
"trade_count": 78824,
"avg_trade_size": 0.00665762370813,
"volume": 524.78053117,
"buy_volume": 329.14685106,
"sell_volume": 195.63368011,
"net_volume": 133.51317095,
"buy_sell_coverage_ratio": 1,
"trade_rate": 21.8955555556,
"is_volume_estimated": false,
"is_closed": true
}
}GET /v1/trades-kline/spot/history
Trade candles history, spot only. Same as /v1/trades-kline/spot, one row per closed bucket. Most recent first, or oldest first with order=asc. Follow next to read the following page (it never repeats a row).
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
symbol obligatoire | string | — | Trading pair, e.g. BTCUSDT. Required. The served pairs: GET /v1/symbols. Case-insensitive (btcusdt works; the envelope gives the canonical BTCUSDT). An unknown pair returns 422 invalid_symbol with the accepted list. |
timeframe obligatoire | string | — | Bucket size, required: 1m, 5m, 15m, 30m, 1h, 4h or 1d. Missing: 422 missing_parameter; other values: 422 invalid_timeframe with the accepted list. In any case (1H is 1h), except 1M: refused, since elsewhere it means a month and here 1m is one minute. |
since_ms | integer | — | Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range. |
until_ms | integer | — | Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next. |
limit | integer · 1–1000 | 100 | Number of rows to return, in the reading order (most recent first by default). Bounded by your plan's history window: an explicit limit (or since_ms) reaching beyond it returns 403 history_depth; without them the page simply stops at the window. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,trade_count. Unknown field: 422 unknown_field with a suggestion. |
before_ms | integer | — | Upper time bound, EXCLUSIVE, in epoch milliseconds: rows strictly before it. Pass the oldest time you received to read the previous page without repeating a row. Not combinable with until_ms (422 invalid_time_range). |
order | string | desc | Reading order: desc (most recent first, the default) or asc (oldest first, reading forward from since_ms, which is then required). Follow next to read the following page. |
11 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
[].time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Start of the bucket the row covers: a 1h bucket at 14:00 covers 14:00:00 to 14:59:59.999. |
[].trade_count | integer | null | count | Number of trades. null when the number is not known: history imported from an outside source carries the buy and sell volumes, not the trade count. |
[].avg_trade_size | number | null | base asset quantity (BTC for BTCUSDT) | Average trade size, base asset units (NOT dollars: multiply by the price for a notional). |
[].volume | number | null | base asset quantity (BTC for BTCUSDT) | Traded volume over the row, base asset units (BTC for BTCUSDT, NOT dollars), aggregated across venues, over the market(s) the route covers: spot + perpetual futures on /v1/klines and /v1/trades-kline, the path's market alone on a /spot or /futures route (a name without a market suffix covers every market of its route; volume_spot / volume_futures restrict). null when a market is not available (never a partial sum). |
[].buy_volume | number | null | base asset quantity (BTC for BTCUSDT) | Aggressive (taker) buy volume, base asset units, aggregated across venues. |
[].sell_volume | number | null | base asset quantity (BTC for BTCUSDT) | Aggressive (taker) sell volume, base asset units, aggregated across venues. |
[].net_volume | number | null | base asset quantity (BTC for BTCUSDT) | buy_volume - sell_volume over the row, base asset units. Positive = net buying. |
[].buy_sell_coverage_ratio | number | null | fraction (0.585 = 58.5 %) | Share of the volume (in USD) whose buy/sell split is known. 1 = every trade is split. Below 1 on part of the history, where some sources did not report the aggressor side: buy_volume and sell_volume then cover that share only, so buy_volume + sell_volume < volume; buy_ratio and the CVD describe the covered share. null when the bucket has no volume. |
[].trade_rate | number | null | trades per second | Average number of trades per second over the bucket. null when trade_count is. |
[].is_volume_estimated | boolean | null | true when some base-asset quantities of this row were ESTIMATED from USD amounts (history where a source reported amounts but not quantities): a buy or sell amount is converted at that source's own average price when its total quantity is known, otherwise at the candle's typical price (high + low + close) / 3. Every quantity a source measured is kept as is. false = all measured. null when the volume itself is null (not available). | |
[].is_closed | boolean | true = the row is final; false = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with ?live=1 on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades. |
Essayer
GET https://api.bytnode.com/v1/trades-kline/spot/history?symbol=BTCUSDT&timeframe=1h&limit=3
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/trades-kline/spot/history?symbol=BTCUSDT&timeframe=1h&limit=3"{
"status": "ok",
"server_time": "2026-11-08T12:51:27.036Z",
"data_type": "trades_kline_spot_history",
"symbol": "BTCUSDT",
"timeframe": "1h",
"market": "spot",
"step": "1h",
"data": [
{
"time": "2026-11-08T11:00:00.000Z",
"trade_count": 78824,
"avg_trade_size": 0.00665762370813,
"volume": 524.78053117,
"buy_volume": 329.14685106,
"sell_volume": 195.63368011,
"net_volume": 133.51317095,
"buy_sell_coverage_ratio": 1,
"trade_rate": 21.8955555556,
"is_volume_estimated": false,
"is_closed": true
},
{
"time": "2026-11-08T10:00:00.000Z",
"trade_count": 69364,
"avg_trade_size": 0.0091894724099,
"volume": 637.41856424,
"buy_volume": 330.91496631,
"sell_volume": 306.50359793,
"net_volume": 24.41136838,
"buy_sell_coverage_ratio": 1,
"trade_rate": 19.2677777778,
"is_volume_estimated": false,
"is_closed": true
},
{
"time": "2026-11-08T09:00:00.000Z",
"trade_count": 70142,
"avg_trade_size": 0.0109787258075,
"volume": 770.06978559,
"buy_volume": 357.46647438,
"sell_volume": 412.60331121,
"net_volume": -55.13683683,
"buy_sell_coverage_ratio": 1,
"trade_rate": 19.4838888889,
"is_volume_estimated": false,
"is_closed": true
}
],
"next": "/v1/trades-kline/spot/history?symbol=BTCUSDT&timeframe=1h&limit=3&before_ms=1794128400000&order=desc"
}GET /v1/trades/avg-size
Average trade size. Average trade size (volume / number of trades, all venues) of the latest CLOSED bucket of timeframe (required): the first row of /v1/trades/avg-size/history for the same timeframe (time = its start, is_closed: true). The market is in the PATH: no suffix = all markets (spot + perpetual futures), /spot, /futures; the envelope says which (market). Spot base-asset quantities are measured since 2026-09-27: before that date, spot and all-market buy/sell volumes are estimated from USD amounts (is_volume_estimated: true); /futures serves the full futures history.
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
timeframe obligatoire | string | — | Bucket size, required: 1m, 5m, 15m, 30m, 1h, 4h or 1d. Missing: 422 missing_parameter; other values: 422 invalid_timeframe with the accepted list. In any case (1H is 1h), except 1M: refused, since elsewhere it means a month and here 1m is one minute. |
symbol obligatoire | string | — | Trading pair, e.g. BTCUSDT. Required. The served pairs: GET /v1/symbols. Case-insensitive (btcusdt works; the envelope gives the canonical BTCUSDT). An unknown pair returns 422 invalid_symbol with the accepted list. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,avg_trade_size. Unknown field: 422 unknown_field with a suggestion. |
7 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Start of the latest closed bucket of timeframe — the first row of /v1/trades/avg-size/history for the same timeframe. |
avg_trade_size | number | null | base asset quantity (BTC for BTCUSDT) | Average trade size, base asset units (NOT dollars: multiply by the price for a notional). |
volume | number | null | base asset quantity (BTC for BTCUSDT) | Traded volume over the row, base asset units (BTC for BTCUSDT, NOT dollars), aggregated across venues, over the market(s) the route covers: spot + perpetual futures on /v1/klines and /v1/trades-kline, the path's market alone on a /spot or /futures route (a name without a market suffix covers every market of its route; volume_spot / volume_futures restrict). null when a market is not available (never a partial sum). |
trade_count | integer | null | count | Number of trades. null when the number is not known: history imported from an outside source carries the buy and sell volumes, not the trade count. |
is_volume_estimated | boolean | null | true when some base-asset quantities of this row were ESTIMATED from USD amounts (history where a source reported amounts but not quantities): a buy or sell amount is converted at that source's own average price when its total quantity is known, otherwise at the candle's typical price (high + low + close) / 3. Every quantity a source measured is kept as is. false = all measured. null when the volume itself is null (not available). | |
sample_count | integer | null | count | Number of source points in the bucket (one-minute points with data). For a state (basis, open interest) the value is the LAST of them — the bucket's close —; for a flow it is their total. |
is_closed | boolean | true = the row is final; false = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with ?live=1 on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades. |
Essayer
GET https://api.bytnode.com/v1/trades/avg-size?timeframe=1h&symbol=BTCUSDT
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/trades/avg-size?symbol=BTCUSDT&timeframe=1h"{
"status": "ok",
"server_time": "2026-11-08T12:51:30.290Z",
"data_type": "trades_avg_size",
"symbol": "BTCUSDT",
"timeframe": "1h",
"market": "all",
"data": {
"time": "2026-11-08T11:00:00.000Z",
"avg_trade_size": 0.0254201331638,
"volume": 3982.26722117,
"trade_count": 156658,
"is_volume_estimated": false,
"sample_count": 60,
"is_closed": true
}
}GET /v1/trades/avg-size/futures
Average trade size, perpetual futures only. Perpetual futures market only. Same as /v1/trades/avg-size, which serves every market.
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
timeframe obligatoire | string | — | Bucket size, required: 1m, 5m, 15m, 30m, 1h, 4h or 1d. Missing: 422 missing_parameter; other values: 422 invalid_timeframe with the accepted list. In any case (1H is 1h), except 1M: refused, since elsewhere it means a month and here 1m is one minute. |
symbol obligatoire | string | — | Trading pair, e.g. BTCUSDT. Required. The served pairs: GET /v1/symbols. Case-insensitive (btcusdt works; the envelope gives the canonical BTCUSDT). An unknown pair returns 422 invalid_symbol with the accepted list. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,avg_trade_size. Unknown field: 422 unknown_field with a suggestion. |
7 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Start of the latest closed bucket of timeframe — the first row of /v1/trades/avg-size/history for the same timeframe. |
avg_trade_size | number | null | base asset quantity (BTC for BTCUSDT) | Average trade size, base asset units (NOT dollars: multiply by the price for a notional). |
volume | number | null | base asset quantity (BTC for BTCUSDT) | Traded volume over the row, base asset units (BTC for BTCUSDT, NOT dollars), aggregated across venues, over the market(s) the route covers: spot + perpetual futures on /v1/klines and /v1/trades-kline, the path's market alone on a /spot or /futures route (a name without a market suffix covers every market of its route; volume_spot / volume_futures restrict). null when a market is not available (never a partial sum). |
trade_count | integer | null | count | Number of trades. null when the number is not known: history imported from an outside source carries the buy and sell volumes, not the trade count. |
is_volume_estimated | boolean | null | true when some base-asset quantities of this row were ESTIMATED from USD amounts (history where a source reported amounts but not quantities): a buy or sell amount is converted at that source's own average price when its total quantity is known, otherwise at the candle's typical price (high + low + close) / 3. Every quantity a source measured is kept as is. false = all measured. null when the volume itself is null (not available). | |
sample_count | integer | null | count | Number of source points in the bucket (one-minute points with data). For a state (basis, open interest) the value is the LAST of them — the bucket's close —; for a flow it is their total. |
is_closed | boolean | true = the row is final; false = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with ?live=1 on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades. |
Essayer
GET https://api.bytnode.com/v1/trades/avg-size/futures?timeframe=1h&symbol=BTCUSDT
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/trades/avg-size/futures?symbol=BTCUSDT&timeframe=1h"{
"status": "ok",
"server_time": "2026-11-08T12:52:40.329Z",
"data_type": "trades_avg_size_futures",
"symbol": "BTCUSDT",
"timeframe": "1h",
"market": "futures",
"data": {
"time": "2026-11-08T11:00:00.000Z",
"avg_trade_size": 0.0444212900532,
"volume": 3457.48669,
"trade_count": 77834,
"is_volume_estimated": false,
"sample_count": 60,
"is_closed": true
}
}GET /v1/trades/avg-size/futures/history
Average trade size history, perpetual futures only. Perpetual futures market only. Same as /v1/trades/avg-size/history, which serves every market.
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
since_ms | integer | — | Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range. |
until_ms | integer | — | Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next. |
limit | integer · 1–1000 | 100 | Number of rows to return, in the reading order (most recent first by default). Bounded by your plan's history window: an explicit limit (or since_ms) reaching beyond it returns 403 history_depth; without them the page simply stops at the window. |
timeframe obligatoire | string | — | Required: 1m, 5m, 15m, 30m, 1h, 4h or 1d. One row per closed bucket: for a STATE (basis, open interest) the value of its LAST minute — its close —, for a FLOW (open-interest change, liquidations, trade sizes) the total over its minutes; sample_count = minutes with data in the bucket. 1m gives one row per minute, aligned on the minute. Missing: 422 missing_parameter. |
symbol obligatoire | string | — | Trading pair, e.g. BTCUSDT. Required. The served pairs: GET /v1/symbols. Case-insensitive (btcusdt works; the envelope gives the canonical BTCUSDT). An unknown pair returns 422 invalid_symbol with the accepted list. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,avg_trade_size. Unknown field: 422 unknown_field with a suggestion. |
before_ms | integer | — | Upper time bound, EXCLUSIVE, in epoch milliseconds: rows strictly before it. Pass the oldest time you received to read the previous page without repeating a row. Not combinable with until_ms (422 invalid_time_range). |
order | string | desc | Reading order: desc (most recent first, the default) or asc (oldest first, reading forward from since_ms, which is then required). Follow next to read the following page. |
7 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
[].time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Start of the bucket of timeframe, the value aggregating the bucket's minutes; the row covers time to time + the envelope's step (excluded). |
[].avg_trade_size | number | null | base asset quantity (BTC for BTCUSDT) | Average trade size, base asset units (NOT dollars: multiply by the price for a notional). |
[].volume | number | null | base asset quantity (BTC for BTCUSDT) | Traded volume over the row, base asset units (BTC for BTCUSDT, NOT dollars), aggregated across venues, over the market(s) the route covers: spot + perpetual futures on /v1/klines and /v1/trades-kline, the path's market alone on a /spot or /futures route (a name without a market suffix covers every market of its route; volume_spot / volume_futures restrict). null when a market is not available (never a partial sum). |
[].trade_count | integer | null | count | Number of trades. null when the number is not known: history imported from an outside source carries the buy and sell volumes, not the trade count. |
[].is_volume_estimated | boolean | null | true when some base-asset quantities of this row were ESTIMATED from USD amounts (history where a source reported amounts but not quantities): a buy or sell amount is converted at that source's own average price when its total quantity is known, otherwise at the candle's typical price (high + low + close) / 3. Every quantity a source measured is kept as is. false = all measured. null when the volume itself is null (not available). | |
[].sample_count | integer | null | count | Number of source points in the bucket (one-minute points with data). For a state (basis, open interest) the value is the LAST of them — the bucket's close —; for a flow it is their total. |
[].is_closed | boolean | true = the row is final; false = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with ?live=1 on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades. |
Essayer
GET https://api.bytnode.com/v1/trades/avg-size/futures/history?limit=3&timeframe=1h&symbol=BTCUSDT
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/trades/avg-size/futures/history?symbol=BTCUSDT&limit=3&timeframe=1h"{
"status": "ok",
"server_time": "2026-11-08T12:52:42.221Z",
"data_type": "trades_avg_size_futures_history",
"symbol": "BTCUSDT",
"timeframe": "1h",
"market": "futures",
"step": "1h",
"data": [
{
"time": "2026-11-08T11:00:00.000Z",
"avg_trade_size": 0.0444212900532,
"volume": 3457.48669,
"trade_count": 77834,
"is_volume_estimated": false,
"sample_count": 60,
"is_closed": true
},
{
"time": "2026-11-08T10:00:00.000Z",
"avg_trade_size": 0.0390184384672,
"volume": 2445.75376,
"trade_count": 62682,
"is_volume_estimated": false,
"sample_count": 60,
"is_closed": true
},
{
"time": "2026-11-08T09:00:00.000Z",
"avg_trade_size": 0.0379748302128,
"volume": 2437.90815,
"trade_count": 64198,
"is_volume_estimated": false,
"sample_count": 60,
"is_closed": true
}
],
"next": "/v1/trades/avg-size/futures/history?symbol=BTCUSDT&limit=3&timeframe=1h&before_ms=1794128400000&order=desc"
}GET /v1/trades/avg-size/history
Average trade size history. Trade candles of the market of the path: one row per closed bucket of timeframe. On candles written before base-asset quantities were recorded, the quantity is estimated from USD volume ÷ typical price, as on /v1/trades-kline*, and the row carries is_volume_estimated: true. The market is in the PATH: no suffix = all markets (spot + perpetual futures), /spot, /futures; the envelope says which (market). Spot base-asset quantities are measured since 2026-09-27: before that date, spot and all-market buy/sell volumes are estimated from USD amounts (is_volume_estimated: true); /futures serves the full futures history. Most recent first, or oldest first with order=asc. Follow next to read the following page (it never repeats a row).
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
since_ms | integer | — | Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range. |
until_ms | integer | — | Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next. |
limit | integer · 1–1000 | 100 | Number of rows to return, in the reading order (most recent first by default). Bounded by your plan's history window: an explicit limit (or since_ms) reaching beyond it returns 403 history_depth; without them the page simply stops at the window. |
timeframe obligatoire | string | — | Required: 1m, 5m, 15m, 30m, 1h, 4h or 1d. One row per closed bucket: for a STATE (basis, open interest) the value of its LAST minute — its close —, for a FLOW (open-interest change, liquidations, trade sizes) the total over its minutes; sample_count = minutes with data in the bucket. 1m gives one row per minute, aligned on the minute. Missing: 422 missing_parameter. |
symbol obligatoire | string | — | Trading pair, e.g. BTCUSDT. Required. The served pairs: GET /v1/symbols. Case-insensitive (btcusdt works; the envelope gives the canonical BTCUSDT). An unknown pair returns 422 invalid_symbol with the accepted list. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,avg_trade_size. Unknown field: 422 unknown_field with a suggestion. |
before_ms | integer | — | Upper time bound, EXCLUSIVE, in epoch milliseconds: rows strictly before it. Pass the oldest time you received to read the previous page without repeating a row. Not combinable with until_ms (422 invalid_time_range). |
order | string | desc | Reading order: desc (most recent first, the default) or asc (oldest first, reading forward from since_ms, which is then required). Follow next to read the following page. |
7 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
[].time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Start of the bucket of timeframe, the value aggregating the bucket's minutes; the row covers time to time + the envelope's step (excluded). |
[].avg_trade_size | number | null | base asset quantity (BTC for BTCUSDT) | Average trade size, base asset units (NOT dollars: multiply by the price for a notional). |
[].volume | number | null | base asset quantity (BTC for BTCUSDT) | Traded volume over the row, base asset units (BTC for BTCUSDT, NOT dollars), aggregated across venues, over the market(s) the route covers: spot + perpetual futures on /v1/klines and /v1/trades-kline, the path's market alone on a /spot or /futures route (a name without a market suffix covers every market of its route; volume_spot / volume_futures restrict). null when a market is not available (never a partial sum). |
[].trade_count | integer | null | count | Number of trades. null when the number is not known: history imported from an outside source carries the buy and sell volumes, not the trade count. |
[].is_volume_estimated | boolean | null | true when some base-asset quantities of this row were ESTIMATED from USD amounts (history where a source reported amounts but not quantities): a buy or sell amount is converted at that source's own average price when its total quantity is known, otherwise at the candle's typical price (high + low + close) / 3. Every quantity a source measured is kept as is. false = all measured. null when the volume itself is null (not available). | |
[].sample_count | integer | null | count | Number of source points in the bucket (one-minute points with data). For a state (basis, open interest) the value is the LAST of them — the bucket's close —; for a flow it is their total. |
[].is_closed | boolean | true = the row is final; false = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with ?live=1 on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades. |
Essayer
GET https://api.bytnode.com/v1/trades/avg-size/history?limit=3&timeframe=1h&symbol=BTCUSDT
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/trades/avg-size/history?symbol=BTCUSDT&limit=3&timeframe=1h"{
"status": "ok",
"server_time": "2026-11-08T12:51:31.622Z",
"data_type": "trades_avg_size_history",
"symbol": "BTCUSDT",
"timeframe": "1h",
"market": "all",
"step": "1h",
"data": [
{
"time": "2026-11-08T11:00:00.000Z",
"avg_trade_size": 0.0254201331638,
"volume": 3982.26722117,
"trade_count": 156658,
"is_volume_estimated": false,
"sample_count": 60,
"is_closed": true
},
{
"time": "2026-11-08T10:00:00.000Z",
"avg_trade_size": 0.0233492292401,
"volume": 3083.17232424,
"trade_count": 132046,
"is_volume_estimated": false,
"sample_count": 60,
"is_closed": true
},
{
"time": "2026-11-08T09:00:00.000Z",
"avg_trade_size": 0.02387954396,
"volume": 3207.97793559,
"trade_count": 134340,
"is_volume_estimated": false,
"sample_count": 60,
"is_closed": true
}
],
"next": "/v1/trades/avg-size/history?symbol=BTCUSDT&limit=3&timeframe=1h&before_ms=1794128400000&order=desc"
}GET /v1/trades/avg-size/spot
Average trade size, spot only. Spot market only. Same as /v1/trades/avg-size, which serves every market.
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
timeframe obligatoire | string | — | Bucket size, required: 1m, 5m, 15m, 30m, 1h, 4h or 1d. Missing: 422 missing_parameter; other values: 422 invalid_timeframe with the accepted list. In any case (1H is 1h), except 1M: refused, since elsewhere it means a month and here 1m is one minute. |
symbol obligatoire | string | — | Trading pair, e.g. BTCUSDT. Required. The served pairs: GET /v1/symbols. Case-insensitive (btcusdt works; the envelope gives the canonical BTCUSDT). An unknown pair returns 422 invalid_symbol with the accepted list. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,avg_trade_size. Unknown field: 422 unknown_field with a suggestion. |
7 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Start of the latest closed bucket of timeframe — the first row of /v1/trades/avg-size/history for the same timeframe. |
avg_trade_size | number | null | base asset quantity (BTC for BTCUSDT) | Average trade size, base asset units (NOT dollars: multiply by the price for a notional). |
volume | number | null | base asset quantity (BTC for BTCUSDT) | Traded volume over the row, base asset units (BTC for BTCUSDT, NOT dollars), aggregated across venues, over the market(s) the route covers: spot + perpetual futures on /v1/klines and /v1/trades-kline, the path's market alone on a /spot or /futures route (a name without a market suffix covers every market of its route; volume_spot / volume_futures restrict). null when a market is not available (never a partial sum). |
trade_count | integer | null | count | Number of trades. null when the number is not known: history imported from an outside source carries the buy and sell volumes, not the trade count. |
is_volume_estimated | boolean | null | true when some base-asset quantities of this row were ESTIMATED from USD amounts (history where a source reported amounts but not quantities): a buy or sell amount is converted at that source's own average price when its total quantity is known, otherwise at the candle's typical price (high + low + close) / 3. Every quantity a source measured is kept as is. false = all measured. null when the volume itself is null (not available). | |
sample_count | integer | null | count | Number of source points in the bucket (one-minute points with data). For a state (basis, open interest) the value is the LAST of them — the bucket's close —; for a flow it is their total. |
is_closed | boolean | true = the row is final; false = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with ?live=1 on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades. |
Essayer
GET https://api.bytnode.com/v1/trades/avg-size/spot?timeframe=1h&symbol=BTCUSDT
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/trades/avg-size/spot?symbol=BTCUSDT&timeframe=1h"{
"status": "ok",
"server_time": "2026-11-08T12:52:39.220Z",
"data_type": "trades_avg_size_spot",
"symbol": "BTCUSDT",
"timeframe": "1h",
"market": "spot",
"data": {
"time": "2026-11-08T11:00:00.000Z",
"avg_trade_size": 0.00665762370813,
"volume": 524.78053117,
"trade_count": 78824,
"is_volume_estimated": false,
"sample_count": 60,
"is_closed": true
}
}GET /v1/trades/avg-size/spot/history
Average trade size history, spot only. Spot market only. Same as /v1/trades/avg-size/history, which serves every market.
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
since_ms | integer | — | Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range. |
until_ms | integer | — | Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next. |
limit | integer · 1–1000 | 100 | Number of rows to return, in the reading order (most recent first by default). Bounded by your plan's history window: an explicit limit (or since_ms) reaching beyond it returns 403 history_depth; without them the page simply stops at the window. |
timeframe obligatoire | string | — | Required: 1m, 5m, 15m, 30m, 1h, 4h or 1d. One row per closed bucket: for a STATE (basis, open interest) the value of its LAST minute — its close —, for a FLOW (open-interest change, liquidations, trade sizes) the total over its minutes; sample_count = minutes with data in the bucket. 1m gives one row per minute, aligned on the minute. Missing: 422 missing_parameter. |
symbol obligatoire | string | — | Trading pair, e.g. BTCUSDT. Required. The served pairs: GET /v1/symbols. Case-insensitive (btcusdt works; the envelope gives the canonical BTCUSDT). An unknown pair returns 422 invalid_symbol with the accepted list. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,avg_trade_size. Unknown field: 422 unknown_field with a suggestion. |
before_ms | integer | — | Upper time bound, EXCLUSIVE, in epoch milliseconds: rows strictly before it. Pass the oldest time you received to read the previous page without repeating a row. Not combinable with until_ms (422 invalid_time_range). |
order | string | desc | Reading order: desc (most recent first, the default) or asc (oldest first, reading forward from since_ms, which is then required). Follow next to read the following page. |
7 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
[].time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Start of the bucket of timeframe, the value aggregating the bucket's minutes; the row covers time to time + the envelope's step (excluded). |
[].avg_trade_size | number | null | base asset quantity (BTC for BTCUSDT) | Average trade size, base asset units (NOT dollars: multiply by the price for a notional). |
[].volume | number | null | base asset quantity (BTC for BTCUSDT) | Traded volume over the row, base asset units (BTC for BTCUSDT, NOT dollars), aggregated across venues, over the market(s) the route covers: spot + perpetual futures on /v1/klines and /v1/trades-kline, the path's market alone on a /spot or /futures route (a name without a market suffix covers every market of its route; volume_spot / volume_futures restrict). null when a market is not available (never a partial sum). |
[].trade_count | integer | null | count | Number of trades. null when the number is not known: history imported from an outside source carries the buy and sell volumes, not the trade count. |
[].is_volume_estimated | boolean | null | true when some base-asset quantities of this row were ESTIMATED from USD amounts (history where a source reported amounts but not quantities): a buy or sell amount is converted at that source's own average price when its total quantity is known, otherwise at the candle's typical price (high + low + close) / 3. Every quantity a source measured is kept as is. false = all measured. null when the volume itself is null (not available). | |
[].sample_count | integer | null | count | Number of source points in the bucket (one-minute points with data). For a state (basis, open interest) the value is the LAST of them — the bucket's close —; for a flow it is their total. |
[].is_closed | boolean | true = the row is final; false = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with ?live=1 on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades. |
Essayer
GET https://api.bytnode.com/v1/trades/avg-size/spot/history?limit=3&timeframe=1h&symbol=BTCUSDT
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/trades/avg-size/spot/history?symbol=BTCUSDT&limit=3&timeframe=1h"{
"status": "ok",
"server_time": "2026-11-08T12:52:41.403Z",
"data_type": "trades_avg_size_spot_history",
"symbol": "BTCUSDT",
"timeframe": "1h",
"market": "spot",
"step": "1h",
"data": [
{
"time": "2026-11-08T11:00:00.000Z",
"avg_trade_size": 0.00665762370813,
"volume": 524.78053117,
"trade_count": 78824,
"is_volume_estimated": false,
"sample_count": 60,
"is_closed": true
},
{
"time": "2026-11-08T10:00:00.000Z",
"avg_trade_size": 0.0091894724099,
"volume": 637.41856424,
"trade_count": 69364,
"is_volume_estimated": false,
"sample_count": 60,
"is_closed": true
},
{
"time": "2026-11-08T09:00:00.000Z",
"avg_trade_size": 0.0109787258075,
"volume": 770.06978559,
"trade_count": 70142,
"is_volume_estimated": false,
"sample_count": 60,
"is_closed": true
}
],
"next": "/v1/trades/avg-size/spot/history?symbol=BTCUSDT&limit=3&timeframe=1h&before_ms=1794128400000&order=desc"
}#Derivatives
Perpetual futures positioning, aggregated across venues: funding (settled, estimated, cumulative), basis, open interest.
GET /v1/basis
Futures-spot basis. Perpetual futures price versus spot, OI-weighted across venues (each venue weighted by its latest open interest within 10 minutes). An INSTANT value, not a window: each venue's last futures and spot trade prices (at most 2 minutes old) at time.
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
symbol obligatoire | string | — | Trading pair, e.g. BTCUSDT. Required. The served pairs: GET /v1/symbols. Case-insensitive (btcusdt works; the envelope gives the canonical BTCUSDT). An unknown pair returns 422 invalid_symbol with the accepted list. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,basis_value. Unknown field: 422 unknown_field with a suggestion. |
5 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Point-in-time value: the instant of the venue prices used (each venue's last futures and spot trades, at most 2 minutes old). |
basis_value | number | quote currency (USDT for BTCUSDT) | Futures price - spot price, in the quote currency (USDT for BTCUSDT), like the two prices. |
basis_pct | number | percent (58.5 = 58.5 %) | (futures - spot) / spot, in percent. Positive = contango. |
futures_price | number | quote currency (USDT for BTCUSDT) | Perpetual futures price, open-interest weighted across venues. |
spot_price | number | quote currency (USDT for BTCUSDT) | Spot price across venues at the instant of the row, paired with the futures price of the same instant. Not the latest trade price: that is the price of /v1/price-change, i.e. the close of /v1/klines?live=1. |
Essayer
GET https://api.bytnode.com/v1/basis?symbol=BTCUSDT
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/basis?symbol=BTCUSDT"{
"status": "ok",
"server_time": "2026-11-08T12:51:42.950Z",
"data_type": "basis",
"symbol": "BTCUSDT",
"data": {
"time": "2026-11-08T12:51:33.002Z",
"basis_value": -32.7398289401,
"basis_pct": -0.0431092978463,
"futures_price": 75912.894712,
"spot_price": 75945.6345409
}
}GET /v1/basis/history
Basis history. One row per closed bucket of timeframe (required). Each timeframe starts where readings are at least that fine, so step is always the real spacing: 1d covers the whole history, 4h starts on 2025-10-07, 1h on 2026-04-04 17:00 UTC, and 1m to 30m on 2026-05-28 19:10 UTC (2026-09-12 14:40 UTC for AVAX, HBAR, LINK, NEAR, TAO, UNI, XMR, ADA, GRAM and LTC; older readings were taken once a day, then every 4 hours, then hourly). The 82 pairs added in October 2026 have their own starts, pair by pair: 1d covers their whole history, 1h and 4h start around 2025-10-24, 30m around 2026-04-22, 15m around 2026-07-21, and 1m and 5m on the day the pair was added (2026-10-19 09:31 UTC, or 2026-10-27 18:03 UTC for the 27 latest). Read older periods at a coarser timeframe; a since_ms before the start is raised to it, and a window entirely before it returns no rows. Most recent first, or oldest first with order=asc. Follow next to read the following page (it never repeats a row).
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
since_ms | integer | — | Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range. |
until_ms | integer | — | Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next. |
limit | integer · 1–1000 | 100 | Number of rows to return, in the reading order (most recent first by default). Bounded by your plan's history window: an explicit limit (or since_ms) reaching beyond it returns 403 history_depth; without them the page simply stops at the window. |
timeframe obligatoire | string | — | Required: 1m, 5m, 15m, 30m, 1h, 4h or 1d. One row per closed bucket: for a STATE (basis, open interest) the value of its LAST minute — its close —, for a FLOW (open-interest change, liquidations, trade sizes) the total over its minutes; sample_count = minutes with data in the bucket. 1m gives one row per minute, aligned on the minute. Missing: 422 missing_parameter. |
symbol obligatoire | string | — | Trading pair, e.g. BTCUSDT. Required. The served pairs: GET /v1/symbols. Case-insensitive (btcusdt works; the envelope gives the canonical BTCUSDT). An unknown pair returns 422 invalid_symbol with the accepted list. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,basis_value. Unknown field: 422 unknown_field with a suggestion. |
before_ms | integer | — | Upper time bound, EXCLUSIVE, in epoch milliseconds: rows strictly before it. Pass the oldest time you received to read the previous page without repeating a row. Not combinable with until_ms (422 invalid_time_range). |
order | string | desc | Reading order: desc (most recent first, the default) or asc (oldest first, reading forward from since_ms, which is then required). Follow next to read the following page. |
7 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
[].time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Start of the bucket of timeframe; the value is the LAST one of the bucket's minutes. |
[].basis_value | number | quote currency (USDT for BTCUSDT) | Futures price - spot price, in the quote currency (USDT for BTCUSDT), like the two prices. |
[].basis_pct | number | percent (58.5 = 58.5 %) | (futures - spot) / spot, in percent. Positive = contango. |
[].futures_price | number | quote currency (USDT for BTCUSDT) | Perpetual futures price, open-interest weighted across venues. |
[].spot_price | number | quote currency (USDT for BTCUSDT) | Spot price across venues at the instant of the row, paired with the futures price of the same instant. Not the latest trade price: that is the price of /v1/price-change, i.e. the close of /v1/klines?live=1. |
[].sample_count | integer | null | count | Number of source points in the bucket (one-minute points with data). For a state (basis, open interest) the value is the LAST of them — the bucket's close —; for a flow it is their total. |
[].is_closed | boolean | true = the row is final; false = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with ?live=1 on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades. |
Essayer
GET https://api.bytnode.com/v1/basis/history?limit=3&timeframe=1h&symbol=BTCUSDT
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/basis/history?symbol=BTCUSDT&limit=3&timeframe=1h"{
"status": "ok",
"server_time": "2026-11-08T12:51:43.961Z",
"data_type": "basis_history",
"symbol": "BTCUSDT",
"timeframe": "1h",
"step": "1h",
"data": [
{
"time": "2026-11-08T11:00:00.000Z",
"basis_value": -31.2866394175,
"basis_pct": -0.0411839563118,
"futures_price": 75935.816288,
"spot_price": 75967.1029274,
"sample_count": 60,
"is_closed": true
},
{
"time": "2026-11-08T10:00:00.000Z",
"basis_value": -31.6563280535,
"basis_pct": -0.041710464353,
"futures_price": 75863.643314,
"spot_price": 75895.2996421,
"sample_count": 60,
"is_closed": true
},
{
"time": "2026-11-08T09:00:00.000Z",
"basis_value": -31.7248185637,
"basis_pct": -0.041780461504,
"futures_price": 75900.4881711,
"spot_price": 75932.2129897,
"sample_count": 60,
"is_closed": true
}
],
"next": "/v1/basis/history?symbol=BTCUSDT&limit=3&timeframe=1h&before_ms=1794128400000&order=desc"
}GET /v1/funding/cumulative
Funding over the last 24 h. Sum of the last three settled 8-hour windows (rolling_24h_rate_pct, a ROLLING 24-hour window) and its annualised rate. time is the end of the window; a new value every 8 hours.
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
symbol obligatoire | string | — | Trading pair, e.g. BTCUSDT. Required. The served pairs: GET /v1/symbols. Case-insensitive (btcusdt works; the envelope gives the canonical BTCUSDT). An unknown pair returns 422 invalid_symbol with the accepted list. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,window_start_at. Unknown field: 422 unknown_field with a suggestion. |
6 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Point-in-time value over a rolling window: the END of the 24-hour window, i.e. the settlement that closes the last 8-hour period summed. The window starts at window_start_at and lasts window_s. |
window_start_at | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Start of the 24-hour window summed (inclusive). |
window_s | integer | null | seconds | Length of the window, in seconds (86400 = 24 hours). |
rolling_24h_rate_pct | number | percent (58.5 = 58.5 %) | Sum of the last three settled 8-hour funding rates — a ROLLING 24-hour window — in percent. A row is published every 8 hours and covers 24: consecutive rows OVERLAP by 16 hours, so never add them up (sum rate_pct of /v1/funding/rate/history instead). |
apr_pct | number | null | percent (58.5 = 58.5 %) | Annualised rate in percent. |
sample_count | integer | null | count | Number of 8-hour funding windows summed. |
Essayer
GET https://api.bytnode.com/v1/funding/cumulative?symbol=BTCUSDT
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/funding/cumulative?symbol=BTCUSDT"{
"status": "ok",
"server_time": "2026-11-08T12:51:41.234Z",
"data_type": "funding_cumulative",
"symbol": "BTCUSDT",
"market": "futures",
"data": {
"time": "2026-11-08T08:00:00.000Z",
"window_start_at": "2026-11-07T08:00:00.000Z",
"window_s": 86400,
"rolling_24h_rate_pct": 0.0211852555444,
"apr_pct": 7.73261827372,
"sample_count": 3
}
}GET /v1/funding/cumulative/history
Rolling 24 h funding history. One row every 8 hours, each covering the 24 hours before it: consecutive rows OVERLAP by 16 hours, so never add them up — sum rate_pct of /v1/funding/rate/history for a total over a period. Most recent first, or oldest first with order=asc. Follow next to read the following page (it never repeats a row).
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
since_ms | integer | — | Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range. |
until_ms | integer | — | Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next. |
limit | integer · 1–1000 | 100 | Number of rows to return, in the reading order (most recent first by default). Bounded by your plan's history window: an explicit limit (or since_ms) reaching beyond it returns 403 history_depth; without them the page simply stops at the window. |
symbol obligatoire | string | — | Trading pair, e.g. BTCUSDT. Required. The served pairs: GET /v1/symbols. Case-insensitive (btcusdt works; the envelope gives the canonical BTCUSDT). An unknown pair returns 422 invalid_symbol with the accepted list. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,window_start_at. Unknown field: 422 unknown_field with a suggestion. |
before_ms | integer | — | Upper time bound, EXCLUSIVE, in epoch milliseconds: rows strictly before it. Pass the oldest time you received to read the previous page without repeating a row. Not combinable with until_ms (422 invalid_time_range). |
order | string | desc | Reading order: desc (most recent first, the default) or asc (oldest first, reading forward from since_ms, which is then required). Follow next to read the following page. |
7 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
[].time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | END of each 24-hour window (the settlement that closes its last 8-hour period). The window starts at window_start_at and lasts window_s. |
[].window_start_at | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Start of the 24-hour window summed (inclusive). |
[].window_s | integer | null | seconds | Length of the window, in seconds (86400 = 24 hours). |
[].rolling_24h_rate_pct | number | percent (58.5 = 58.5 %) | Sum of the last three settled 8-hour funding rates — a ROLLING 24-hour window — in percent. A row is published every 8 hours and covers 24: consecutive rows OVERLAP by 16 hours, so never add them up (sum rate_pct of /v1/funding/rate/history instead). |
[].apr_pct | number | null | percent (58.5 = 58.5 %) | Annualised rate in percent. |
[].sample_count | integer | null | count | Number of 8-hour funding windows summed. |
[].is_closed | boolean | true = the row is final; false = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with ?live=1 on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades. |
Essayer
GET https://api.bytnode.com/v1/funding/cumulative/history?limit=3&symbol=BTCUSDT
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/funding/cumulative/history?symbol=BTCUSDT&limit=3"{
"status": "ok",
"server_time": "2026-11-08T12:51:42.214Z",
"data_type": "funding_cumulative_history",
"symbol": "BTCUSDT",
"market": "futures",
"step": "8h",
"data": [
{
"time": "2026-11-08T08:00:00.000Z",
"window_start_at": "2026-11-07T08:00:00.000Z",
"window_s": 86400,
"rolling_24h_rate_pct": 0.0211852555444,
"apr_pct": 7.73261827372,
"sample_count": 3,
"is_closed": true
},
{
"time": "2026-11-08T00:00:00.000Z",
"window_start_at": "2026-11-07T00:00:00.000Z",
"window_s": 86400,
"rolling_24h_rate_pct": 0.0155878091347,
"apr_pct": 5.68955033415,
"sample_count": 3,
"is_closed": true
},
{
"time": "2026-11-07T16:00:00.000Z",
"window_start_at": "2026-11-06T16:00:00.000Z",
"window_s": 86400,
"rolling_24h_rate_pct": 0.0162325972965,
"apr_pct": 5.92489801323,
"sample_count": 3,
"is_closed": true
}
],
"next": "/v1/funding/cumulative/history?symbol=BTCUSDT&limit=3&before_ms=1794067200000&order=desc"
}GET /v1/funding/next
Next funding forecast. Each venue's forecast of its next settlement, normalised to 8 h and OI-weighted. The same value is the rate of the period in progress on /v1/funding/rate?live=1.
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
symbol obligatoire | string | — | Trading pair, e.g. BTCUSDT. Required. The served pairs: GET /v1/symbols. Case-insensitive (btcusdt works; the envelope gives the canonical BTCUSDT). An unknown pair returns 422 invalid_symbol with the accepted list. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,estimated_rate_pct. Unknown field: 422 unknown_field with a suggestion. |
4 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Point-in-time value: the instant of the next funding settlement the forecast is for. |
estimated_rate_pct | number | percent (58.5 = 58.5 %) | Venue forecast of the NEXT funding settlement, in percent per 8 h (0.01 = 0.01 %), normalised to 8 h, OI-weighted. |
apr_pct | number | null | percent (58.5 = 58.5 %) | Annualised rate in percent. |
is_past | boolean | true if the forecast settlement instant is already past (the next forecast is not published yet). |
Essayer
GET https://api.bytnode.com/v1/funding/next?symbol=BTCUSDT
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/funding/next?symbol=BTCUSDT"{
"status": "ok",
"server_time": "2026-11-08T12:51:40.232Z",
"data_type": "funding_next",
"symbol": "BTCUSDT",
"market": "futures",
"data": {
"time": "2026-11-08T16:00:00.000Z",
"estimated_rate_pct": 0.00571800262797,
"apr_pct": 6.26121287762,
"is_past": false
}
}GET /v1/funding/rate
Latest settled funding rate. The last fully settled 8-hour funding window, normalised to 8 h and weighted by the open interest of each venue at that time. ?live=1 for the window in progress (is_closed: false, settled_at: null): its rate is the venues' FORECAST for the period, the same value as estimated_rate_pct of /v1/funding/next. time is the START of the period; the period is [time, period_end_at) and settled_at says when its last settlement was paid — compare it with the time of /v1/funding/next (the next settlement), not with this time. rate_pct is in percent per 8 h.
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
live | boolean | false | 1 or true to return the CURRENT, still-open period computed on the fly (is_closed: false). Default: the last closed period only. |
symbol obligatoire | string | — | Trading pair, e.g. BTCUSDT. Required. The served pairs: GET /v1/symbols. Case-insensitive (btcusdt works; the envelope gives the canonical BTCUSDT). An unknown pair returns 422 invalid_symbol with the accepted list. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,period_end_at. Unknown field: 422 unknown_field with a suggestion. |
6 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Start of the 8-hour funding period. The window is PAID by the settlement at its end: read period_end_at / settled_at for when it was settled. |
period_end_at | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | End of the 8-hour funding period (exclusive): the instant of the settlement that pays it. |
settled_at | date-time | null | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Instant of the last settlement counted in the window: period_end_at for a complete settled window; null for the window in progress (?live=1), which is not settled yet. |
rate_pct | number | percent (58.5 = 58.5 %) | Settled funding rate of the 8-hour period, in percent (0.01 = 0.01 % per 8 h), normalised to 8 h and open-interest weighted across venues. |
apr_pct | number | null | percent (58.5 = 58.5 %) | Annualised rate in percent. |
is_closed | boolean | true = the row is final; false = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with ?live=1 on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades. |
Essayer
GET https://api.bytnode.com/v1/funding/rate?symbol=BTCUSDT
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/funding/rate?symbol=BTCUSDT"{
"status": "ok",
"server_time": "2026-11-08T12:51:38.169Z",
"data_type": "funding_rate",
"symbol": "BTCUSDT",
"market": "futures",
"data": {
"time": "2026-11-08T00:00:00.000Z",
"period_end_at": "2026-11-08T08:00:00.000Z",
"settled_at": "2026-11-08T08:00:00.009Z",
"rate_pct": 0.00825097837214,
"apr_pct": 9.0348213175,
"is_closed": true
}
}GET /v1/funding/rate/history
Settled funding history. One row per settled 8-hour window (time = start of the period), with period_end_at and settled_at. Most recent first, or oldest first with order=asc. Follow next to read the following page (it never repeats a row).
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
since_ms | integer | — | Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range. |
until_ms | integer | — | Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next. |
limit | integer · 1–1000 | 100 | Number of rows to return, in the reading order (most recent first by default). Bounded by your plan's history window: an explicit limit (or since_ms) reaching beyond it returns 403 history_depth; without them the page simply stops at the window. |
symbol obligatoire | string | — | Trading pair, e.g. BTCUSDT. Required. The served pairs: GET /v1/symbols. Case-insensitive (btcusdt works; the envelope gives the canonical BTCUSDT). An unknown pair returns 422 invalid_symbol with the accepted list. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,period_end_at. Unknown field: 422 unknown_field with a suggestion. |
before_ms | integer | — | Upper time bound, EXCLUSIVE, in epoch milliseconds: rows strictly before it. Pass the oldest time you received to read the previous page without repeating a row. Not combinable with until_ms (422 invalid_time_range). |
order | string | desc | Reading order: desc (most recent first, the default) or asc (oldest first, reading forward from since_ms, which is then required). Follow next to read the following page. |
6 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
[].time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Start of the 8-hour funding period. The window is PAID by the settlement at its end: read period_end_at / settled_at for when it was settled. |
[].period_end_at | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | End of the 8-hour funding period (exclusive): the instant of the settlement that pays it. |
[].settled_at | date-time | null | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Instant of the last settlement counted in the window: period_end_at for a complete settled window; null for the window in progress (?live=1), which is not settled yet. |
[].rate_pct | number | percent (58.5 = 58.5 %) | Settled funding rate of the 8-hour period, in percent (0.01 = 0.01 % per 8 h), normalised to 8 h and open-interest weighted across venues. |
[].apr_pct | number | null | percent (58.5 = 58.5 %) | Annualised rate in percent. |
[].is_closed | boolean | true = the row is final; false = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with ?live=1 on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades. |
Essayer
GET https://api.bytnode.com/v1/funding/rate/history?limit=3&symbol=BTCUSDT
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/funding/rate/history?symbol=BTCUSDT&limit=3"{
"status": "ok",
"server_time": "2026-11-08T12:51:39.660Z",
"data_type": "funding_rate_history",
"symbol": "BTCUSDT",
"market": "futures",
"step": "8h",
"data": [
{
"time": "2026-11-08T00:00:00.000Z",
"period_end_at": "2026-11-08T08:00:00.000Z",
"settled_at": "2026-11-08T08:00:00.009Z",
"rate_pct": 0.00825097837214,
"apr_pct": 9.0348213175,
"is_closed": true
},
{
"time": "2026-11-07T16:00:00.000Z",
"period_end_at": "2026-11-08T00:00:00.000Z",
"settled_at": "2026-11-08T00:00:00.070Z",
"rate_pct": 0.00808545662544,
"apr_pct": 8.85357500485,
"is_closed": true
},
{
"time": "2026-11-07T08:00:00.000Z",
"period_end_at": "2026-11-07T16:00:00.000Z",
"settled_at": "2026-11-07T16:00:00.001Z",
"rate_pct": 0.00484882054687,
"apr_pct": 5.30945849882,
"is_closed": true
}
],
"next": "/v1/funding/rate/history?symbol=BTCUSDT&limit=3&before_ms=1794038400000&order=desc"
}GET /v1/oi
Open interest. Current total open interest of the perpetual futures, summed across venues (base asset units): for each venue its latest reading, then the sum. The same oi, at the same instant, as /v1/oi/change; its history is /v1/oi/history.
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
symbol obligatoire | string | — | Trading pair, e.g. BTCUSDT. Required. The served pairs: GET /v1/symbols. Case-insensitive (btcusdt works; the envelope gives the canonical BTCUSDT). An unknown pair returns 422 invalid_symbol with the accepted list. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,oi. Unknown field: 422 unknown_field with a suggestion. |
2 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Point-in-time value: the instant of the latest reading summed (the same as /v1/oi/change). |
oi | number | base asset quantity (BTC for BTCUSDT) | Total open interest across venues, base asset units. On a bucketed row, the value at the END of the bucket (like a close); on /v1/oi/change, the latest measurement. |
Essayer
GET https://api.bytnode.com/v1/oi?symbol=BTCUSDT
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/oi?symbol=BTCUSDT"{
"status": "ok",
"server_time": "2026-11-08T12:51:44.530Z",
"data_type": "oi",
"symbol": "BTCUSDT",
"market": "futures",
"data": {
"time": "2026-11-08T12:51:13.943Z",
"oi": 394280.15342
}
}GET /v1/oi/change
Open interest change. Change of total open interest over the last minute, summed across venues: oi (now), previous_oi, oi_change, oi_change_pct. A rolling value: time is the reading, window_start_at the one before.
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
symbol obligatoire | string | — | Trading pair, e.g. BTCUSDT. Required. The served pairs: GET /v1/symbols. Case-insensitive (btcusdt works; the envelope gives the canonical BTCUSDT). An unknown pair returns 422 invalid_symbol with the accepted list. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,oi. Unknown field: 422 unknown_field with a suggestion. |
7 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Point-in-time value: the instant of the measurement; the change covers the minute before it. |
oi | number | base asset quantity (BTC for BTCUSDT) | Total open interest across venues, base asset units. On a bucketed row, the value at the END of the bucket (like a close); on /v1/oi/change, the latest measurement. |
previous_oi | number | base asset quantity (BTC for BTCUSDT) | Total open interest at the start of the window (window_start_at). |
oi_change | number | base asset quantity (BTC for BTCUSDT) | oi - previous_oi, base asset units. |
oi_change_pct | number | percent (58.5 = 58.5 %) | Relative open interest change, percent. |
window_start_at | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Start of the ROLLING window the value covers (inclusive). Only rolling-window values carry it, and their time is always the END of the window; a bucket row has no window fields (its span is the envelope's step). |
window_s | integer | null | seconds | Length of that rolling window, in whole seconds: it runs from window_start_at to time (excluded). |
Essayer
GET https://api.bytnode.com/v1/oi/change?symbol=BTCUSDT
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/oi/change?symbol=BTCUSDT"{
"status": "ok",
"server_time": "2026-11-08T12:51:45.041Z",
"data_type": "oi_change",
"symbol": "BTCUSDT",
"market": "futures",
"data": {
"time": "2026-11-08T12:51:13.943Z",
"oi": 394280.15342,
"previous_oi": 394288.04442,
"oi_change": -7.89099999999,
"oi_change_pct": -0.00200132875231,
"window_start_at": "2026-11-08T12:50:13.943Z",
"window_s": 60
}
}GET /v1/oi/change/history
Open interest change history. One row per closed bucket of timeframe (required), on the same totals as /v1/oi/history: same buckets, same oi. A venue carried over from a previous reading counts with no change. Each timeframe starts where readings are at least that fine, so step is always the real spacing: 1d covers the whole history, 4h starts on 2025-10-07, 1h on 2026-04-04 17:00 UTC, and 1m to 30m on 2026-05-28 19:10 UTC (2026-09-12 14:40 UTC for AVAX, HBAR, LINK, NEAR, TAO, UNI, XMR, ADA, GRAM and LTC; older readings were taken once a day, then every 4 hours, then hourly). The 82 pairs added in October 2026 have their own starts, pair by pair: 1d covers their whole history, 1h and 4h start around 2025-10-24, 30m around 2026-04-22, 15m around 2026-07-21, and 1m and 5m on the day the pair was added (2026-10-19 09:31 UTC, or 2026-10-27 18:03 UTC for the 27 latest). Read older periods at a coarser timeframe; a since_ms before the start is raised to it, and a window entirely before it returns no rows. Most recent first, or oldest first with order=asc. Follow next to read the following page (it never repeats a row).
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
since_ms | integer | — | Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range. |
until_ms | integer | — | Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next. |
limit | integer · 1–1000 | 100 | Number of rows to return, in the reading order (most recent first by default). Bounded by your plan's history window: an explicit limit (or since_ms) reaching beyond it returns 403 history_depth; without them the page simply stops at the window. |
timeframe obligatoire | string | — | Required: 1m, 5m, 15m, 30m, 1h, 4h or 1d. One row per closed bucket: for a STATE (basis, open interest) the value of its LAST minute — its close —, for a FLOW (open-interest change, liquidations, trade sizes) the total over its minutes; sample_count = minutes with data in the bucket. 1m gives one row per minute, aligned on the minute. Missing: 422 missing_parameter. |
symbol obligatoire | string | — | Trading pair, e.g. BTCUSDT. Required. The served pairs: GET /v1/symbols. Case-insensitive (btcusdt works; the envelope gives the canonical BTCUSDT). An unknown pair returns 422 invalid_symbol with the accepted list. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,oi. Unknown field: 422 unknown_field with a suggestion. |
before_ms | integer | — | Upper time bound, EXCLUSIVE, in epoch milliseconds: rows strictly before it. Pass the oldest time you received to read the previous page without repeating a row. Not combinable with until_ms (422 invalid_time_range). |
order | string | desc | Reading order: desc (most recent first, the default) or asc (oldest first, reading forward from since_ms, which is then required). Follow next to read the following page. |
7 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
[].time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Start of the bucket of timeframe, the value aggregating the bucket's minutes; the row covers time to time + the envelope's step (excluded). |
[].oi | number | base asset quantity (BTC for BTCUSDT) | Total open interest across venues, base asset units. On a bucketed row, the value at the END of the bucket (like a close); on /v1/oi/change, the latest measurement. |
[].previous_oi | number | base asset quantity (BTC for BTCUSDT) | Total open interest at the start of the window (window_start_at). |
[].oi_change | number | base asset quantity (BTC for BTCUSDT) | oi - previous_oi, base asset units. |
[].oi_change_pct | number | percent (58.5 = 58.5 %) | Relative open interest change, percent. |
[].sample_count | integer | null | count | Number of source points in the bucket (one-minute points with data). For a state (basis, open interest) the value is the LAST of them — the bucket's close —; for a flow it is their total. |
[].is_closed | boolean | true = the row is final; false = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with ?live=1 on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades. |
Essayer
GET https://api.bytnode.com/v1/oi/change/history?limit=3&timeframe=1h&symbol=BTCUSDT
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/oi/change/history?symbol=BTCUSDT&limit=3&timeframe=1h"{
"status": "ok",
"server_time": "2026-11-08T12:51:45.600Z",
"data_type": "oi_change_history",
"symbol": "BTCUSDT",
"timeframe": "1h",
"market": "futures",
"step": "1h",
"data": [
{
"time": "2026-11-08T11:00:00.000Z",
"oi": 394299.2028,
"previous_oi": 395319.37684,
"oi_change": -1020.17404,
"oi_change_pct": -0.258063252086,
"sample_count": 60,
"is_closed": true
},
{
"time": "2026-11-08T10:00:00.000Z",
"oi": 395319.37684,
"previous_oi": 395260.81578,
"oi_change": 58.5610599999,
"oi_change_pct": 0.014815802038,
"sample_count": 60,
"is_closed": true
},
{
"time": "2026-11-08T09:00:00.000Z",
"oi": 395260.81578,
"previous_oi": 395186.22916,
"oi_change": 74.5866200001,
"oi_change_pct": 0.0188737902529,
"sample_count": 60,
"is_closed": true
}
],
"next": "/v1/oi/change/history?symbol=BTCUSDT&limit=3&timeframe=1h&before_ms=1794128400000&order=desc"
}GET /v1/oi/history
Total open interest history. Open interest summed across futures venues, per closed bucket of timeframe (required): for each venue, its latest reading at the END of the bucket — oi is the value at the end, like a close. A venue that missed a reading keeps its previous one for up to 10 minutes (or the bucket length, if longer); a bucket where a venue read in the previous hour has nothing that recent is left out rather than served with a partial total. The same quantity, under the same name, as oi on /v1/oi/change. Each timeframe starts where readings are at least that fine, so step is always the real spacing: 1d covers the whole history, 4h starts on 2025-10-07, 1h on 2026-04-04 17:00 UTC, and 1m to 30m on 2026-05-28 19:10 UTC (2026-09-12 14:40 UTC for AVAX, HBAR, LINK, NEAR, TAO, UNI, XMR, ADA, GRAM and LTC; older readings were taken once a day, then every 4 hours, then hourly). The 82 pairs added in October 2026 have their own starts, pair by pair: 1d covers their whole history, 1h and 4h start around 2025-10-24, 30m around 2026-04-22, 15m around 2026-07-21, and 1m and 5m on the day the pair was added (2026-10-19 09:31 UTC, or 2026-10-27 18:03 UTC for the 27 latest). Read older periods at a coarser timeframe; a since_ms before the start is raised to it, and a window entirely before it returns no rows. Most recent first, or oldest first with order=asc. Follow next to read the following page (it never repeats a row).
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
since_ms | integer | — | Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range. |
until_ms | integer | — | Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next. |
limit | integer · 1–1000 | 100 | Number of rows to return, in the reading order (most recent first by default). Bounded by your plan's history window: an explicit limit (or since_ms) reaching beyond it returns 403 history_depth; without them the page simply stops at the window. |
timeframe obligatoire | string | — | Required: 1m, 5m, 15m, 30m, 1h, 4h or 1d. One row per closed bucket: for a STATE (basis, open interest) the value of its LAST minute — its close —, for a FLOW (open-interest change, liquidations, trade sizes) the total over its minutes; sample_count = minutes with data in the bucket. 1m gives one row per minute, aligned on the minute. Missing: 422 missing_parameter. |
symbol obligatoire | string | — | Trading pair, e.g. BTCUSDT. Required. The served pairs: GET /v1/symbols. Case-insensitive (btcusdt works; the envelope gives the canonical BTCUSDT). An unknown pair returns 422 invalid_symbol with the accepted list. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,oi. Unknown field: 422 unknown_field with a suggestion. |
before_ms | integer | — | Upper time bound, EXCLUSIVE, in epoch milliseconds: rows strictly before it. Pass the oldest time you received to read the previous page without repeating a row. Not combinable with until_ms (422 invalid_time_range). |
order | string | desc | Reading order: desc (most recent first, the default) or asc (oldest first, reading forward from since_ms, which is then required). Follow next to read the following page. |
4 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
[].time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Start of the bucket the row covers: a 1h bucket at 14:00 covers 14:00:00 to 14:59:59.999. |
[].oi | number | base asset quantity (BTC for BTCUSDT) | Total open interest across venues, base asset units. On a bucketed row, the value at the END of the bucket (like a close); on /v1/oi/change, the latest measurement. |
[].sample_count | integer | null | count | Number of source points in the bucket (one-minute points with data). For a state (basis, open interest) the value is the LAST of them — the bucket's close —; for a flow it is their total. |
[].is_closed | boolean | true = the row is final; false = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with ?live=1 on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades. |
Essayer
GET https://api.bytnode.com/v1/oi/history?limit=3&timeframe=1h&symbol=BTCUSDT
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/oi/history?symbol=BTCUSDT&limit=3&timeframe=1h"{
"status": "ok",
"server_time": "2026-11-08T12:51:22.320Z",
"data_type": "oi_history",
"symbol": "BTCUSDT",
"timeframe": "1h",
"market": "futures",
"step": "1h",
"data": [
{
"time": "2026-11-08T11:00:00.000Z",
"oi": 394299.2028,
"sample_count": 60,
"is_closed": true
},
{
"time": "2026-11-08T10:00:00.000Z",
"oi": 395319.37684,
"sample_count": 60,
"is_closed": true
},
{
"time": "2026-11-08T09:00:00.000Z",
"oi": 395260.81578,
"sample_count": 60,
"is_closed": true
}
],
"next": "/v1/oi/history?symbol=BTCUSDT&limit=3&timeframe=1h&before_ms=1794128400000&order=desc"
}#Liquidations
Forced liquidations across venues: individual events, cumulative long/short USD, big vs small liquidations.
GET /v1/liquidations/big-small-ratio
Big vs small liquidations. Liquidations of 100,000 USD or more versus smaller ones over the latest CLOSED bucket of timeframe (required) that had liquidations — the first row of /v1/liquidations/big-small-ratio/history for the same timeframe (time = its start, is_closed: true): counts, USD and big_small_ratio. A high ratio = large positions are being flushed.
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
timeframe obligatoire | string | — | Bucket size, required: 1m, 5m, 15m, 30m, 1h, 4h or 1d. Missing: 422 missing_parameter; other values: 422 invalid_timeframe with the accepted list. In any case (1H is 1h), except 1M: refused, since elsewhere it means a month and here 1m is one minute. |
symbol obligatoire | string | — | Trading pair, e.g. BTCUSDT. Required. The served pairs: GET /v1/symbols. Case-insensitive (btcusdt works; the envelope gives the canonical BTCUSDT). An unknown pair returns 422 invalid_symbol with the accepted list. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,big_count. Unknown field: 422 unknown_field with a suggestion. |
9 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Start of the latest closed bucket of timeframe that had at least one liquidation — the first row of /v1/liquidations/big-small-ratio/history for the same timeframe. |
big_count | integer | count | Liquidations of 100,000 USD or more. |
big_usd | number | USD | Notional of liquidations of 100,000 USD or more. |
small_count | integer | count | Liquidations below 100,000 USD. |
small_usd | number | USD | Notional of liquidations below 100,000 USD. |
big_small_ratio | number | null | big / small | big_usd / small_usd: the notional of liquidations of 100,000 USD or more DIVIDED BY that of the smaller ones (8.2 = the big ones weigh 8.2 times the small ones: a quotient, not a share). null when small_usd is 0. |
venues | string[] | Venues whose liquidations are summed in the row, by name (empty when none in the row). Rows before the first individual liquidation are imported totals: their list is the venues those totals cover. | |
sample_count | integer | null | count | Number of source points in the bucket (one-minute points with data). For a state (basis, open interest) the value is the LAST of them — the bucket's close —; for a flow it is their total. |
is_closed | boolean | true = the row is final; false = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with ?live=1 on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades. |
Essayer
GET https://api.bytnode.com/v1/liquidations/big-small-ratio?timeframe=1h&symbol=BTCUSDT
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/liquidations/big-small-ratio?symbol=BTCUSDT&timeframe=1h"{
"status": "ok",
"server_time": "2026-11-08T12:51:47.644Z",
"data_type": "liquidations_big_small_ratio",
"symbol": "BTCUSDT",
"timeframe": "1h",
"market": "futures",
"data": {
"time": "2026-11-08T11:00:00.000Z",
"big_count": 0,
"big_usd": 0,
"small_count": 63,
"small_usd": 235823.808306,
"big_small_ratio": 0,
"venues": [
"binance",
"bitget",
"bybit"
],
"sample_count": 14,
"is_closed": true
}
}GET /v1/liquidations/big-small-ratio/history
Big vs small liquidations history. One row per closed bucket of timeframe (required). History depth is a number of rows per plan, whatever the timeframe: the last 100 on Free, 500 on Traders, 1,000 on Financial, 10,000 on Startup (1,000 per page at most: follow next); a larger limit, or a bound beyond those rows, returns 403 history_depth. Most recent first, or oldest first with order=asc. Follow next to read the following page (it never repeats a row).
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
since_ms | integer | — | Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range. |
until_ms | integer | — | Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next. |
limit | integer · 1–1000 | 100 | Number of rows to return, in the reading order (most recent first by default). Bounded by your plan's history window: an explicit limit (or since_ms) reaching beyond it returns 403 history_depth; without them the page simply stops at the window. |
timeframe obligatoire | string | — | Required: 1m, 5m, 15m, 30m, 1h, 4h or 1d. One row per closed bucket: for a STATE (basis, open interest) the value of its LAST minute — its close —, for a FLOW (open-interest change, liquidations, trade sizes) the total over its minutes; sample_count = minutes with data in the bucket. 1m gives one row per minute, aligned on the minute. Missing: 422 missing_parameter. |
symbol obligatoire | string | — | Trading pair, e.g. BTCUSDT. Required. The served pairs: GET /v1/symbols. Case-insensitive (btcusdt works; the envelope gives the canonical BTCUSDT). An unknown pair returns 422 invalid_symbol with the accepted list. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,big_count. Unknown field: 422 unknown_field with a suggestion. |
before_ms | integer | — | Upper time bound, EXCLUSIVE, in epoch milliseconds: rows strictly before it. Pass the oldest time you received to read the previous page without repeating a row. Not combinable with until_ms (422 invalid_time_range). |
order | string | desc | Reading order: desc (most recent first, the default) or asc (oldest first, reading forward from since_ms, which is then required). Follow next to read the following page. |
9 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
[].time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Start of the bucket of timeframe, the value aggregating the bucket's minutes; the row covers time to time + the envelope's step (excluded). |
[].big_count | integer | count | Liquidations of 100,000 USD or more. |
[].big_usd | number | USD | Notional of liquidations of 100,000 USD or more. |
[].small_count | integer | count | Liquidations below 100,000 USD. |
[].small_usd | number | USD | Notional of liquidations below 100,000 USD. |
[].big_small_ratio | number | null | big / small | big_usd / small_usd: the notional of liquidations of 100,000 USD or more DIVIDED BY that of the smaller ones (8.2 = the big ones weigh 8.2 times the small ones: a quotient, not a share). null when small_usd is 0. |
[].venues | string[] | Venues whose liquidations are summed in the row, by name (empty when none in the row). Rows before the first individual liquidation are imported totals: their list is the venues those totals cover. | |
[].sample_count | integer | null | count | Minutes of the bucket that had at least one liquidation. |
[].is_closed | boolean | true = the row is final; false = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with ?live=1 on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades. |
Essayer
GET https://api.bytnode.com/v1/liquidations/big-small-ratio/history?limit=3&timeframe=1h&symbol=BTCUSDT
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/liquidations/big-small-ratio/history?symbol=BTCUSDT&limit=3&timeframe=1h"{
"status": "ok",
"server_time": "2026-11-08T12:51:48.183Z",
"data_type": "liquidations_big_small_ratio_history",
"symbol": "BTCUSDT",
"timeframe": "1h",
"market": "futures",
"step": "1h",
"data": [
{
"time": "2026-11-08T11:00:00.000Z",
"big_count": 0,
"big_usd": 0,
"small_count": 63,
"small_usd": 235823.808306,
"big_small_ratio": 0,
"venues": [
"binance",
"bitget",
"bybit"
],
"sample_count": 14,
"is_closed": true
},
{
"time": "2026-11-08T10:00:00.000Z",
"big_count": 0,
"big_usd": 0,
"small_count": 20,
"small_usd": 17103.37811,
"big_small_ratio": 0,
"venues": [
"binance",
"bitget",
"bybit"
],
"sample_count": 8,
"is_closed": true
},
{
"time": "2026-11-08T09:00:00.000Z",
"big_count": 0,
"big_usd": 0,
"small_count": 10,
"small_usd": 11269.26352,
"big_small_ratio": 0,
"venues": [
"binance",
"bitget",
"bybit"
],
"sample_count": 6,
"is_closed": true
}
],
"next": "/v1/liquidations/big-small-ratio/history?symbol=BTCUSDT&limit=3&timeframe=1h&before_ms=1794128400000&order=desc"
}GET /v1/liquidations/cumulative
Liquidations over the last 5 minutes. Longs and shorts liquidated, USD, all venues, over the last closed 5-minute ROLLING window, aligned on the minute: time is its END, window_start_at its start, window_s its length.
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
symbol obligatoire | string | — | Trading pair, e.g. BTCUSDT. Required. The served pairs: GET /v1/symbols. Case-insensitive (btcusdt works; the envelope gives the canonical BTCUSDT). An unknown pair returns 422 invalid_symbol with the accepted list. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,long_usd. Unknown field: 422 unknown_field with a suggestion. |
7 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Point-in-time value over a rolling window: the END of the 5-minute window, aligned on the minute. |
long_usd | number | USD | Long positions liquidated, USD. |
short_usd | number | USD | Short positions liquidated, USD. |
total_usd | number | USD | Total, USD. |
venues | any[] | Venues whose liquidations are summed in the row, by name (empty when none in the row). Rows before the first individual liquidation are imported totals: their list is the venues those totals cover. | |
window_start_at | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Start of the ROLLING window the value covers (inclusive). Only rolling-window values carry it, and their time is always the END of the window; a bucket row has no window fields (its span is the envelope's step). |
window_s | integer | null | seconds | Length of that rolling window, in whole seconds: it runs from window_start_at to time (excluded). |
Essayer
GET https://api.bytnode.com/v1/liquidations/cumulative?symbol=BTCUSDT
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/liquidations/cumulative?symbol=BTCUSDT"{
"status": "ok",
"server_time": "2026-11-08T12:51:46.248Z",
"data_type": "liquidations_cumulative",
"symbol": "BTCUSDT",
"market": "futures",
"data": {
"time": "2026-11-08T12:51:00.000Z",
"long_usd": 0,
"short_usd": 0,
"total_usd": 0,
"venues": [],
"window_start_at": "2026-11-08T12:46:00.000Z",
"window_s": 300
}
}GET /v1/liquidations/cumulative/history
Cumulative liquidations history. One row per closed bucket of timeframe (required): the longs and shorts liquidated during the WHOLE bucket, USD, all venues (0 when none). The series starts at the first liquidation recorded for the symbol. Most recent first, or oldest first with order=asc. Follow next to read the following page (it never repeats a row).
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
since_ms | integer | — | Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range. |
until_ms | integer | — | Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next. |
limit | integer · 1–1000 | 100 | Number of rows to return, in the reading order (most recent first by default). Bounded by your plan's history window: an explicit limit (or since_ms) reaching beyond it returns 403 history_depth; without them the page simply stops at the window. |
timeframe obligatoire | string | — | Required: 1m, 5m, 15m, 30m, 1h, 4h or 1d. One row per closed bucket, holding the totals of the WHOLE bucket. Missing: 422 missing_parameter. |
symbol obligatoire | string | — | Trading pair, e.g. BTCUSDT. Required. The served pairs: GET /v1/symbols. Case-insensitive (btcusdt works; the envelope gives the canonical BTCUSDT). An unknown pair returns 422 invalid_symbol with the accepted list. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,long_usd. Unknown field: 422 unknown_field with a suggestion. |
before_ms | integer | — | Upper time bound, EXCLUSIVE, in epoch milliseconds: rows strictly before it. Pass the oldest time you received to read the previous page without repeating a row. Not combinable with until_ms (422 invalid_time_range). |
order | string | desc | Reading order: desc (most recent first, the default) or asc (oldest first, reading forward from since_ms, which is then required). Follow next to read the following page. |
7 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
[].time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Start of the bucket. The row covers the WHOLE bucket, from time to time + the envelope's step (excluded). |
[].long_usd | number | USD | Long positions liquidated, USD. |
[].short_usd | number | USD | Short positions liquidated, USD. |
[].total_usd | number | USD | Total, USD. |
[].sample_count | integer | null | count | Number of source points in the bucket (one-minute points with data). For a state (basis, open interest) the value is the LAST of them — the bucket's close —; for a flow it is their total. |
[].venues | string[] | Venues whose liquidations are summed in the row, by name (empty when none in the row). Rows before the first individual liquidation are imported totals: their list is the venues those totals cover. | |
[].is_closed | boolean | true = the row is final; false = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with ?live=1 on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades. |
Essayer
GET https://api.bytnode.com/v1/liquidations/cumulative/history?limit=3&timeframe=1h&symbol=BTCUSDT
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/liquidations/cumulative/history?symbol=BTCUSDT&limit=3&timeframe=1h"{
"status": "ok",
"server_time": "2026-11-08T12:51:47.130Z",
"data_type": "liquidations_cumulative_history",
"symbol": "BTCUSDT",
"timeframe": "1h",
"market": "futures",
"step": "1h",
"data": [
{
"time": "2026-11-08T11:00:00.000Z",
"long_usd": 103784.901736,
"short_usd": 132038.90657,
"total_usd": 235823.808306,
"sample_count": 60,
"venues": [
"binance",
"bitget",
"bybit"
],
"is_closed": true
},
{
"time": "2026-11-08T10:00:00.000Z",
"long_usd": 13299.91061,
"short_usd": 3803.4675,
"total_usd": 17103.37811,
"sample_count": 60,
"venues": [
"binance",
"bitget",
"bybit"
],
"is_closed": true
},
{
"time": "2026-11-08T09:00:00.000Z",
"long_usd": 9289.37912,
"short_usd": 1979.8844,
"total_usd": 11269.26352,
"sample_count": 60,
"venues": [
"binance",
"bitget",
"bybit"
],
"is_closed": true
}
],
"next": "/v1/liquidations/cumulative/history?symbol=BTCUSDT&limit=3&timeframe=1h&before_ms=1794128400000&order=desc"
}GET /v1/liquidations/events
Individual liquidations. Forced liquidations across futures venues, one row per event, most recent first. limit is a number of events (with min_usd: events of at least that size), from the latest: your plan reads the latest 100 (Free), 500 (Traders), 1,000 (Financial) or 10,000 (Startup) events (liquidations_events_count of GET /v1/limits); a larger limit is refused with 403 history_depth. 10,000 is the route's maximum. No date bounds or pagination: the WebSocket channel liquidations.<SYMBOL> carries them live.
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
limit | integer · 1–10000 | 100 | Number of rows to return, in the reading order (most recent first by default). Bounded by your plan's history window: an explicit limit (or since_ms) reaching beyond it returns 403 history_depth; without them the page simply stops at the window. |
min_usd | number | — | Optional minimum notional in USD: only liquidations of at least this size are returned. limit always counts events. |
symbol obligatoire | string | — | Trading pair, e.g. BTCUSDT. Required. The served pairs: GET /v1/symbols. Case-insensitive (btcusdt works; the envelope gives the canonical BTCUSDT). An unknown pair returns 422 invalid_symbol with the accepted list. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,side. Unknown field: 422 unknown_field with a suggestion. |
6 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
[].time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Instant of the liquidation, as stated by the venue (milliseconds). |
[].side | string | long (a long position was liquidated: forced sell) or short (forced buy). | |
[].price | number | quote currency (USDT for BTCUSDT) | Price. |
[].quantity | number | base asset quantity (BTC for BTCUSDT) | Quantity traded or liquidated, in base asset units. |
[].value_usd | number | USD | Notional value: price × quantity, in the pair's quote currency (USDT for BTCUSDT), taken as USD. |
[].venue | string | null | Venue where the liquidation happened (liquidations name their venues). |
Essayer
GET https://api.bytnode.com/v1/liquidations/events?limit=3&symbol=BTCUSDT
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/liquidations/events?symbol=BTCUSDT&limit=3"{
"status": "ok",
"server_time": "2026-11-08T12:51:22.981Z",
"data_type": "liquidations_events",
"symbol": "BTCUSDT",
"market": "futures",
"data": [
{
"time": "2026-11-08T12:45:45.686Z",
"side": "long",
"price": 75699.1,
"quantity": 0.001,
"value_usd": 75.6991,
"venue": "bybit"
},
{
"time": "2026-11-08T12:41:54.072Z",
"side": "long",
"price": 75595.5,
"quantity": 0.001,
"value_usd": 75.5955,
"venue": "binance"
},
{
"time": "2026-11-08T12:41:52.209Z",
"side": "long",
"price": 75596.6,
"quantity": 0.043,
"value_usd": 3250.6538,
"venue": "binance"
}
]
}#Tokenomics & sentiment
Supply, market cap and FDV derived from the live price; total crypto market cap and dominance; sentiment: two Fear & Greed indices (alternative.me and CoinMarketCap), the Altcoin Season Index and the CoinMarketCap 20 and 100 indices with their constituents.
GET /v1/altcoin-season
Altcoin Season Index. CoinMarketCap's Altcoin Season Index, from 0 (bitcoin season) to 100 (altcoin season), with the altcoin market capitalisation and the 1-year high and low.
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,value. Unknown field: 422 unknown_field with a suggestion. |
7 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Point-in-time value: the instant of the measurement (when the source was read). |
value | integer | score from 0 to 100 | Altcoin Season Index (CoinMarketCap): how many of the top altcoins outperformed BTC over the last 90 days. High = altcoin season, low = bitcoin season. |
year_low | integer | score from 0 to 100 | Lowest value of the index over the last year. |
year_high | integer | score from 0 to 100 | Highest value of the index over the last year. |
year_low_at | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Day of that lowest value, at midnight UTC. |
year_high_at | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Day of that highest value, at midnight UTC. |
altcoin_market_cap_usd | number | USD | Total market capitalisation of the altcoins (excluding BTC). |
Essayer
GET https://api.bytnode.com/v1/altcoin-season
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/altcoin-season"{
"status": "ok",
"server_time": "2026-11-08T12:51:53.925Z",
"data_type": "altcoin_season",
"data": {
"time": "2026-11-08T12:38:27.000Z",
"value": 38,
"year_low": 14,
"year_high": 64,
"year_low_at": "2025-12-19T00:00:00.000Z",
"year_high_at": "2026-09-27T00:00:00.000Z",
"altcoin_market_cap_usd": 1016577631975
}
}GET /v1/altcoin-season/history
Altcoin Season history. One point per day, at midnight UTC. Most recent first, or oldest first with order=asc. Follow next to read the following page (it never repeats a row).
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
since_ms | integer | — | Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range. |
until_ms | integer | — | Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next. |
limit | integer · 1–1000 | 100 | Number of rows to return, in the reading order (most recent first by default). Bounded by your plan's history window: an explicit limit (or since_ms) reaching beyond it returns 403 history_depth; without them the page simply stops at the window. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,value. Unknown field: 422 unknown_field with a suggestion. |
before_ms | integer | — | Upper time bound, EXCLUSIVE, in epoch milliseconds: rows strictly before it. Pass the oldest time you received to read the previous page without repeating a row. Not combinable with until_ms (422 invalid_time_range). |
order | string | desc | Reading order: desc (most recent first, the default) or asc (oldest first, reading forward from since_ms, which is then required). Follow next to read the following page. |
4 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
[].time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | The day the value refers to, at midnight UTC. |
[].value | integer | score from 0 to 100 | Altcoin Season Index (CoinMarketCap): how many of the top altcoins outperformed BTC over the last 90 days. High = altcoin season, low = bitcoin season. |
[].altcoin_market_cap_usd | number | USD | Total market capitalisation of the altcoins (excluding BTC). |
[].is_closed | boolean | true = the row is final; false = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with ?live=1 on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades. |
Essayer
GET https://api.bytnode.com/v1/altcoin-season/history?limit=3
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/altcoin-season/history?limit=3"{
"status": "ok",
"server_time": "2026-11-08T12:51:54.427Z",
"data_type": "altcoin_season_history",
"step": "1d",
"data": [
{
"time": "2026-11-07T00:00:00.000Z",
"value": 38,
"altcoin_market_cap_usd": 1020681400273,
"is_closed": true
},
{
"time": "2026-11-06T00:00:00.000Z",
"value": 44,
"altcoin_market_cap_usd": 1018479209349,
"is_closed": true
},
{
"time": "2026-11-05T00:00:00.000Z",
"value": 45,
"altcoin_market_cap_usd": 1070513345158,
"is_closed": true
}
],
"next": "/v1/altcoin-season/history?limit=3&before_ms=1793836800000&order=desc"
}GET /v1/fear-greed
Crypto Fear & Greed Index. Daily index from 0 (extreme fear) to 100 (extreme greed).
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,value. Unknown field: 422 unknown_field with a suggestion. |
3 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | The day the value refers to, at midnight UTC. |
value | integer | score from 0 to 100 | Crypto Fear & Greed Index (alternative.me). 0 = extreme fear, 100 = extreme greed. |
label | string | Label of the value, from alternative.me's scale: extreme_fear, fear, neutral, greed or extreme_greed (snake_case, like every label of the API). |
Essayer
GET https://api.bytnode.com/v1/fear-greed
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/fear-greed"{
"status": "ok",
"server_time": "2026-11-08T12:51:51.873Z",
"data_type": "fear_greed",
"data": {
"time": "2026-11-08T00:00:00.000Z",
"value": 28,
"label": "fear"
}
}GET /v1/fear-greed/cmc
CMC Fear & Greed Index. CoinMarketCap's Crypto Fear & Greed Index, from 0 (extreme fear) to 100 (extreme greed): a different index from /v1/fear-greed, refreshed during the day.
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,value. Unknown field: 422 unknown_field with a suggestion. |
3 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Point-in-time value: the instant of the measurement (when the source was read). |
value | integer | score from 0 to 100 | CMC Crypto Fear & Greed Index (CoinMarketCap), a different index from /v1/fear-greed (alternative.me). 0 = extreme fear, 100 = extreme greed. |
label | string | Label of the value, from CoinMarketCap's scale: extreme_fear, fear, neutral, greed or extreme_greed (snake_case, like every label of the API). |
Essayer
GET https://api.bytnode.com/v1/fear-greed/cmc
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/fear-greed/cmc"{
"status": "ok",
"server_time": "2026-11-08T12:51:52.886Z",
"data_type": "fear_greed_cmc",
"data": {
"time": "2026-11-08T12:38:10.041Z",
"value": 32,
"label": "fear"
}
}GET /v1/fear-greed/cmc/history
CMC Fear & Greed history. One point per day, at midnight UTC. Most recent first, or oldest first with order=asc. Follow next to read the following page (it never repeats a row).
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
since_ms | integer | — | Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range. |
until_ms | integer | — | Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next. |
limit | integer · 1–1000 | 100 | Number of rows to return, in the reading order (most recent first by default). Bounded by your plan's history window: an explicit limit (or since_ms) reaching beyond it returns 403 history_depth; without them the page simply stops at the window. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,value. Unknown field: 422 unknown_field with a suggestion. |
before_ms | integer | — | Upper time bound, EXCLUSIVE, in epoch milliseconds: rows strictly before it. Pass the oldest time you received to read the previous page without repeating a row. Not combinable with until_ms (422 invalid_time_range). |
order | string | desc | Reading order: desc (most recent first, the default) or asc (oldest first, reading forward from since_ms, which is then required). Follow next to read the following page. |
4 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
[].time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | The day the value refers to, at midnight UTC. |
[].value | integer | score from 0 to 100 | CMC Crypto Fear & Greed Index (CoinMarketCap), a different index from /v1/fear-greed (alternative.me). 0 = extreme fear, 100 = extreme greed. |
[].label | string | Label of the value, from CoinMarketCap's scale: extreme_fear, fear, neutral, greed or extreme_greed (snake_case, like every label of the API). | |
[].is_closed | boolean | true = the row is final; false = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with ?live=1 on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades. |
Essayer
GET https://api.bytnode.com/v1/fear-greed/cmc/history?limit=3
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/fear-greed/cmc/history?limit=3"{
"status": "ok",
"server_time": "2026-11-08T12:51:53.409Z",
"data_type": "fear_greed_cmc_history",
"step": "1d",
"data": [
{
"time": "2026-11-07T00:00:00.000Z",
"value": 32,
"label": "fear",
"is_closed": true
},
{
"time": "2026-11-06T00:00:00.000Z",
"value": 31,
"label": "fear",
"is_closed": true
},
{
"time": "2026-11-05T00:00:00.000Z",
"value": 32,
"label": "fear",
"is_closed": true
}
],
"next": "/v1/fear-greed/cmc/history?limit=3&before_ms=1793836800000&order=desc"
}GET /v1/fear-greed/history
Fear & Greed history. One point per day. Most recent first, or oldest first with order=asc. Follow next to read the following page (it never repeats a row).
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
since_ms | integer | — | Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range. |
until_ms | integer | — | Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next. |
limit | integer · 1–1000 | 100 | Number of rows to return, in the reading order (most recent first by default). Bounded by your plan's history window: an explicit limit (or since_ms) reaching beyond it returns 403 history_depth; without them the page simply stops at the window. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,value. Unknown field: 422 unknown_field with a suggestion. |
before_ms | integer | — | Upper time bound, EXCLUSIVE, in epoch milliseconds: rows strictly before it. Pass the oldest time you received to read the previous page without repeating a row. Not combinable with until_ms (422 invalid_time_range). |
order | string | desc | Reading order: desc (most recent first, the default) or asc (oldest first, reading forward from since_ms, which is then required). Follow next to read the following page. |
4 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
[].time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | The day the value refers to, at midnight UTC. |
[].value | integer | score from 0 to 100 | Crypto Fear & Greed Index (alternative.me). 0 = extreme fear, 100 = extreme greed. |
[].label | string | Label of the value, from alternative.me's scale: extreme_fear, fear, neutral, greed or extreme_greed (snake_case, like every label of the API). | |
[].is_closed | boolean | true = the row is final; false = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with ?live=1 on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades. |
Essayer
GET https://api.bytnode.com/v1/fear-greed/history?limit=3
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/fear-greed/history?limit=3"{
"status": "ok",
"server_time": "2026-11-08T12:51:52.379Z",
"data_type": "fear_greed_history",
"step": "1d",
"data": [
{
"time": "2026-11-08T00:00:00.000Z",
"value": 28,
"label": "fear",
"is_closed": true
},
{
"time": "2026-11-07T00:00:00.000Z",
"value": 25,
"label": "extreme_fear",
"is_closed": true
},
{
"time": "2026-11-06T00:00:00.000Z",
"value": 28,
"label": "fear",
"is_closed": true
}
],
"next": "/v1/fear-greed/history?limit=3&before_ms=1793923200000&order=desc"
}GET /v1/global
Total crypto market. Total market capitalisation, 24 h volume and dominance of BTC, ETH and the rest.
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,market_cap_total_usd. Unknown field: 422 unknown_field with a suggestion. |
7 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Point-in-time value: the instant the source states for its measurement (often the last millisecond of its minute, …:59.999Z). |
market_cap_total_usd | number | USD | Total crypto market capitalisation. |
volume_total_usd | number | USD | Total traded volume, USD. |
btc_dominance_pct | number | percent (58.5 = 58.5 %) | Bitcoin share of the total market cap. |
eth_dominance_pct | number | percent (58.5 = 58.5 %) | Ether share of the total market cap. |
others_dominance_pct | number | percent (58.5 = 58.5 %) | Share of every other asset. |
active_cryptocurrency_count | integer | count | Number of tracked crypto assets. |
Essayer
GET https://api.bytnode.com/v1/global
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/global"{
"status": "ok",
"server_time": "2026-11-08T12:51:50.834Z",
"data_type": "global",
"data": {
"time": "2026-11-08T12:49:59.999Z",
"market_cap_total_usd": 2540997033686,
"volume_total_usd": 28759719837.1,
"btc_dominance_pct": 60.0225582475,
"eth_dominance_pct": 10.7494938056,
"others_dominance_pct": 29.2279479469,
"active_cryptocurrency_count": 8024
}
}GET /v1/global/history
Total crypto market history. Most recent first, or oldest first with order=asc. Follow next to read the following page (it never repeats a row).
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
since_ms | integer | — | Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range. |
until_ms | integer | — | Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next. |
limit | integer · 1–1000 | 100 | Number of rows to return, in the reading order (most recent first by default). Bounded by your plan's history window: an explicit limit (or since_ms) reaching beyond it returns 403 history_depth; without them the page simply stops at the window. |
timeframe | string | — | Optional row step: 1h, 4h or 1d — the LAST reading of each closed bucket, dated at the start of the bucket (the bucket in progress is not served). Without it: one row per reading of the source. Other values: 422 invalid_timeframe. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,market_cap_total_usd. Unknown field: 422 unknown_field with a suggestion. |
before_ms | integer | — | Upper time bound, EXCLUSIVE, in epoch milliseconds: rows strictly before it. Pass the oldest time you received to read the previous page without repeating a row. Not combinable with until_ms (422 invalid_time_range). |
order | string | desc | Reading order: desc (most recent first, the default) or asc (oldest first, reading forward from since_ms, which is then required). Follow next to read the following page. |
8 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
[].time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | The instant the source states for each measurement. |
[].market_cap_total_usd | number | USD | Total crypto market capitalisation. |
[].volume_total_usd | number | USD | Total traded volume, USD. |
[].btc_dominance_pct | number | percent (58.5 = 58.5 %) | Bitcoin share of the total market cap. |
[].eth_dominance_pct | number | percent (58.5 = 58.5 %) | Ether share of the total market cap. |
[].others_dominance_pct | number | percent (58.5 = 58.5 %) | Share of every other asset. |
[].active_cryptocurrency_count | integer | count | Number of tracked crypto assets. |
[].is_closed | boolean | true = the row is final; false = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with ?live=1 on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades. |
Essayer
GET https://api.bytnode.com/v1/global/history?limit=3
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/global/history?limit=3"{
"status": "ok",
"server_time": "2026-11-08T12:51:51.346Z",
"data_type": "global_history",
"data": [
{
"time": "2026-11-08T12:49:59.999Z",
"market_cap_total_usd": 2540997033686,
"volume_total_usd": 28759719837.1,
"btc_dominance_pct": 60.0225582475,
"eth_dominance_pct": 10.7494938056,
"others_dominance_pct": 29.2279479469,
"active_cryptocurrency_count": 8024,
"is_closed": true
},
{
"time": "2026-11-08T12:44:59.999Z",
"market_cap_total_usd": 2540581605646,
"volume_total_usd": 28847290265.5,
"btc_dominance_pct": 60.0172539918,
"eth_dominance_pct": 10.748200569,
"others_dominance_pct": 29.2345454392,
"active_cryptocurrency_count": 8024,
"is_closed": true
},
{
"time": "2026-11-08T12:39:59.999Z",
"market_cap_total_usd": 2541629897793,
"volume_total_usd": 28901371058.8,
"btc_dominance_pct": 60.0125229019,
"eth_dominance_pct": 10.7482306618,
"others_dominance_pct": 29.2392464363,
"active_cryptocurrency_count": 8024,
"is_closed": true
}
],
"next": "/v1/global/history?limit=3&before_ms=1794141599999&order=desc"
}GET /v1/indices/cmc100
CoinMarketCap 100 Index. Value of the CMC100 index (the 100 largest crypto assets), its 24 h change and its constituents with their weight.
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,value. Unknown field: 422 unknown_field with a suggestion. |
7 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Point-in-time value: the instant of the measurement (when the source was read). |
value | number | index points | CoinMarketCap 100 Index: the 100 largest crypto assets, weighted by market capitalisation. |
constituents | object[] | The assets of the index, with their weight. | |
constituents[].name | string | Asset name (Bitcoin). | |
constituents[].asset | string | Asset symbol (BTC). | |
constituents[].weight_pct | number | percent (58.5 = 58.5 %) | Weight of the asset in the index (67.9 = 67.9 %). |
change_24h_pct | number | percent (58.5 = 58.5 %) | Change of the index over the last 24 hours. |
Essayer
GET https://api.bytnode.com/v1/indices/cmc100
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/indices/cmc100"{
"status": "ok",
"server_time": "2026-11-08T12:51:55.996Z",
"data_type": "indices_cmc100",
"data": {
"time": "2026-11-08T12:40:00.000Z",
"value": 148.15,
"constituents": [
{
"name": "Bitcoin",
"asset": "BTC",
"weight_pct": 67.89
},
{
"name": "Ethereum",
"asset": "ETH",
"weight_pct": 12.16
},
{
"name": "BNB",
"asset": "BNB",
"weight_pct": 4.08
}
],
"change_24h_pct": -0.09
}
}GET /v1/indices/cmc100/history
CoinMarketCap 100 Index history. One value per day, at midnight UTC. Most recent first, or oldest first with order=asc. Follow next to read the following page (it never repeats a row).
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
since_ms | integer | — | Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range. |
until_ms | integer | — | Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next. |
limit | integer · 1–1000 | 100 | Number of rows to return, in the reading order (most recent first by default). Bounded by your plan's history window: an explicit limit (or since_ms) reaching beyond it returns 403 history_depth; without them the page simply stops at the window. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,value. Unknown field: 422 unknown_field with a suggestion. |
before_ms | integer | — | Upper time bound, EXCLUSIVE, in epoch milliseconds: rows strictly before it. Pass the oldest time you received to read the previous page without repeating a row. Not combinable with until_ms (422 invalid_time_range). |
order | string | desc | Reading order: desc (most recent first, the default) or asc (oldest first, reading forward from since_ms, which is then required). Follow next to read the following page. |
3 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
[].time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | The day the value refers to, at midnight UTC. |
[].value | number | index points | CoinMarketCap 100 Index: the 100 largest crypto assets, weighted by market capitalisation. |
[].is_closed | boolean | true = the row is final; false = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with ?live=1 on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades. |
Essayer
GET https://api.bytnode.com/v1/indices/cmc100/history?limit=3
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/indices/cmc100/history?limit=3"{
"status": "ok",
"server_time": "2026-11-08T12:51:56.498Z",
"data_type": "indices_cmc100_history",
"step": "1d",
"data": [
{
"time": "2026-11-08T00:00:00.000Z",
"value": 148.07,
"is_closed": true
},
{
"time": "2026-11-07T00:00:00.000Z",
"value": 148.26,
"is_closed": true
},
{
"time": "2026-11-06T00:00:00.000Z",
"value": 148.42,
"is_closed": true
}
],
"next": "/v1/indices/cmc100/history?limit=3&before_ms=1793923200000&order=desc"
}GET /v1/indices/cmc20
CoinMarketCap 20 Index. Value of the CMC20 index (the 20 largest crypto assets), its 24 h change and its constituents with their weight.
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,value. Unknown field: 422 unknown_field with a suggestion. |
7 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Point-in-time value: the instant of the measurement (when the source was read). |
value | number | index points | CoinMarketCap 20 Index: the 20 largest crypto assets, weighted by market capitalisation. |
constituents | object[] | The assets of the index, with their weight. | |
constituents[].name | string | Asset name (Bitcoin). | |
constituents[].asset | string | Asset symbol (BTC). | |
constituents[].weight_pct | number | percent (58.5 = 58.5 %) | Weight of the asset in the index (70.9 = 70.9 %). |
change_24h_pct | number | percent (58.5 = 58.5 %) | Change of the index over the last 24 hours. |
Essayer
GET https://api.bytnode.com/v1/indices/cmc20
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/indices/cmc20"{
"status": "ok",
"server_time": "2026-11-08T12:51:54.955Z",
"data_type": "indices_cmc20",
"data": {
"time": "2026-11-08T12:42:35.000Z",
"value": 154.95,
"constituents": [
{
"name": "Bitcoin",
"asset": "BTC",
"weight_pct": 70.89
},
{
"name": "Ethereum",
"asset": "ETH",
"weight_pct": 12.7
},
{
"name": "BNB",
"asset": "BNB",
"weight_pct": 4.27
}
],
"change_24h_pct": -0.05
}
}GET /v1/indices/cmc20/history
CoinMarketCap 20 Index history. One value per day, at midnight UTC. Most recent first, or oldest first with order=asc. Follow next to read the following page (it never repeats a row).
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
since_ms | integer | — | Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range. |
until_ms | integer | — | Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next. |
limit | integer · 1–1000 | 100 | Number of rows to return, in the reading order (most recent first by default). Bounded by your plan's history window: an explicit limit (or since_ms) reaching beyond it returns 403 history_depth; without them the page simply stops at the window. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,value. Unknown field: 422 unknown_field with a suggestion. |
before_ms | integer | — | Upper time bound, EXCLUSIVE, in epoch milliseconds: rows strictly before it. Pass the oldest time you received to read the previous page without repeating a row. Not combinable with until_ms (422 invalid_time_range). |
order | string | desc | Reading order: desc (most recent first, the default) or asc (oldest first, reading forward from since_ms, which is then required). Follow next to read the following page. |
3 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
[].time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | The day the value refers to, at midnight UTC. |
[].value | number | index points | CoinMarketCap 20 Index: the 20 largest crypto assets, weighted by market capitalisation. |
[].is_closed | boolean | true = the row is final; false = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with ?live=1 on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades. |
Essayer
GET https://api.bytnode.com/v1/indices/cmc20/history?limit=3
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/indices/cmc20/history?limit=3"{
"status": "ok",
"server_time": "2026-11-08T12:51:55.468Z",
"data_type": "indices_cmc20_history",
"step": "1d",
"data": [
{
"time": "2026-11-08T00:00:00.000Z",
"value": 154.87,
"is_closed": true
},
{
"time": "2026-11-07T00:00:00.000Z",
"value": 155.05,
"is_closed": true
},
{
"time": "2026-11-06T00:00:00.000Z",
"value": 155.31,
"is_closed": true
}
],
"next": "/v1/indices/cmc20/history?limit=3&before_ms=1793923200000&order=desc"
}GET /v1/tokenomics
Supply, market cap and FDV. Circulating, total and max supply, with market cap and FDV derived from the latest price at request time (pegged at 1 for stablecoins, FDV null).
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
symbol obligatoire | string | — | Trading pair, e.g. BTCUSDT. Required. The served pairs: GET /v1/symbols. Case-insensitive (btcusdt works; the envelope gives the canonical BTCUSDT). An unknown pair returns 422 invalid_symbol with the accepted list. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,circulating_supply. Unknown field: 422 unknown_field with a suggestion. |
8 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Point-in-time value: the instant of the measurement (when the source was read). |
circulating_supply | number | null | coins | Coins in circulation. |
total_supply | number | null | coins | Total coins issued (circulating + locked), net of burns. |
max_supply | number | null | coins | Hard cap on supply. null = no cap. |
price_usd | number | USD | Price used for market_cap_usd and fdv_usd: the close of the latest closed one-minute candle (the USDT price of the pair, read as USD), refreshed every minute. Not the latest trade price: that is the price of /v1/price-change, i.e. the close of /v1/klines?live=1. |
priced_at | date-time | null | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Instant of price_usd (the row's time is the instant of the supply data). null when the price is the stablecoin peg. |
market_cap_usd | number | null | USD | circulating_supply × current price, in USD, derived at request time. |
fdv_usd | number | null | USD | Fully diluted valuation: max_supply (or total_supply if uncapped) × price. null for stablecoins. |
Essayer
GET https://api.bytnode.com/v1/tokenomics?symbol=BTCUSDT
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/tokenomics?symbol=BTCUSDT"{
"status": "ok",
"server_time": "2026-11-08T12:51:49.782Z",
"data_type": "tokenomics",
"symbol": "BTCUSDT",
"data": {
"time": "2026-11-08T12:15:33.255Z",
"circulating_supply": 20109525,
"total_supply": 20109525,
"max_supply": 21000000,
"price_usd": 75942.07,
"priced_at": "2026-11-08T12:49:00.000Z",
"market_cap_usd": 1527158955217,
"fdv_usd": 1594783470000
}
}GET /v1/tokenomics/history
Supply and market cap history. One row per day. Most recent first, or oldest first with order=asc. Follow next to read the following page (it never repeats a row).
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
since_ms | integer | — | Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range. |
until_ms | integer | — | Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next. |
limit | integer · 1–1000 | 100 | Number of rows to return, in the reading order (most recent first by default). Bounded by your plan's history window: an explicit limit (or since_ms) reaching beyond it returns 403 history_depth; without them the page simply stops at the window. |
symbol obligatoire | string | — | Trading pair, e.g. BTCUSDT. Required. The served pairs: GET /v1/symbols. Case-insensitive (btcusdt works; the envelope gives the canonical BTCUSDT). An unknown pair returns 422 invalid_symbol with the accepted list. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,price_usd. Unknown field: 422 unknown_field with a suggestion. |
before_ms | integer | — | Upper time bound, EXCLUSIVE, in epoch milliseconds: rows strictly before it. Pass the oldest time you received to read the previous page without repeating a row. Not combinable with until_ms (422 invalid_time_range). |
order | string | desc | Reading order: desc (most recent first, the default) or asc (oldest first, reading forward from since_ms, which is then required). Follow next to read the following page. |
8 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
[].time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | The day the value refers to, at midnight UTC. |
[].price_usd | number | USD | Daily closing price used for the derived values. |
[].circulating_supply | number | null | coins | Coins in circulation. |
[].total_supply | number | null | coins | Total coins issued (circulating + locked), net of burns. |
[].max_supply | number | null | coins | Hard cap on supply. null = no cap. |
[].market_cap_usd | number | null | USD | circulating_supply × current price, in USD, derived at request time. |
[].fdv_usd | number | null | USD | Fully diluted valuation: max_supply (or total_supply if uncapped) × price. null for stablecoins. |
[].is_closed | boolean | true = the row is final; false = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with ?live=1 on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades. |
Essayer
GET https://api.bytnode.com/v1/tokenomics/history?limit=3&symbol=BTCUSDT
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/tokenomics/history?symbol=BTCUSDT&limit=3"{
"status": "ok",
"server_time": "2026-11-08T12:51:50.306Z",
"data_type": "tokenomics_history",
"symbol": "BTCUSDT",
"step": "1d",
"data": [
{
"time": "2026-11-07T00:00:00.000Z",
"price_usd": 75867.59,
"circulating_supply": 20109328,
"total_supply": 20109328,
"max_supply": 21000000,
"market_cap_usd": 1525646251880,
"fdv_usd": 1593219390000,
"is_closed": true
},
{
"time": "2026-11-06T00:00:00.000Z",
"price_usd": 75844,
"circulating_supply": 20107621,
"total_supply": 20107621,
"max_supply": 21000000,
"market_cap_usd": 1525042407124,
"fdv_usd": 1592724000000,
"is_closed": true
},
{
"time": "2026-11-05T00:00:00.000Z",
"price_usd": 76088.01,
"circulating_supply": 20105365,
"total_supply": 20105365,
"max_supply": 21000000,
"market_cap_usd": 1529777213174,
"fdv_usd": 1597848210000,
"is_closed": true
}
],
"next": "/v1/tokenomics/history?symbol=BTCUSDT&limit=3&before_ms=1793836800000&order=desc"
}#Macro
Daily FRED series (rates, inflation, liquidity, commodities, the VIX, US indices), intraday macro candles (ICE dollar index, EUR/USD, USD/JPY, gold, WTI oil), and derived crypto-macro signals: net liquidity, BTC correlations, macro momentum, risk-on/risk-off score.
GET /v1/macro
Latest value of one macro series. Latest value of ONE FRED series (series required); the latest value of every series is /v1/macro/series.
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
series obligatoire | string | — | FRED series id (e.g. DGS10). Required. The latest value of every series: GET /v1/macro/series. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,category. Unknown field: 422 unknown_field with a suggestion. |
6 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | The day of the observation, at midnight UTC. |
category | string | Series category. | |
name | string | Human-readable name of the series. | |
frequency | string | Publication frequency of the source (daily, weekly, monthly). | |
units | string | Unit of value as published by the source. | |
value | number | see `units` | Latest value of the series, in the unit given by units. |
Essayer
GET https://api.bytnode.com/v1/macro?series=DGS10
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/macro?series=DGS10"{
"status": "ok",
"server_time": "2026-11-08T12:51:57.018Z",
"data_type": "macro",
"series": "DGS10",
"data": {
"time": "2026-11-05T00:00:00.000Z",
"category": "rates",
"name": "Treasury 10Y",
"frequency": "daily",
"units": "%",
"value": 4.84
}
}GET /v1/macro/correlations
BTC correlation with macro. Rolling Pearson correlation of BTC daily returns with the dollar index, the S&P 500, gold and the VIX, over 30 and 90 days.
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,oldest_input_date. Unknown field: 422 unknown_field with a suggestion. |
40 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Point-in-time value: the last date used by the window (at the top level, the most recent of all windows; see oldest_input_date). |
oldest_input_date | date | calendar date (YYYY-MM-DD) | Date of the OLDEST input the value uses (a monthly series lags a daily one): the value cannot be fresher than this input. time is the most recent input; each component carries its own date. |
method | string | How the value is computed. | |
correlations | object | Pearson correlation from -1 to 1, per macro series and window, with sample_count = number of common days. | |
correlations.dxy | object | Pearson correlation of daily returns against BTC over the last dxy, from -1 to 1. | |
correlations.dxy.30d | object | Pearson correlation of daily returns against BTC over the last 30d, from -1 to 1. | |
correlations.dxy.30d.time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Point-in-time value: the last date used by the window (at the top level, the most recent of all windows; see oldest_input_date). |
correlations.dxy.30d.correlation | number | from -1 to 1 | Pearson correlation of daily returns. |
correlations.dxy.30d.sample_count | integer | null | count | Number of days used. |
correlations.dxy.90d | object | Pearson correlation of daily returns against BTC over the last 90d, from -1 to 1. | |
correlations.dxy.90d.time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Point-in-time value: the last date used by the window (at the top level, the most recent of all windows; see oldest_input_date). |
correlations.dxy.90d.correlation | number | from -1 to 1 | Pearson correlation of daily returns. |
correlations.dxy.90d.sample_count | integer | null | count | Number of days used. |
correlations.sp500 | object | Pearson correlation of daily returns against BTC over the last sp500, from -1 to 1. | |
correlations.sp500.30d | object | Pearson correlation of daily returns against BTC over the last 30d, from -1 to 1. | |
correlations.sp500.30d.time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Point-in-time value: the last date used by the window (at the top level, the most recent of all windows; see oldest_input_date). |
correlations.sp500.30d.correlation | number | from -1 to 1 | Pearson correlation of daily returns. |
correlations.sp500.30d.sample_count | integer | null | count | Number of days used. |
correlations.sp500.90d | object | Pearson correlation of daily returns against BTC over the last 90d, from -1 to 1. | |
correlations.sp500.90d.time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Point-in-time value: the last date used by the window (at the top level, the most recent of all windows; see oldest_input_date). |
correlations.sp500.90d.correlation | number | from -1 to 1 | Pearson correlation of daily returns. |
correlations.sp500.90d.sample_count | integer | null | count | Number of days used. |
correlations.gold | object | Pearson correlation of daily returns against BTC over the last gold, from -1 to 1. | |
correlations.gold.30d | object | Pearson correlation of daily returns against BTC over the last 30d, from -1 to 1. | |
correlations.gold.30d.time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Point-in-time value: the last date used by the window (at the top level, the most recent of all windows; see oldest_input_date). |
correlations.gold.30d.correlation | number | from -1 to 1 | Pearson correlation of daily returns. |
correlations.gold.30d.sample_count | integer | null | count | Number of days used. |
correlations.gold.90d | object | Pearson correlation of daily returns against BTC over the last 90d, from -1 to 1. | |
correlations.gold.90d.time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Point-in-time value: the last date used by the window (at the top level, the most recent of all windows; see oldest_input_date). |
correlations.gold.90d.correlation | number | from -1 to 1 | Pearson correlation of daily returns. |
correlations.gold.90d.sample_count | integer | null | count | Number of days used. |
correlations.vix | object | Pearson correlation of daily returns against BTC over the last vix, from -1 to 1. | |
correlations.vix.30d | object | Pearson correlation of daily returns against BTC over the last 30d, from -1 to 1. | |
correlations.vix.30d.time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Point-in-time value: the last date used by the window (at the top level, the most recent of all windows; see oldest_input_date). |
correlations.vix.30d.correlation | number | from -1 to 1 | Pearson correlation of daily returns. |
correlations.vix.30d.sample_count | integer | null | count | Number of days used. |
correlations.vix.90d | object | Pearson correlation of daily returns against BTC over the last 90d, from -1 to 1. | |
correlations.vix.90d.time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Point-in-time value: the last date used by the window (at the top level, the most recent of all windows; see oldest_input_date). |
correlations.vix.90d.correlation | number | from -1 to 1 | Pearson correlation of daily returns. |
correlations.vix.90d.sample_count | integer | null | count | Number of days used. |
Essayer
GET https://api.bytnode.com/v1/macro/correlations
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/macro/correlations"{
"status": "ok",
"server_time": "2026-11-08T12:51:58.613Z",
"data_type": "macro_correlations",
"asset": "BTC",
"data": {
"time": "2026-11-06T00:00:00.000Z",
"oldest_input_date": "2026-10-30",
"method": "Pearson correlation of daily returns (common dates), rolling window",
"correlations": {
"dxy": {
"30d": {
"time": "2026-10-30T00:00:00.000Z",
"correlation": -0.1371,
"sample_count": 15
},
"90d": {
"time": "2026-10-30T00:00:00.000Z",
"correlation": -0.3226,
"sample_count": 58
}
},
"sp500": {
"30d": {
"time": "2026-11-05T00:00:00.000Z",
"correlation": 0.7902,
"sample_count": 20
},
"90d": {
"time": "2026-11-05T00:00:00.000Z",
"correlation": 0.5264,
"sample_count": 63
}
},
"gold": {
"30d": {
"time": "2026-11-06T00:00:00.000Z",
"correlation": 0.4934,
"sample_count": 29
},
"90d": {
"time": "2026-11-06T00:00:00.000Z",
"correlation": 0.5451,
"sample_count": 89
}
},
"vix": {
"30d": {
"time": "2026-11-05T00:00:00.000Z",
"correlation": -0.7662,
"sample_count": 20
},
"90d": {
"time": "2026-11-05T00:00:00.000Z",
"correlation": -0.4349,
"sample_count": 64
}
}
}
}
}GET /v1/macro/history
Macro series history. Values of one series at its native frequency. Most recent first, or oldest first with order=asc. Follow next to read the following page (it never repeats a row).
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
since_ms | integer | — | Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range. |
until_ms | integer | — | Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next. |
limit | integer · 1–1000 | 100 | Number of rows to return, in the reading order (most recent first by default). Bounded by your plan's history window: an explicit limit (or since_ms) reaching beyond it returns 403 history_depth; without them the page simply stops at the window. |
series obligatoire | string | — | FRED series id, e.g. DGS10, CPIAUCSL, WALCL. The list: GET /v1/macro/series. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,value. Unknown field: 422 unknown_field with a suggestion. |
before_ms | integer | — | Upper time bound, EXCLUSIVE, in epoch milliseconds: rows strictly before it. Pass the oldest time you received to read the previous page without repeating a row. Not combinable with until_ms (422 invalid_time_range). |
order | string | desc | Reading order: desc (most recent first, the default) or asc (oldest first, reading forward from since_ms, which is then required). Follow next to read the following page. |
3 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
[].time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | The day of the observation, at midnight UTC. |
[].value | number | see the series `units` | Value of the series on the day of time. |
[].is_closed | boolean | true = the row is final; false = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with ?live=1 on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades. |
Essayer
GET https://api.bytnode.com/v1/macro/history?limit=3&series=DGS10
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/macro/history?series=DGS10&limit=3"{
"status": "ok",
"server_time": "2026-11-08T12:51:58.079Z",
"data_type": "macro_history",
"series": "DGS10",
"step": "1d",
"data": [
{
"time": "2026-11-05T00:00:00.000Z",
"value": 4.84,
"is_closed": true
},
{
"time": "2026-11-04T00:00:00.000Z",
"value": 4.9,
"is_closed": true
},
{
"time": "2026-11-03T00:00:00.000Z",
"value": 4.95,
"is_closed": true
}
],
"next": "/v1/macro/history?series=DGS10&limit=3&before_ms=1793664000000&order=desc"
}GET /v1/macro/intraday/history
Intraday macro candles. OHLCV candles of one instrument, most recent first (data is the list of candles; series and timeframe are recalled in the envelope).
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
since_ms | integer | — | Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range. |
until_ms | integer | — | Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next. |
limit | integer · 1–1000 | 100 | Number of rows to return, in the reading order (most recent first by default). Bounded by your plan's history window: an explicit limit (or since_ms) reaching beyond it returns 403 history_depth; without them the page simply stops at the window. |
series obligatoire | string | — | The series returned by GET /v1/macro/intraday/series (e.g. PAXGUSDT), in any case. The instrument_code column is NOT accepted. |
timeframe obligatoire | string | — | Candle size, required. Each series serves only the timeframes listed in its catalogue entry; others return 422 timeframe_not_served. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,open. Unknown field: 422 unknown_field with a suggestion. |
before_ms | integer | — | Upper time bound, EXCLUSIVE, in epoch milliseconds: rows strictly before it. Pass the oldest time you received to read the previous page without repeating a row. Not combinable with until_ms (422 invalid_time_range). |
order | string | desc | Reading order: desc (most recent first, the default) or asc (oldest first, reading forward from since_ms, which is then required). Follow next to read the following page. |
7 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
[].time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Start of the bucket the row covers: a 1h bucket at 14:00 covers 14:00:00 to 14:59:59.999. |
[].open | number | series unit | Open. |
[].high | number | series unit | High. |
[].low | number | series unit | Low. |
[].close | number | series unit | Close. |
[].volume | number | null | see `volume_kind` | Volume reported by the source for this instrument (not the whole market). |
[].is_closed | boolean | true = the row is final; false = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with ?live=1 on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades. |
Essayer
GET https://api.bytnode.com/v1/macro/intraday/history?limit=3&series=PAXGUSDT&timeframe=1h
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/macro/intraday/history?series=PAXGUSDT&timeframe=1h&limit=3"{
"status": "ok",
"server_time": "2026-11-08T12:52:01.765Z",
"data_type": "macro_intraday_history",
"timeframe": "1h",
"series": "PAXGUSDT",
"step": "1h",
"data": [
{
"time": "2026-11-08T11:00:00.000Z",
"open": 4060.69,
"high": 4060.7,
"low": 4056.25,
"close": 4058.26,
"volume": 28.158,
"is_closed": true
},
{
"time": "2026-11-08T10:00:00.000Z",
"open": 4059.83,
"high": 4060.85,
"low": 4059.82,
"close": 4060.7,
"volume": 16.9424,
"is_closed": true
},
{
"time": "2026-11-08T09:00:00.000Z",
"open": 4059.41,
"high": 4059.83,
"low": 4058.23,
"close": 4059.83,
"volume": 15.438,
"is_closed": true
}
],
"next": "/v1/macro/intraday/history?series=PAXGUSDT&timeframe=1h&limit=3&before_ms=1794128400000&order=desc"
}GET /v1/macro/intraday/series
Intraday macro instruments. Instruments with intraday candles (FX, dollar index, gold, oil, US yields, VIX...), the timeframes each serves, their history depth and last candle.
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=series,source. Unknown field: 422 unknown_field with a suggestion. |
16 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
[].series | string | Series identifier (the value of the series parameter). | |
[].source | string | Upstream source. | |
[].instrument_code | string | Code of the instrument at the source (informative; use series in requests). | |
[].category | string | Series category. | |
[].name | string | Human-readable name of the series. | |
[].units | string | Unit of value as published by the source. | |
[].volume_kind | string | What volume measures for this instrument (broker = the source's own flow, not the whole market). | |
[].timeframes | string[] | Timeframes natively collected for the series. | |
[].history_start_date | date | calendar date (YYYY-MM-DD) | First day of available history. |
[].last_candle_at | object | Last candle available, per timeframe. | |
[].last_candle_at.1m | date-time | Start of the latest 1m candle served for this series (ISO 8601 UTC). | |
[].last_candle_at.5m | date-time | Start of the latest 5m candle served for this series (ISO 8601 UTC). | |
[].last_candle_at.15m | date-time | Start of the latest 15m candle served for this series (ISO 8601 UTC). | |
[].last_candle_at.1h | date-time | Start of the latest 1h candle served for this series (ISO 8601 UTC). | |
[].last_candle_at.4h | date-time | Start of the latest 4h candle served for this series (ISO 8601 UTC). | |
[].last_candle_at.1d | date-time | Start of the latest 1d candle served for this series (ISO 8601 UTC). |
Essayer
GET https://api.bytnode.com/v1/macro/intraday/series
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/macro/intraday/series"{
"status": "ok",
"server_time": "2026-11-08T12:52:01.246Z",
"data_type": "macro_intraday_series",
"data": [
{
"series": "PAXGUSDT",
"source": "venue_a",
"instrument_code": "PAXGUSDT",
"category": "commodities",
"name": "PAX Gold / USDT",
"units": "USDT per token",
"volume_kind": "market",
"timeframes": [
"1m",
"5m",
"15m"
],
"history_start_date": "2020-08-28",
"last_candle_at": {
"1m": "2026-11-08T12:50:00.000Z",
"5m": "2026-11-08T12:45:00.000Z",
"15m": "2026-11-08T12:30:00.000Z",
"1h": "2026-11-08T11:00:00.000Z",
"4h": "2026-11-08T08:00:00.000Z",
"1d": "2026-11-07T00:00:00.000Z"
}
}
]
}GET /v1/macro/momentum
Macro momentum score. A -100 to +100 score of macro tailwind for crypto (money supply, Fed balance sheet, dollar) over 30 and 90 days, with each input's contribution.
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,oldest_input_date. Unknown field: 422 unknown_field with a suggestion. |
17 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Point-in-time value: the date of the most recent input. See oldest_input_date for the stalest one. |
oldest_input_date | date | calendar date (YYYY-MM-DD) | Date of the OLDEST input the value uses (a monthly series lags a daily one): the value cannot be fresher than this input. time is the most recent input; each component carries its own date. |
scale | string | Reading scale of the score. | |
30d | object | Momentum score over the last 30d, from -100 to +100. | |
30d.score | number | score from -100 to +100 | Macro momentum for crypto: positive = macro tailwind (weaker dollar, growing liquidity). |
30d.components | object[] | The inputs of the score and their contributions. | |
30d.components[].time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Point-in-time value: the date of the most recent input. See oldest_input_date for the stalest one. |
30d.components[].metric | string | Input name. | |
30d.components[].change_pct | number | percent (58.5 = 58.5 %) | Relative change of the input over the window, percent. |
30d.components[].contribution | number | dimensionless score | Contribution of the input to the score. |
90d | object | Momentum score over the last 90d, from -100 to +100. | |
90d.score | number | score from -100 to +100 | Macro momentum for crypto: positive = macro tailwind (weaker dollar, growing liquidity). |
90d.components | object[] | The inputs of the score and their contributions. | |
90d.components[].time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Point-in-time value: the date of the most recent input. See oldest_input_date for the stalest one. |
90d.components[].metric | string | Input name. | |
90d.components[].change_pct | number | percent (58.5 = 58.5 %) | Relative change of the input over the window, percent. |
90d.components[].contribution | number | dimensionless score | Contribution of the input to the score. |
Essayer
GET https://api.bytnode.com/v1/macro/momentum
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/macro/momentum"{
"status": "ok",
"server_time": "2026-11-08T12:51:59.143Z",
"data_type": "macro_momentum",
"data": {
"time": "2026-11-04T00:00:00.000Z",
"oldest_input_date": "2026-09-01",
"scale": "-100 (bearish) .. +100 (bullish crypto)",
"30d": {
"score": 15.1,
"components": [
{
"time": "2026-10-30T00:00:00.000Z",
"metric": "dxy",
"change_pct": 0.576,
"contribution": -23
},
{
"time": "2026-09-01T00:00:00.000Z",
"metric": "m2",
"change_pct": 0.485,
"contribution": 64.7
},
{
"time": "2026-11-04T00:00:00.000Z",
"metric": "fed_balance_sheet",
"change_pct": 0.076,
"contribution": 3.8
}
]
},
"90d": {
"score": 13.3,
"components": [
{
"time": "2026-10-30T00:00:00.000Z",
"metric": "dxy",
"change_pct": 1.639,
"contribution": -32.8
},
{
"time": "2026-09-01T00:00:00.000Z",
"metric": "m2",
"change_pct": 1.457,
"contribution": 72.8
},
{
"time": "2026-11-04T00:00:00.000Z",
"metric": "fed_balance_sheet",
"change_pct": -0.006,
"contribution": -0.1
}
]
}
}
}GET /v1/macro/net-liquidity
US net liquidity. Fed balance sheet minus Treasury General Account minus overnight reverse repo, in USD, with its components: the latest row of the history (daily grid of the reverse repo; the weekly WALCL and TGA values are the latest known on that day, dated by walcl_date / tga_date).
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,net_liquidity_usd. Unknown field: 422 unknown_field with a suggestion. |
7 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | The day the value refers to, at midnight UTC. |
net_liquidity_usd | number | null | USD | Fed balance sheet (WALCL) - Treasury General Account (TGA) - overnight reverse repo (ON RRP), in USD. |
walcl_usd | number | null | USD | Fed total assets (WALCL), as known on that day. |
tga_usd | number | null | USD | Treasury General Account (WTREGEN), as known on that day. |
rrp_usd | number | USD | Overnight reverse repo (RRPONTSYD) of that day. |
walcl_date | date | calendar date (YYYY-MM-DD) | Observation day of the WALCL value used (weekly series). |
tga_date | date | calendar date (YYYY-MM-DD) | Observation day of the TGA value used (weekly series). |
Essayer
GET https://api.bytnode.com/v1/macro/net-liquidity
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/macro/net-liquidity"{
"status": "ok",
"server_time": "2026-11-08T12:52:00.167Z",
"data_type": "macro_net_liquidity",
"data": {
"time": "2026-11-06T00:00:00.000Z",
"net_liquidity_usd": 5790820000000,
"walcl_usd": 6748145000000,
"tga_usd": 957175000000,
"rrp_usd": 150000000,
"walcl_date": "2026-11-04",
"tga_date": "2026-11-04"
}
}GET /v1/macro/net-liquidity/history
Net liquidity history. Most recent first, or oldest first with order=asc. Follow next to read the following page (it never repeats a row).
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
since_ms | integer | — | Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range. |
until_ms | integer | — | Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next. |
limit | integer · 1–1000 | 100 | Number of rows to return, in the reading order (most recent first by default). Bounded by your plan's history window: an explicit limit (or since_ms) reaching beyond it returns 403 history_depth; without them the page simply stops at the window. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,net_liquidity_usd. Unknown field: 422 unknown_field with a suggestion. |
before_ms | integer | — | Upper time bound, EXCLUSIVE, in epoch milliseconds: rows strictly before it. Pass the oldest time you received to read the previous page without repeating a row. Not combinable with until_ms (422 invalid_time_range). |
order | string | desc | Reading order: desc (most recent first, the default) or asc (oldest first, reading forward from since_ms, which is then required). Follow next to read the following page. |
8 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
[].time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | The day the value refers to, at midnight UTC. |
[].net_liquidity_usd | number | null | USD | Fed balance sheet (WALCL) - Treasury General Account (TGA) - overnight reverse repo (ON RRP), in USD. |
[].walcl_usd | number | null | USD | Fed total assets (WALCL), as known on that day. |
[].tga_usd | number | null | USD | Treasury General Account (WTREGEN), as known on that day. |
[].rrp_usd | number | USD | Overnight reverse repo (RRPONTSYD) of that day. |
[].walcl_date | date | null | calendar date (YYYY-MM-DD) | Observation day of the WALCL value used (weekly series). |
[].tga_date | date | null | calendar date (YYYY-MM-DD) | Observation day of the TGA value used (weekly series). |
[].is_closed | boolean | true = the row is final; false = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with ?live=1 on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades. |
Essayer
GET https://api.bytnode.com/v1/macro/net-liquidity/history?limit=3
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/macro/net-liquidity/history?limit=3"{
"status": "ok",
"server_time": "2026-11-08T12:52:00.699Z",
"data_type": "macro_net_liquidity_history",
"step": "1d",
"data": [
{
"time": "2026-11-06T00:00:00.000Z",
"net_liquidity_usd": 5790820000000,
"walcl_usd": 6748145000000,
"tga_usd": 957175000000,
"rrp_usd": 150000000,
"walcl_date": "2026-11-04",
"tga_date": "2026-11-04",
"is_closed": true
},
{
"time": "2026-11-05T00:00:00.000Z",
"net_liquidity_usd": 5790845000000,
"walcl_usd": 6748145000000,
"tga_usd": 957175000000,
"rrp_usd": 125000000,
"walcl_date": "2026-11-04",
"tga_date": "2026-11-04",
"is_closed": true
},
{
"time": "2026-11-04T00:00:00.000Z",
"net_liquidity_usd": 5790745000000,
"walcl_usd": 6748145000000,
"tga_usd": 957175000000,
"rrp_usd": 225000000,
"walcl_date": "2026-11-04",
"tga_date": "2026-11-04",
"is_closed": true
}
],
"next": "/v1/macro/net-liquidity/history?limit=3&before_ms=1793750400000&order=desc"
}GET /v1/macro/risk
Risk-on / risk-off score. Five signals (VIX, dollar trend, 10Y-2Y curve, S&P 500 vs its 50-day average, gold trend) and the share that are risk-on, from 0 to 100.
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,oldest_input_date. Unknown field: 422 unknown_field with a suggestion. |
37 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Point-in-time value: the date of the most recent signal. See oldest_input_date for the stalest one. |
oldest_input_date | date | calendar date (YYYY-MM-DD) | Date of the OLDEST input the value uses (a monthly series lags a daily one): the value cannot be fresher than this input. time is the most recent input; each component carries its own date. |
score | number | score from 0 to 100 | Share of risk-on signals × 100. |
label | string | risk_on (score above 50), risk_off (below 50) or neutral (exactly 50). | |
risk_on_signal_count | integer | count | Signals currently risk-on. |
available_signal_count | integer | count | Signals that could be evaluated (data available). |
signal_count | integer | count | Signals in the model. |
signals | object | Each signal: its condition and whether it is risk-on now (is_risk_on). | |
signals.vix | object | The vix signal: its reading, and whether it counts as risk-on. | |
signals.vix.time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Point-in-time value: the date of the most recent signal. See oldest_input_date for the stalest one. |
signals.vix.condition | string | Rule of the signal. | |
signals.vix.is_risk_on | boolean | Whether the signal is risk-on now. | |
signals.dxy | object | The dxy signal: its reading, and whether it counts as risk-on. | |
signals.dxy.time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Point-in-time value: the date of the most recent signal. See oldest_input_date for the stalest one. |
signals.dxy.condition | string | Rule of the signal. | |
signals.dxy.is_risk_on | boolean | Whether the signal is risk-on now. | |
signals.yield_curve | object | The yield_curve signal: its reading, and whether it counts as risk-on. | |
signals.yield_curve.time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Point-in-time value: the date of the most recent signal. See oldest_input_date for the stalest one. |
signals.yield_curve.condition | string | Rule of the signal. | |
signals.yield_curve.is_risk_on | boolean | Whether the signal is risk-on now. | |
signals.sp500 | object | The sp500 signal: its reading, and whether it counts as risk-on. | |
signals.sp500.time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Point-in-time value: the date of the most recent signal. See oldest_input_date for the stalest one. |
signals.sp500.condition | string | Rule of the signal. | |
signals.sp500.is_risk_on | boolean | Whether the signal is risk-on now. | |
signals.gold | object | The gold signal: its reading, and whether it counts as risk-on. | |
signals.gold.time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Point-in-time value: the date of the most recent signal. See oldest_input_date for the stalest one. |
signals.gold.condition | string | Rule of the signal. | |
signals.gold.is_risk_on | boolean | Whether the signal is risk-on now. | |
context | object | The raw inputs used by the signals. | |
context.vix | number | index points | CBOE Volatility Index. |
context.dxy | number | index points | US Dollar Index. |
context.dxy_7d_ago | number | index points | US Dollar Index seven days earlier. |
context.yield_curve_10y2y_pp | number | percentage points | 10-year minus 2-year US Treasury yield. |
context.sp500 | number | index points | S&P 500. |
context.sp500_sma_50d | number | index points | 50-day simple moving average of the S&P 500. |
context.gold_usd | number | USD per troy ounce | Gold price. |
context.gold_7d_ago_usd | number | USD per troy ounce | Gold price seven days earlier. |
Essayer
GET https://api.bytnode.com/v1/macro/risk
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/macro/risk"{
"status": "ok",
"server_time": "2026-11-08T12:51:59.658Z",
"data_type": "macro_risk",
"data": {
"time": "2026-11-06T00:00:00.000Z",
"oldest_input_date": "2026-10-30",
"score": 20,
"label": "risk_off",
"risk_on_signal_count": 1,
"available_signal_count": 5,
"signal_count": 5,
"signals": {
"vix": {
"time": "2026-11-05T00:00:00.000Z",
"condition": "VIX < 20",
"is_risk_on": false
},
"dxy": {
"time": "2026-10-30T00:00:00.000Z",
"condition": "Broad Dollar Index (Fed, trade-weighted) down over 7 days",
"is_risk_on": false
},
"yield_curve": {
"time": "2026-11-06T00:00:00.000Z",
"condition": "10Y-2Y curve positive",
"is_risk_on": true
},
"sp500": {
"time": "2026-11-05T00:00:00.000Z",
"condition": "S&P 500 > SMA50",
"is_risk_on": false
},
"gold": {
"time": "2026-11-06T00:00:00.000Z",
"condition": "Gold down over 7 days",
"is_risk_on": false
}
},
"context": {
"vix": 28.18,
"dxy": 121.6656,
"dxy_7d_ago": 121.3202,
"yield_curve_10y2y_pp": 0.35,
"sp500": 7353.73,
"sp500_sma_50d": 7686.53,
"gold_usd": 4054.59011588,
"gold_7d_ago_usd": 3896.09659085
}
}
}GET /v1/macro/series
Macro series catalogue. Every active FRED series with its category, unit, frequency and latest value.
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
category | string | — | Filter by category, e.g. rates, inflation, liquidity, commodities. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,series. Unknown field: 422 unknown_field with a suggestion. |
7 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
[].time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | The day of the latest observation of the series, at midnight UTC. |
[].series | string | Series identifier (the value of the series parameter). | |
[].category | string | Series category. | |
[].name | string | Human-readable name of the series. | |
[].frequency | string | Publication frequency of the source (daily, weekly, monthly). | |
[].units | string | Unit of value as published by the source. | |
[].value | number | see `units` | Latest value of the series, in the unit given by units. |
Essayer
GET https://api.bytnode.com/v1/macro/series
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/macro/series"{
"status": "ok",
"server_time": "2026-11-08T12:51:57.554Z",
"data_type": "macro_series",
"data": [
{
"time": "2026-11-03T00:00:00.000Z",
"series": "DCOILWTICO",
"category": "commodities",
"name": "WTI Crude Oil",
"frequency": "daily",
"units": "USD per barrel",
"value": 99.64
},
{
"time": "2026-11-06T00:00:00.000Z",
"series": "GOLD_USD",
"category": "commodities",
"name": "Gold (PAXG proxy, USD/oz)",
"frequency": "daily",
"units": "USD per troy ounce",
"value": 4054.59011588
},
{
"time": "2026-10-01T00:00:00.000Z",
"series": "PAYEMS",
"category": "employment",
"name": "Nonfarm Payrolls",
"frequency": "monthly",
"units": "Thousands of persons",
"value": 159293
}
]
}#ETF
Spot BTC and ETH ETF fundamentals per issuer, anchored on SEC EDGAR filings: shares, NAV, net assets and coins held.
GET /v1/etf/fundamentals
ETF fundamentals per issuer. Latest SEC EDGAR anchor per spot ETF: shares outstanding, NAV, net assets and coins held. data is a list, one row per issuer.
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
asset obligatoire | string | — | Asset, e.g. BTC or ETH (no quote currency), in any case (eth works; the envelope gives the canonical form). Unknown: 422 invalid_asset. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,ticker. Unknown field: 422 unknown_field with a suggestion. |
11 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
[].time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | The balance-sheet date of the filing — the day the holdings, NAV and net assets are measured (end of the quarter for a 10-Q), at midnight UTC. filed_date says when the filing reached the SEC. |
[].ticker | string | ETF ticker. | |
[].issuer | string | ETF issuer. | |
[].shares_outstanding | number | shares | ETF shares outstanding. |
[].nav_per_share_usd | number | USD | Net asset value per share. |
[].net_assets_usd | number | USD | Net assets (AUM). |
[].form | string | SEC form type of the filing (10-Q, 10-K...). | |
[].filed_date | date | calendar date (YYYY-MM-DD) | Filing date at the SEC. |
[].filing_url | string | Link to the filing on SEC EDGAR. | |
[].holdings | number | null | units of the asset (BTC for asset=BTC, ETH for asset=ETH) | Crypto held by the fund, in units of the asset. |
[].is_holdings_estimated | boolean | true if the holdings are derived from net assets / price rather than read in the filing. |
Essayer
GET https://api.bytnode.com/v1/etf/fundamentals?asset=BTC
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/etf/fundamentals?asset=BTC"{
"status": "ok",
"server_time": "2026-11-08T12:52:02.307Z",
"data_type": "etf_fundamentals",
"asset": "BTC",
"data": [
{
"time": "2026-09-30T00:00:00.000Z",
"ticker": "ARKB",
"issuer": "Ark/21Shares",
"shares_outstanding": 87785000,
"nav_per_share_usd": 27.7,
"net_assets_usd": 2889039000,
"form": "10-Q",
"filed_date": "2026-11-06",
"filing_url": "https://www.sec.gov/Archives/edgar/data/1869699/000121390026116875/",
"holdings": 34578.4206,
"is_holdings_estimated": false
},
{
"time": "2026-09-30T00:00:00.000Z",
"ticker": "BITB",
"issuer": "Bitwise",
"shares_outstanding": 68580000,
"nav_per_share_usd": 45.34,
"net_assets_usd": 3168481000,
"form": "10-Q",
"filed_date": "2026-11-06",
"filing_url": "https://www.sec.gov/Archives/edgar/data/1763415/000119312526451777/",
"holdings": 37889.7942686,
"is_holdings_estimated": true
},
{
"time": "2026-06-30T00:00:00.000Z",
"ticker": "BRRR",
"issuer": "CoinShares/Valkyrie",
"shares_outstanding": 20895000,
"nav_per_share_usd": 16.46,
"net_assets_usd": 342354115,
"form": "10-Q",
"filed_date": "2026-08-12",
"filing_url": "https://www.sec.gov/Archives/edgar/data/1841175/000199937126017701/",
"holdings": 5841.68208049,
"is_holdings_estimated": true
}
]
}GET /v1/etf/fundamentals/history
ETF fundamentals history. One row per filing and issuer. Most recent first, or oldest first with order=asc. Follow next to read the following page (it never repeats a row).
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
ticker | string | — | ETF ticker (e.g. IBIT, FBTC). Omit for every issuer. |
since_ms | integer | — | Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range. |
until_ms | integer | — | Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next. |
limit | integer · 1–1000 | 100 | Number of rows to read, most recent first by default. A page holds EVERY issuer's row of each balance-sheet date those rows reach, so it can hold a few more than limit (a date is never split across two pages); next is null on the last page. |
asset obligatoire | string | — | Asset, e.g. BTC or ETH (no quote currency), in any case (eth works; the envelope gives the canonical form). Unknown: 422 invalid_asset. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,ticker. Unknown field: 422 unknown_field with a suggestion. |
before_ms | integer | — | Upper time bound, EXCLUSIVE, in epoch milliseconds: rows strictly before it. Pass the oldest time you received to read the previous page without repeating a row. Not combinable with until_ms (422 invalid_time_range). |
order | string | desc | Reading order: desc (most recent first, the default) or asc (oldest first, reading forward from since_ms, which is then required). Follow next to read the following page. |
12 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
[].time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | The balance-sheet date of the filing — the day the holdings, NAV and net assets are measured (end of the quarter for a 10-Q), at midnight UTC. filed_date says when the filing reached the SEC. |
[].ticker | string | ETF ticker. | |
[].issuer | string | ETF issuer. | |
[].shares_outstanding | number | shares | ETF shares outstanding. |
[].nav_per_share_usd | number | USD | Net asset value per share. |
[].net_assets_usd | number | USD | Net assets (AUM). |
[].form | string | SEC form type of the filing (10-Q, 10-K...). | |
[].filed_date | date | calendar date (YYYY-MM-DD) | Filing date at the SEC. |
[].filing_url | string | Link to the filing on SEC EDGAR. | |
[].holdings | number | null | units of the asset (BTC for asset=BTC, ETH for asset=ETH) | Crypto held by the fund, in units of the asset. |
[].is_holdings_estimated | boolean | null | true if the holdings are derived from net assets / price rather than read in the filing. | |
[].is_closed | boolean | true = the row is final; false = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with ?live=1 on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades. |
Essayer
GET https://api.bytnode.com/v1/etf/fundamentals/history?limit=3&asset=BTC
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/etf/fundamentals/history?asset=BTC&limit=3"{
"status": "ok",
"server_time": "2026-11-08T12:52:02.852Z",
"data_type": "etf_fundamentals_history",
"asset": "BTC",
"data": [
{
"time": "2026-09-30T00:00:00.000Z",
"ticker": "ARKB",
"issuer": "Ark/21Shares",
"shares_outstanding": 87785000,
"nav_per_share_usd": 27.7,
"net_assets_usd": 2889039000,
"form": "10-Q",
"filed_date": "2026-11-06",
"filing_url": "https://www.sec.gov/Archives/edgar/data/1869699/000121390026116875/",
"holdings": 34578.4206,
"is_holdings_estimated": false,
"is_closed": true
},
{
"time": "2026-09-30T00:00:00.000Z",
"ticker": "BITB",
"issuer": "Bitwise",
"shares_outstanding": 68580000,
"nav_per_share_usd": 45.34,
"net_assets_usd": 3168481000,
"form": "10-Q",
"filed_date": "2026-11-06",
"filing_url": "https://www.sec.gov/Archives/edgar/data/1763415/000119312526451777/",
"holdings": 37889.7942686,
"is_holdings_estimated": true,
"is_closed": true
},
{
"time": "2026-09-30T00:00:00.000Z",
"ticker": "BTCO",
"issuer": "Invesco/Galaxy",
"shares_outstanding": 5130000,
"nav_per_share_usd": 83.09,
"net_assets_usd": 426250106,
"form": "10-Q",
"filed_date": "2026-11-06",
"filing_url": "https://www.sec.gov/Archives/edgar/data/1855781/000119312526450234/",
"holdings": 5097.24654284,
"is_holdings_estimated": true,
"is_closed": true
}
],
"next": "/v1/etf/fundamentals/history?asset=BTC&limit=3&before_ms=1790726400000&order=desc"
}#Options
BTC and ETH options aggregated across venues: open interest and volume (calls/puts, USD), put/call ratio, ATM implied volatility, max pain, per-expiry and per-strike views, OI-weighted greeks.
GET /v1/options/expiry
Per-expiry breakdown. Every active expiry: open interest, put/call ratio, max pain, top call and put strikes, the ATM IV of that expiry. data is a list.
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
asset obligatoire | string | — | Asset, e.g. BTC or ETH (no quote currency), in any case (eth works; the envelope gives the canonical form). Unknown: 422 invalid_asset. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,expiry_at. Unknown field: 422 unknown_field with a suggestion. |
11 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
[].time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Point-in-time value: the instant of the options snapshot (all venues read together). |
[].expiry_at | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Expiry instant (08:00 UTC). Pass its date part (YYYY-MM-DD) as the expiry parameter. |
[].time_to_expiry_s | number | seconds | Time left before expiry, in seconds. |
[].oi_call_usd | number | null | USD | Call open interest, USD. |
[].oi_put_usd | number | null | USD | Put open interest, USD. |
[].put_call_ratio | number | puts / calls | Put/call open interest ratio (a quotient, not a share: 1.2 = 1.2 puts per call). Below 1 = more calls than puts. |
[].max_pain_strike_usd | number | USD | Strike at which option holders lose the most at expiry (max pain). |
[].top_call_strike_usd | number | USD | Strike with the largest call open interest. |
[].top_put_strike_usd | number | USD | Strike with the largest put open interest. |
[].iv_atm_pct | number | percent (58.5 = 58.5 %) | At-the-money implied volatility of THIS expiry, annualised, in percent (55.2 = 55.2 %). |
[].put_call_label | string | bullish (put_call_ratio < 0.7), neutral, or bearish (put_call_ratio > 1). |
Essayer
GET https://api.bytnode.com/v1/options/expiry?asset=BTC
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/options/expiry?asset=BTC"{
"status": "ok",
"server_time": "2026-11-08T12:52:11.481Z",
"data_type": "options_expiry",
"asset": "BTC",
"data": [
{
"time": "2026-11-08T12:51:31.126Z",
"expiry_at": "2026-11-09T08:00:00.000Z",
"time_to_expiry_s": 68908.874,
"oi_call_usd": 741964276.059,
"oi_put_usd": 247478907.232,
"put_call_ratio": 0.333545583281,
"max_pain_strike_usd": 76000,
"top_call_strike_usd": 78000,
"top_put_strike_usd": 71000,
"iv_atm_pct": 31.2562557893,
"put_call_label": "bullish"
},
{
"time": "2026-11-08T12:51:31.126Z",
"expiry_at": "2026-11-10T08:00:00.000Z",
"time_to_expiry_s": 155308.874,
"oi_call_usd": 82834271.3385,
"oi_put_usd": 95030646.8896,
"put_call_ratio": 1.14723827896,
"max_pain_strike_usd": 76000,
"top_call_strike_usd": 81000,
"top_put_strike_usd": 73000,
"iv_atm_pct": 36.6917047173,
"put_call_label": "bearish"
},
{
"time": "2026-11-08T12:51:31.126Z",
"expiry_at": "2026-11-11T08:00:00.000Z",
"time_to_expiry_s": 241708.874,
"oi_call_usd": 11492362.1378,
"oi_put_usd": 16330498.9158,
"put_call_ratio": 1.42098714955,
"max_pain_strike_usd": 75500,
"top_call_strike_usd": 79000,
"top_put_strike_usd": 73000,
"iv_atm_pct": 39.57,
"put_call_label": "bearish"
}
]
}GET /v1/options/greeks
Aggregated greeks. Delta, gamma, theta and vega of open options, recomputed under one convention and OI-weighted, so they add up across venues.
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
asset obligatoire | string | — | Asset, e.g. BTC or ETH (no quote currency), in any case (eth works; the envelope gives the canonical form). Unknown: 422 invalid_asset. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,delta. Unknown field: 422 unknown_field with a suggestion. |
7 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Point-in-time value: the instant of the options snapshot (all venues read together). |
delta | number | delta | Aggregated delta of open options, OI-weighted (per unit of underlying). |
gamma | number | delta per USD | Change of delta for a 1 USD move of the underlying, OI-weighted. |
theta | number | USD per day | Time decay per day, OI-weighted. |
vega | number | USD per volatility point | Value change for +1 point of implied volatility, OI-weighted. |
coverage | object | oi_coverage_ratio: share of the open interest covered by the venues that answered (1.0 = all). | |
coverage.oi_coverage_ratio | number | fraction (0.585 = 58.5 %) | Share of the open interest covered by the contributing venues. |
Essayer
GET https://api.bytnode.com/v1/options/greeks?asset=BTC
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/options/greeks?asset=BTC"{
"status": "ok",
"server_time": "2026-11-08T12:52:12.015Z",
"data_type": "options_greeks",
"asset": "BTC",
"data": {
"time": "2026-11-08T12:51:31.126Z",
"delta": -0.00278808615704,
"gamma": 0.0000238357807228,
"theta": -31.0158952421,
"vega": 53.1726538673,
"coverage": {
"oi_coverage_ratio": 1
}
}
}GET /v1/options/iv
ATM implied volatility (30 days). At-the-money implied volatility at a constant 30-day maturity, aggregated across venues, in percent: interpolated in total variance between the two expiries around 30 days. The ATM IV of each expiry is on /v1/options/expiry.
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
asset obligatoire | string | — | Asset, e.g. BTC or ETH (no quote currency), in any case (eth works; the envelope gives the canonical form). Unknown: 422 invalid_asset. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,iv_atm_30d_pct. Unknown field: 422 unknown_field with a suggestion. |
2 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Point-in-time value: the instant of the options snapshot (all venues read together). |
iv_atm_30d_pct | number | percent (58.5 = 58.5 %) | At-the-money implied volatility at a constant 30-day maturity, annualised, in percent (55.2 = 55.2 %). Interpolated in total variance (IV² × time) between the two expiries around 30 days, so it does not jump when the nearest expiry rolls off; the ATM IV of each expiry is on /v1/options/expiry. |
Essayer
GET https://api.bytnode.com/v1/options/iv?asset=BTC
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/options/iv?asset=BTC"{
"status": "ok",
"server_time": "2026-11-08T12:52:08.798Z",
"data_type": "options_iv",
"asset": "BTC",
"data": {
"time": "2026-11-08T12:51:31.126Z",
"iv_atm_30d_pct": 38.2231279733
}
}GET /v1/options/iv/klines
Latest 30-day ATM IV candle. The latest CLOSED candle of the 30-day ATM implied volatility (timeframe required), in percent: open_pct, high_pct, low_pct, close_pct. The first row of /v1/options/iv/klines/history.
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
timeframe obligatoire | string | — | Bucket size, required: 5m, 15m, 30m, 1h, 4h or 1d (1m is not served on options). Missing: 422 missing_parameter; other values: 422 invalid_timeframe. |
asset obligatoire | string | — | Asset, e.g. BTC or ETH (no quote currency), in any case (eth works; the envelope gives the canonical form). Unknown: 422 invalid_asset. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,open_pct. Unknown field: 422 unknown_field with a suggestion. |
6 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Start of the latest CLOSED bucket; the candle summarises its options snapshots. |
open_pct | number | percent (58.5 = 58.5 %) | 30-day ATM IV at the start of the bucket. |
high_pct | number | percent (58.5 = 58.5 %) | Highest 30-day ATM IV. |
low_pct | number | percent (58.5 = 58.5 %) | Lowest 30-day ATM IV. |
close_pct | number | percent (58.5 = 58.5 %) | 30-day ATM IV at the end of the bucket. |
is_closed | boolean | true = the row is final; false = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with ?live=1 on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades. |
Essayer
GET https://api.bytnode.com/v1/options/iv/klines?timeframe=1h&asset=BTC
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/options/iv/klines?asset=BTC&timeframe=1h"{
"status": "ok",
"server_time": "2026-11-08T12:52:09.341Z",
"data_type": "options_iv_klines",
"timeframe": "1h",
"asset": "BTC",
"data": {
"time": "2026-11-08T11:00:00.000Z",
"open_pct": 38.159251879,
"high_pct": 38.1854458294,
"low_pct": 38.0986841942,
"close_pct": 38.0986841942,
"is_closed": true
}
}GET /v1/options/iv/klines/history
30-day ATM IV candles. OHLC of the 30-day ATM implied volatility per bucket, in percent (open_pct... close_pct). Most recent first, or oldest first with order=asc. Follow next to read the following page (it never repeats a row).
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
timeframe obligatoire | string | — | Bucket size, required: 5m, 15m, 30m, 1h, 4h or 1d (1m is not served on options). Missing: 422 missing_parameter; other values: 422 invalid_timeframe. |
since_ms | integer | — | Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range. |
until_ms | integer | — | Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next. |
limit | integer · 1–1000 | 100 | Number of rows to return, in the reading order (most recent first by default). Bounded by your plan's history window: an explicit limit (or since_ms) reaching beyond it returns 403 history_depth; without them the page simply stops at the window. |
asset obligatoire | string | — | Asset, e.g. BTC or ETH (no quote currency), in any case (eth works; the envelope gives the canonical form). Unknown: 422 invalid_asset. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,open_pct. Unknown field: 422 unknown_field with a suggestion. |
before_ms | integer | — | Upper time bound, EXCLUSIVE, in epoch milliseconds: rows strictly before it. Pass the oldest time you received to read the previous page without repeating a row. Not combinable with until_ms (422 invalid_time_range). |
order | string | desc | Reading order: desc (most recent first, the default) or asc (oldest first, reading forward from since_ms, which is then required). Follow next to read the following page. |
6 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
[].time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Start of the bucket; the value is the LAST options snapshot of the bucket. |
[].open_pct | number | percent (58.5 = 58.5 %) | 30-day ATM IV at the start of the bucket. |
[].high_pct | number | percent (58.5 = 58.5 %) | Highest 30-day ATM IV. |
[].low_pct | number | percent (58.5 = 58.5 %) | Lowest 30-day ATM IV. |
[].close_pct | number | percent (58.5 = 58.5 %) | 30-day ATM IV at the end of the bucket. |
[].is_closed | boolean | true = the row is final; false = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with ?live=1 on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades. |
Essayer
GET https://api.bytnode.com/v1/options/iv/klines/history?timeframe=1h&limit=3&asset=BTC
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/options/iv/klines/history?asset=BTC&timeframe=1h&limit=3"{
"status": "ok",
"server_time": "2026-11-08T12:52:09.855Z",
"data_type": "options_iv_klines_history",
"timeframe": "1h",
"asset": "BTC",
"step": "1h",
"data": [
{
"time": "2026-11-08T11:00:00.000Z",
"open_pct": 38.159251879,
"high_pct": 38.1854458294,
"low_pct": 38.0986841942,
"close_pct": 38.0986841942,
"is_closed": true
},
{
"time": "2026-11-08T10:00:00.000Z",
"open_pct": 38.078828356,
"high_pct": 38.2457768752,
"low_pct": 38.0144785975,
"close_pct": 38.1703306301,
"is_closed": true
},
{
"time": "2026-11-08T09:00:00.000Z",
"open_pct": 38.1037803665,
"high_pct": 38.2218178939,
"low_pct": 38.0815635591,
"close_pct": 38.0815635591,
"is_closed": true
}
],
"next": "/v1/options/iv/klines/history?asset=BTC&timeframe=1h&limit=3&before_ms=1794128400000&order=desc"
}GET /v1/options/max-pain
Max pain per expiry. Max pain strike of every active expiry, with the time left (time_to_expiry_s), put/call ratio and open interest. data is a list.
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
asset obligatoire | string | — | Asset, e.g. BTC or ETH (no quote currency), in any case (eth works; the envelope gives the canonical form). Unknown: 422 invalid_asset. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,expiry_at. Unknown field: 422 unknown_field with a suggestion. |
7 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
[].time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Point-in-time value: the instant of the options snapshot (all venues read together). |
[].expiry_at | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Expiry instant (08:00 UTC). Pass its date part (YYYY-MM-DD) as the expiry parameter. |
[].time_to_expiry_s | number | seconds | Time left before expiry, in seconds. |
[].max_pain_strike_usd | number | USD | Strike at which option holders lose the most at expiry (max pain). |
[].put_call_ratio | number | puts / calls | Put/call open interest ratio (a quotient, not a share: 1.2 = 1.2 puts per call). Below 1 = more calls than puts. |
[].oi_call_usd | number | null | USD | Call open interest, USD. |
[].oi_put_usd | number | null | USD | Put open interest, USD. |
Essayer
GET https://api.bytnode.com/v1/options/max-pain?asset=BTC
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/options/max-pain?asset=BTC"{
"status": "ok",
"server_time": "2026-11-08T12:52:10.385Z",
"data_type": "options_max_pain",
"asset": "BTC",
"data": [
{
"time": "2026-11-08T12:51:31.126Z",
"expiry_at": "2026-11-09T08:00:00.000Z",
"time_to_expiry_s": 68908.874,
"max_pain_strike_usd": 76000,
"put_call_ratio": 0.333545583281,
"oi_call_usd": 741964276.059,
"oi_put_usd": 247478907.232
},
{
"time": "2026-11-08T12:51:31.126Z",
"expiry_at": "2026-11-10T08:00:00.000Z",
"time_to_expiry_s": 155308.874,
"max_pain_strike_usd": 76000,
"put_call_ratio": 1.14723827896,
"oi_call_usd": 82834271.3385,
"oi_put_usd": 95030646.8896
},
{
"time": "2026-11-08T12:51:31.126Z",
"expiry_at": "2026-11-11T08:00:00.000Z",
"time_to_expiry_s": 241708.874,
"max_pain_strike_usd": 75500,
"put_call_ratio": 1.42098714955,
"oi_call_usd": 11492362.1378,
"oi_put_usd": 16330498.9158
}
]
}GET /v1/options/max-pain/history
Max pain history of one expiry. How the max pain of ONE expiry moved. expiry is required. Most recent first, or oldest first with order=asc. Follow next to read the following page (it never repeats a row).
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
expiry obligatoire | string | — | REQUIRED. Expiry: YYYY-MM-DD, or the expiry_at date-time as served (2026-10-30T08:00:00.000Z). Missing: 422 missing_parameter, and the error lists the active expiries. |
since_ms | integer | — | Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range. |
until_ms | integer | — | Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next. |
limit | integer · 1–1000 | 100 | Number of rows to return, in the reading order (most recent first by default). Bounded by your plan's history window: an explicit limit (or since_ms) reaching beyond it returns 403 history_depth; without them the page simply stops at the window. |
asset obligatoire | string | — | Asset, e.g. BTC or ETH (no quote currency), in any case (eth works; the envelope gives the canonical form). Unknown: 422 invalid_asset. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,max_pain_strike_usd. Unknown field: 422 unknown_field with a suggestion. |
before_ms | integer | — | Upper time bound, EXCLUSIVE, in epoch milliseconds: rows strictly before it. Pass the oldest time you received to read the previous page without repeating a row. Not combinable with until_ms (422 invalid_time_range). |
order | string | desc | Reading order: desc (most recent first, the default) or asc (oldest first, reading forward from since_ms, which is then required). Follow next to read the following page. |
4 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
[].time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | The instant of the options snapshot the max pain was computed on (one row per snapshot, about every minute; no timeframe). |
[].max_pain_strike_usd | number | USD | Strike at which option holders lose the most at expiry (max pain). |
[].put_call_ratio | number | puts / calls | Put/call open interest ratio (a quotient, not a share: 1.2 = 1.2 puts per call). Below 1 = more calls than puts. |
[].is_closed | boolean | true = the row is final; false = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with ?live=1 on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades. |
Essayer
GET https://api.bytnode.com/v1/options/max-pain/history?expiry=2026-11-09&limit=3&asset=BTC
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/options/max-pain/history?asset=BTC&expiry=2026-11-09&limit=3"{
"status": "ok",
"server_time": "2026-11-08T12:52:10.949Z",
"data_type": "options_max_pain_history",
"asset": "BTC",
"expiry": "2026-11-09",
"data": [
{
"time": "2026-11-08T12:51:31.126Z",
"max_pain_strike_usd": 76000,
"put_call_ratio": 0.333545583281,
"is_closed": true
},
{
"time": "2026-11-08T12:50:24.571Z",
"max_pain_strike_usd": 76000,
"put_call_ratio": 0.333551331453,
"is_closed": true
},
{
"time": "2026-11-08T12:49:17.910Z",
"max_pain_strike_usd": 76000,
"put_call_ratio": 0.333554852047,
"is_closed": true
}
],
"next": "/v1/options/max-pain/history?asset=BTC&expiry=2026-11-09&limit=3&before_ms=1794142157910&order=desc"
}GET /v1/options/oi
Options open interest. Calls and puts, in USD and in coins.
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
asset obligatoire | string | — | Asset, e.g. BTC or ETH (no quote currency), in any case (eth works; the envelope gives the canonical form). Unknown: 422 invalid_asset. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,oi_total_usd. Unknown field: 422 unknown_field with a suggestion. |
8 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Point-in-time value: the instant of the options snapshot (all venues read together). |
oi_total_usd | number | USD | Total open interest, USD. |
oi_call_usd | number | null | USD | Call open interest, USD. |
oi_put_usd | number | null | USD | Put open interest, USD. |
oi_call | number | base asset quantity (BTC for BTCUSDT) | Call open interest, in coins (base asset). |
oi_put | number | base asset quantity (BTC for BTCUSDT) | Put open interest, in coins (base asset). |
coverage | object | oi_coverage_ratio: share of the open interest covered by the venues that answered (1.0 = all). | |
coverage.oi_coverage_ratio | number | fraction (0.585 = 58.5 %) | Share of the open interest covered by the contributing venues. |
Essayer
GET https://api.bytnode.com/v1/options/oi?asset=BTC
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/options/oi?asset=BTC"{
"status": "ok",
"server_time": "2026-11-08T12:52:03.874Z",
"data_type": "options_oi",
"asset": "BTC",
"data": {
"time": "2026-11-08T12:51:31.126Z",
"oi_total_usd": 31561194969.3,
"oi_call_usd": 18067543025,
"oi_put_usd": 13493651944.3,
"oi_call": 236177.16,
"oi_put": 176496.15,
"coverage": {
"oi_coverage_ratio": 1
}
}
}GET /v1/options/oi/change
Options open interest change. Change of call and put open interest over a rolling timeframe: from the snapshot window_start_at (at least timeframe earlier) to the latest one (time). window_s is their actual distance, in whole seconds. Always final: a rolling value carries no is_closed.
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
timeframe obligatoire | string | — | Bucket size, required: 5m, 15m, 30m, 1h, 4h or 1d (1m is not served on options). Missing: 422 missing_parameter; other values: 422 invalid_timeframe. |
asset obligatoire | string | — | Asset, e.g. BTC or ETH (no quote currency), in any case (eth works; the envelope gives the canonical form). Unknown: 422 invalid_asset. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,window_start_at. Unknown field: 422 unknown_field with a suggestion. |
6 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Point-in-time value: the instant of the options snapshot (all venues read together). |
window_start_at | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Instant of the reference snapshot: the latest one at least timeframe before time. |
window_s | integer | null | seconds | Actual distance between the two snapshots, in whole seconds (timeframe or a little more: snapshots arrive every minute). |
oi_change_call_usd | number | null | USD | Change of call open interest from window_start_at to time, USD. |
oi_change_put_usd | number | null | USD | Change of put open interest from window_start_at to time, USD. |
oi_change_total_usd | number | null | USD | Change of total open interest from window_start_at to time, USD. |
Essayer
GET https://api.bytnode.com/v1/options/oi/change?timeframe=1h&asset=BTC
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/options/oi/change?asset=BTC&timeframe=1h"{
"status": "ok",
"server_time": "2026-11-08T12:52:04.898Z",
"data_type": "options_oi_change",
"timeframe": "1h",
"asset": "BTC",
"data": {
"time": "2026-11-08T12:51:31.126Z",
"window_start_at": "2026-11-08T11:51:28.223Z",
"window_s": 3603,
"oi_change_call_usd": -2079284.31123,
"oi_change_put_usd": -4626409.7686,
"oi_change_total_usd": -6705694.07983
}
}GET /v1/options/oi/change/history
Options OI change history. Per bucket. Most recent first, or oldest first with order=asc. Follow next to read the following page (it never repeats a row).
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
timeframe obligatoire | string | — | Bucket size, required: 5m, 15m, 30m, 1h, 4h or 1d (1m is not served on options). Missing: 422 missing_parameter; other values: 422 invalid_timeframe. |
since_ms | integer | — | Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range. |
until_ms | integer | — | Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next. |
limit | integer · 1–1000 | 100 | Number of rows to return, in the reading order (most recent first by default). Bounded by your plan's history window: an explicit limit (or since_ms) reaching beyond it returns 403 history_depth; without them the page simply stops at the window. |
asset obligatoire | string | — | Asset, e.g. BTC or ETH (no quote currency), in any case (eth works; the envelope gives the canonical form). Unknown: 422 invalid_asset. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,oi_change_call_usd. Unknown field: 422 unknown_field with a suggestion. |
before_ms | integer | — | Upper time bound, EXCLUSIVE, in epoch milliseconds: rows strictly before it. Pass the oldest time you received to read the previous page without repeating a row. Not combinable with until_ms (422 invalid_time_range). |
order | string | desc | Reading order: desc (most recent first, the default) or asc (oldest first, reading forward from since_ms, which is then required). Follow next to read the following page. |
5 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
[].time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Start of the bucket; the value is the LAST options snapshot of the bucket. |
[].oi_change_call_usd | number | null | USD | Change of call open interest from window_start_at to time, USD. |
[].oi_change_put_usd | number | null | USD | Change of put open interest from window_start_at to time, USD. |
[].oi_change_total_usd | number | null | USD | Change of total open interest from window_start_at to time, USD. |
[].is_closed | boolean | true = the row is final; false = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with ?live=1 on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades. |
Essayer
GET https://api.bytnode.com/v1/options/oi/change/history?timeframe=1h&limit=3&asset=BTC
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/options/oi/change/history?asset=BTC&timeframe=1h&limit=3"{
"status": "ok",
"server_time": "2026-11-08T12:52:05.539Z",
"data_type": "options_oi_change_history",
"timeframe": "1h",
"asset": "BTC",
"step": "1h",
"data": [
{
"time": "2026-11-08T11:00:00.000Z",
"oi_change_call_usd": 40014685.0434,
"oi_change_put_usd": 21636387.1538,
"oi_change_total_usd": 61651072.1972,
"is_closed": true
},
{
"time": "2026-11-08T10:00:00.000Z",
"oi_change_call_usd": -1415556.00602,
"oi_change_put_usd": 1439548.85957,
"oi_change_total_usd": 23992.85355,
"is_closed": true
},
{
"time": "2026-11-08T09:00:00.000Z",
"oi_change_call_usd": 7696508.26958,
"oi_change_put_usd": 11786074.8131,
"oi_change_total_usd": 19482583.0827,
"is_closed": true
}
],
"next": "/v1/options/oi/change/history?asset=BTC&timeframe=1h&limit=3&before_ms=1794128400000&order=desc"
}GET /v1/options/oi/distribution
Open interest per strike. Latest open interest per (expiry, strike), calls and puts separately. data is a list.
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
expiry | string | — | Restrict to one expiry: YYYY-MM-DD, or the expiry_at date-time as served (2026-10-30T08:00:00.000Z). Omit for every active expiry. |
asset obligatoire | string | — | Asset, e.g. BTC or ETH (no quote currency), in any case (eth works; the envelope gives the canonical form). Unknown: 422 invalid_asset. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,expiry_at. Unknown field: 422 unknown_field with a suggestion. |
5 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
[].time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Point-in-time value: the instant of the options snapshot (all venues read together). |
[].expiry_at | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Expiry instant (08:00 UTC). Pass its date part (YYYY-MM-DD) as the expiry parameter. |
[].strike_usd | number | USD | Strike price. |
[].oi_call_usd | number | null | USD | Call open interest at this strike, USD. null = no call listed. |
[].oi_put_usd | number | null | USD | Put open interest at this strike, USD. null = no put listed. |
Essayer
GET https://api.bytnode.com/v1/options/oi/distribution?asset=BTC
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/options/oi/distribution?asset=BTC"{
"status": "ok",
"server_time": "2026-11-08T12:52:06.141Z",
"data_type": "options_oi_distribution",
"asset": "BTC",
"data": [
{
"time": "2026-11-08T12:51:31.126Z",
"expiry_at": "2026-11-09T08:00:00.000Z",
"strike_usd": 67000,
"oi_call_usd": null,
"oi_put_usd": 6604257.335
},
{
"time": "2026-11-08T12:51:31.126Z",
"expiry_at": "2026-11-09T08:00:00.000Z",
"strike_usd": 68000,
"oi_call_usd": null,
"oi_put_usd": 4619982.108
},
{
"time": "2026-11-08T12:51:31.126Z",
"expiry_at": "2026-11-09T08:00:00.000Z",
"strike_usd": 69000,
"oi_call_usd": null,
"oi_put_usd": 60659.256
}
]
}GET /v1/options/oi/history
Options open interest history. Per bucket. Most recent first, or oldest first with order=asc. Follow next to read the following page (it never repeats a row).
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
timeframe obligatoire | string | — | Bucket size, required: 5m, 15m, 30m, 1h, 4h or 1d (1m is not served on options). Missing: 422 missing_parameter; other values: 422 invalid_timeframe. |
since_ms | integer | — | Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range. |
until_ms | integer | — | Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next. |
limit | integer · 1–1000 | 100 | Number of rows to return, in the reading order (most recent first by default). Bounded by your plan's history window: an explicit limit (or since_ms) reaching beyond it returns 403 history_depth; without them the page simply stops at the window. |
asset obligatoire | string | — | Asset, e.g. BTC or ETH (no quote currency), in any case (eth works; the envelope gives the canonical form). Unknown: 422 invalid_asset. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,oi_total_usd. Unknown field: 422 unknown_field with a suggestion. |
before_ms | integer | — | Upper time bound, EXCLUSIVE, in epoch milliseconds: rows strictly before it. Pass the oldest time you received to read the previous page without repeating a row. Not combinable with until_ms (422 invalid_time_range). |
order | string | desc | Reading order: desc (most recent first, the default) or asc (oldest first, reading forward from since_ms, which is then required). Follow next to read the following page. |
7 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
[].time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Start of the bucket; the value is the LAST options snapshot of the bucket. |
[].oi_total_usd | number | USD | Total open interest, USD. |
[].oi_call_usd | number | null | USD | Call open interest, USD. |
[].oi_put_usd | number | null | USD | Put open interest, USD. |
[].oi_call | number | base asset quantity (BTC for BTCUSDT) | Call open interest, in coins (base asset). |
[].oi_put | number | base asset quantity (BTC for BTCUSDT) | Put open interest, in coins (base asset). |
[].is_closed | boolean | true = the row is final; false = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with ?live=1 on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades. |
Essayer
GET https://api.bytnode.com/v1/options/oi/history?timeframe=1h&limit=3&asset=BTC
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/options/oi/history?asset=BTC&timeframe=1h&limit=3"{
"status": "ok",
"server_time": "2026-11-08T12:52:04.386Z",
"data_type": "options_oi_history",
"timeframe": "1h",
"asset": "BTC",
"step": "1h",
"data": [
{
"time": "2026-11-08T11:00:00.000Z",
"oi_total_usd": 31561916147.5,
"oi_call_usd": 18065952735,
"oi_put_usd": 13495963412.5,
"oi_call": 236096.04,
"oi_put": 176480.37,
"is_closed": true
},
{
"time": "2026-11-08T10:00:00.000Z",
"oi_total_usd": 31500265075.3,
"oi_call_usd": 18025938049.9,
"oi_put_usd": 13474327025.4,
"oi_call": 235783.25,
"oi_put": 176357.63,
"is_closed": true
},
{
"time": "2026-11-08T09:00:00.000Z",
"oi_total_usd": 31500241082.4,
"oi_call_usd": 18027353605.9,
"oi_put_usd": 13472887476.5,
"oi_call": 235673.69,
"oi_put": 176243.49,
"is_closed": true
}
],
"next": "/v1/options/oi/history?asset=BTC&timeframe=1h&limit=3&before_ms=1794128400000&order=desc"
}GET /v1/options/put-call-ratio
Put/call ratio. Put/call open interest ratio (put_call_ratio) and its reading (put_call_label).
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
asset obligatoire | string | — | Asset, e.g. BTC or ETH (no quote currency), in any case (eth works; the envelope gives the canonical form). Unknown: 422 invalid_asset. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,put_call_ratio. Unknown field: 422 unknown_field with a suggestion. |
3 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Point-in-time value: the instant of the options snapshot (all venues read together). |
put_call_ratio | number | puts / calls | Put/call open interest ratio (a quotient, not a share: 1.2 = 1.2 puts per call). Below 1 = more calls than puts. |
put_call_label | string | bullish (put_call_ratio < 0.7), neutral, or bearish (put_call_ratio > 1). |
Essayer
GET https://api.bytnode.com/v1/options/put-call-ratio?asset=BTC
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/options/put-call-ratio?asset=BTC"{
"status": "ok",
"server_time": "2026-11-08T12:52:07.742Z",
"data_type": "options_put_call_ratio",
"asset": "BTC",
"data": {
"time": "2026-11-08T12:51:31.126Z",
"put_call_ratio": 0.746844876782,
"put_call_label": "neutral"
}
}GET /v1/options/put-call-ratio/history
Put/call ratio history. Per bucket. Most recent first, or oldest first with order=asc. Follow next to read the following page (it never repeats a row).
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
timeframe obligatoire | string | — | Bucket size, required: 5m, 15m, 30m, 1h, 4h or 1d (1m is not served on options). Missing: 422 missing_parameter; other values: 422 invalid_timeframe. |
since_ms | integer | — | Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range. |
until_ms | integer | — | Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next. |
limit | integer · 1–1000 | 100 | Number of rows to return, in the reading order (most recent first by default). Bounded by your plan's history window: an explicit limit (or since_ms) reaching beyond it returns 403 history_depth; without them the page simply stops at the window. |
asset obligatoire | string | — | Asset, e.g. BTC or ETH (no quote currency), in any case (eth works; the envelope gives the canonical form). Unknown: 422 invalid_asset. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,put_call_ratio. Unknown field: 422 unknown_field with a suggestion. |
before_ms | integer | — | Upper time bound, EXCLUSIVE, in epoch milliseconds: rows strictly before it. Pass the oldest time you received to read the previous page without repeating a row. Not combinable with until_ms (422 invalid_time_range). |
order | string | desc | Reading order: desc (most recent first, the default) or asc (oldest first, reading forward from since_ms, which is then required). Follow next to read the following page. |
4 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
[].time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Start of the bucket; the value is the LAST options snapshot of the bucket. |
[].put_call_ratio | number | puts / calls | Put/call open interest ratio (a quotient, not a share: 1.2 = 1.2 puts per call). Below 1 = more calls than puts. |
[].put_call_label | string | bullish (put_call_ratio < 0.7), neutral, or bearish (put_call_ratio > 1). | |
[].is_closed | boolean | true = the row is final; false = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with ?live=1 on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades. |
Essayer
GET https://api.bytnode.com/v1/options/put-call-ratio/history?timeframe=1h&limit=3&asset=BTC
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/options/put-call-ratio/history?asset=BTC&timeframe=1h&limit=3"{
"status": "ok",
"server_time": "2026-11-08T12:52:08.282Z",
"data_type": "options_put_call_ratio_history",
"timeframe": "1h",
"asset": "BTC",
"step": "1h",
"data": [
{
"time": "2026-11-08T11:00:00.000Z",
"put_call_ratio": 0.747038565333,
"put_call_label": "neutral",
"is_closed": true
},
{
"time": "2026-11-08T10:00:00.000Z",
"put_call_ratio": 0.747496578987,
"put_call_label": "neutral",
"is_closed": true
},
{
"time": "2026-11-08T09:00:00.000Z",
"put_call_ratio": 0.74735802997,
"put_call_label": "neutral",
"is_closed": true
}
],
"next": "/v1/options/put-call-ratio/history?asset=BTC&timeframe=1h&limit=3&before_ms=1794128400000&order=desc"
}GET /v1/options/summary
Options market summary. Open interest and volume (calls/puts, USD), put/call ratio and signal, 30-day ATM IV and the nearest expiry, aggregated across options venues.
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
asset obligatoire | string | — | Asset, e.g. BTC or ETH (no quote currency), in any case (eth works; the envelope gives the canonical form). Unknown: 422 invalid_asset. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,underlying_price_usd. Unknown field: 422 unknown_field with a suggestion. |
19 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Point-in-time value: the instant of the options snapshot (all venues read together). |
underlying_price_usd | number | USD | Index (spot) price of the underlying, from the options venues. Each expiry's ATM strike and greeks use that expiry's own forward price. Not the latest trade price: that is the price of /v1/price-change, i.e. the close of /v1/klines?live=1. |
oi_total_usd | number | USD | Total open interest, USD. |
oi_call_usd | number | null | USD | Call open interest, USD. |
oi_put_usd | number | null | USD | Put open interest, USD. |
volume_total_usd | number | USD | Total traded volume, USD. |
volume_call_usd | number | USD | Call volume, USD. |
volume_put_usd | number | USD | Put volume, USD. |
put_call_ratio | number | puts / calls | Put/call open interest ratio (a quotient, not a share: 1.2 = 1.2 puts per call). Below 1 = more calls than puts. |
put_call_label | string | bullish (put_call_ratio < 0.7), neutral, or bearish (put_call_ratio > 1). | |
iv_atm_30d_pct | number | percent (58.5 = 58.5 %) | At-the-money implied volatility at a constant 30-day maturity, annualised, in percent (55.2 = 55.2 %). Interpolated in total variance (IV² × time) between the two expiries around 30 days, so it does not jump when the nearest expiry rolls off; the ATM IV of each expiry is on /v1/options/expiry. |
nearest_expiry | object | The next expiry: its instant, the time left, max pain, put/call ratio, ATM IV. | |
nearest_expiry.expiry_at | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Expiry instant (08:00 UTC). Pass its date part (YYYY-MM-DD) as the expiry parameter. |
nearest_expiry.time_to_expiry_s | number | seconds | Time left before expiry, in seconds. |
nearest_expiry.max_pain_strike_usd | number | USD | Strike at which option holders lose the most at expiry (max pain). |
nearest_expiry.put_call_ratio | number | puts / calls | Put/call open interest ratio (a quotient, not a share: 1.2 = 1.2 puts per call). Below 1 = more calls than puts. |
nearest_expiry.iv_atm_pct | number | percent (58.5 = 58.5 %) | At-the-money implied volatility of THIS expiry, annualised, in percent (55.2 = 55.2 %). |
coverage | object | oi_coverage_ratio: share of the open interest covered by the venues that answered (1.0 = all). | |
coverage.oi_coverage_ratio | number | fraction (0.585 = 58.5 %) | Share of the open interest covered by the contributing venues. |
Essayer
GET https://api.bytnode.com/v1/options/summary?asset=BTC
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/options/summary?asset=BTC"{
"status": "ok",
"server_time": "2026-11-08T12:52:03.367Z",
"data_type": "options_summary",
"asset": "BTC",
"data": {
"time": "2026-11-08T12:51:31.126Z",
"underlying_price_usd": 75846.72,
"oi_total_usd": 31561194969.3,
"oi_call_usd": 18067543025,
"oi_put_usd": 13493651944.3,
"volume_total_usd": 190742286.678,
"volume_call_usd": 87834607.1867,
"volume_put_usd": 102907679.491,
"put_call_ratio": 0.746844876782,
"put_call_label": "neutral",
"iv_atm_30d_pct": 38.2231279733,
"nearest_expiry": {
"expiry_at": "2026-11-09T08:00:00.000Z",
"time_to_expiry_s": 68908.874,
"max_pain_strike_usd": 76000,
"put_call_ratio": 0.333545583281,
"iv_atm_pct": 31.2562557893
},
"coverage": {
"oi_coverage_ratio": 1
}
}
}GET /v1/options/volume
Options volume. Calls and puts traded, USD.
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
asset obligatoire | string | — | Asset, e.g. BTC or ETH (no quote currency), in any case (eth works; the envelope gives the canonical form). Unknown: 422 invalid_asset. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,volume_total_usd. Unknown field: 422 unknown_field with a suggestion. |
6 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Point-in-time value: the instant of the options snapshot (all venues read together). |
volume_total_usd | number | USD | Total traded volume, USD. |
volume_call_usd | number | USD | Call volume, USD. |
volume_put_usd | number | USD | Put volume, USD. |
coverage | object | oi_coverage_ratio: share of the open interest covered by the venues that answered (1.0 = all). | |
coverage.oi_coverage_ratio | number | fraction (0.585 = 58.5 %) | Share of the open interest covered by the contributing venues. |
Essayer
GET https://api.bytnode.com/v1/options/volume?asset=BTC
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/options/volume?asset=BTC"{
"status": "ok",
"server_time": "2026-11-08T12:52:06.693Z",
"data_type": "options_volume",
"asset": "BTC",
"data": {
"time": "2026-11-08T12:51:31.126Z",
"volume_total_usd": 190742286.678,
"volume_call_usd": 87834607.1867,
"volume_put_usd": 102907679.491,
"coverage": {
"oi_coverage_ratio": 1
}
}
}GET /v1/options/volume/history
Options volume history. Per bucket. Most recent first, or oldest first with order=asc. Follow next to read the following page (it never repeats a row).
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
timeframe obligatoire | string | — | Bucket size, required: 5m, 15m, 30m, 1h, 4h or 1d (1m is not served on options). Missing: 422 missing_parameter; other values: 422 invalid_timeframe. |
since_ms | integer | — | Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range. |
until_ms | integer | — | Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next. |
limit | integer · 1–1000 | 100 | Number of rows to return, in the reading order (most recent first by default). Bounded by your plan's history window: an explicit limit (or since_ms) reaching beyond it returns 403 history_depth; without them the page simply stops at the window. |
asset obligatoire | string | — | Asset, e.g. BTC or ETH (no quote currency), in any case (eth works; the envelope gives the canonical form). Unknown: 422 invalid_asset. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,volume_total_usd. Unknown field: 422 unknown_field with a suggestion. |
before_ms | integer | — | Upper time bound, EXCLUSIVE, in epoch milliseconds: rows strictly before it. Pass the oldest time you received to read the previous page without repeating a row. Not combinable with until_ms (422 invalid_time_range). |
order | string | desc | Reading order: desc (most recent first, the default) or asc (oldest first, reading forward from since_ms, which is then required). Follow next to read the following page. |
5 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
[].time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Start of the bucket; the value is the LAST options snapshot of the bucket. |
[].volume_total_usd | number | USD | Total traded volume, USD. |
[].volume_call_usd | number | USD | Call volume, USD. |
[].volume_put_usd | number | USD | Put volume, USD. |
[].is_closed | boolean | true = the row is final; false = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with ?live=1 on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades. |
Essayer
GET https://api.bytnode.com/v1/options/volume/history?timeframe=1h&limit=3&asset=BTC
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/options/volume/history?asset=BTC&timeframe=1h&limit=3"{
"status": "ok",
"server_time": "2026-11-08T12:52:07.207Z",
"data_type": "options_volume_history",
"timeframe": "1h",
"asset": "BTC",
"step": "1h",
"data": [
{
"time": "2026-11-08T11:00:00.000Z",
"volume_total_usd": 189269595.644,
"volume_call_usd": 87396088.6492,
"volume_put_usd": 101873506.995,
"is_closed": true
},
{
"time": "2026-11-08T10:00:00.000Z",
"volume_total_usd": 186316535.022,
"volume_call_usd": 85958948.942,
"volume_put_usd": 100357586.08,
"is_closed": true
},
{
"time": "2026-11-08T09:00:00.000Z",
"volume_total_usd": 186878464.059,
"volume_call_usd": 84626995.5539,
"volume_put_usd": 102251468.505,
"is_closed": true
}
],
"next": "/v1/options/volume/history?asset=BTC&timeframe=1h&limit=3&before_ms=1794128400000&order=desc"
}#Bitcoin network
Bitcoin chain state: recommended fees, mempool, mining pool concentration, difficulty and the next adjustment.
GET /v1/btc/fees
Recommended Bitcoin fees. Fee rates for each confirmation target (sat/vB): the rounded rates under the same names as the history, the unrounded ones as <name>_precise_sat_vb, and the fee pressure (fastest_economy_ratio and its label).
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,fastest_fee_sat_vb. Unknown field: 422 unknown_field with a suggestion. |
14 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Point-in-time value: the instant of the measurement (when the source was read). |
fastest_fee_sat_vb | integer | satoshis per virtual byte (sat/vB) | Fee rate for the next block. |
half_hour_fee_sat_vb | integer | satoshis per virtual byte (sat/vB) | Fee rate for confirmation within ~30 minutes. |
hour_fee_sat_vb | integer | satoshis per virtual byte (sat/vB) | Fee rate for confirmation within ~1 hour. |
economy_fee_sat_vb | integer | satoshis per virtual byte (sat/vB) | Fee rate for a low-priority confirmation. |
minimum_fee_sat_vb | integer | satoshis per virtual byte (sat/vB) | Minimum relay fee rate. |
fastest_fee_precise_sat_vb | number | satoshis per virtual byte (sat/vB) | fastest_fee_sat_vb, unrounded. |
half_hour_fee_precise_sat_vb | number | satoshis per virtual byte (sat/vB) | half_hour_fee_sat_vb, unrounded. |
hour_fee_precise_sat_vb | number | satoshis per virtual byte (sat/vB) | hour_fee_sat_vb, unrounded. |
economy_fee_precise_sat_vb | number | satoshis per virtual byte (sat/vB) | economy_fee_sat_vb, unrounded. |
minimum_fee_precise_sat_vb | number | satoshis per virtual byte (sat/vB) | minimum_fee_sat_vb, unrounded. |
fee_pressure | object | fastest_economy_ratio = fastest / economy fee rate, and its label: normal (<= 2), elevated (> 2), congested (> 5). | |
fee_pressure.fastest_economy_ratio | number | fastest / economy | Fastest fee rate divided by the economy fee rate (a quotient). |
fee_pressure.label | string | Fee pressure: normal (ratio <= 2), elevated (> 2) or congested (> 5). |
Essayer
GET https://api.bytnode.com/v1/btc/fees
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/btc/fees"{
"status": "ok",
"server_time": "2026-11-08T12:52:12.529Z",
"data_type": "btc_fees",
"data": {
"time": "2026-11-08T12:51:58.515Z",
"fastest_fee_sat_vb": 2,
"half_hour_fee_sat_vb": 1,
"hour_fee_sat_vb": 1,
"economy_fee_sat_vb": 1,
"minimum_fee_sat_vb": 1,
"fastest_fee_precise_sat_vb": 2.085,
"half_hour_fee_precise_sat_vb": 1.104,
"hour_fee_precise_sat_vb": 0.488,
"economy_fee_precise_sat_vb": 0.2,
"minimum_fee_precise_sat_vb": 0.1,
"fee_pressure": {
"fastest_economy_ratio": 2,
"label": "normal"
}
}
}GET /v1/btc/fees/history
Bitcoin fees history. Most recent first, or oldest first with order=asc. Follow next to read the following page (it never repeats a row).
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
since_ms | integer | — | Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range. |
until_ms | integer | — | Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next. |
limit | integer · 1–1000 | 100 | Number of rows to return, in the reading order (most recent first by default). Bounded by your plan's history window: an explicit limit (or since_ms) reaching beyond it returns 403 history_depth; without them the page simply stops at the window. |
timeframe | string | — | Optional row step: 1h, 4h or 1d — the LAST reading of each closed bucket, dated at the start of the bucket (the bucket in progress is not served). Without it: one row per reading of the source. Other values: 422 invalid_timeframe. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,fastest_fee_sat_vb. Unknown field: 422 unknown_field with a suggestion. |
before_ms | integer | — | Upper time bound, EXCLUSIVE, in epoch milliseconds: rows strictly before it. Pass the oldest time you received to read the previous page without repeating a row. Not combinable with until_ms (422 invalid_time_range). |
order | string | desc | Reading order: desc (most recent first, the default) or asc (oldest first, reading forward from since_ms, which is then required). Follow next to read the following page. |
7 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
[].time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Without timeframe: the instant of the reading. With timeframe: start of the bucket, the value being its LAST reading. |
[].fastest_fee_sat_vb | integer | satoshis per virtual byte (sat/vB) | Fee rate for the next block. |
[].half_hour_fee_sat_vb | integer | satoshis per virtual byte (sat/vB) | Fee rate for confirmation within ~30 minutes. |
[].hour_fee_sat_vb | integer | satoshis per virtual byte (sat/vB) | Fee rate for confirmation within ~1 hour. |
[].economy_fee_sat_vb | integer | satoshis per virtual byte (sat/vB) | Fee rate for a low-priority confirmation. |
[].minimum_fee_sat_vb | integer | satoshis per virtual byte (sat/vB) | Minimum relay fee rate. |
[].is_closed | boolean | true = the row is final; false = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with ?live=1 on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades. |
Essayer
GET https://api.bytnode.com/v1/btc/fees/history?limit=3
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/btc/fees/history?limit=3"{
"status": "ok",
"server_time": "2026-11-08T12:52:13.062Z",
"data_type": "btc_fees_history",
"step": "1m",
"data": [
{
"time": "2026-11-08T12:51:58.515Z",
"fastest_fee_sat_vb": 2,
"half_hour_fee_sat_vb": 1,
"hour_fee_sat_vb": 1,
"economy_fee_sat_vb": 1,
"minimum_fee_sat_vb": 1,
"is_closed": true
},
{
"time": "2026-11-08T12:50:58.469Z",
"fastest_fee_sat_vb": 2,
"half_hour_fee_sat_vb": 1,
"hour_fee_sat_vb": 1,
"economy_fee_sat_vb": 1,
"minimum_fee_sat_vb": 1,
"is_closed": true
},
{
"time": "2026-11-08T12:49:58.426Z",
"fastest_fee_sat_vb": 2,
"half_hour_fee_sat_vb": 1,
"hour_fee_sat_vb": 1,
"economy_fee_sat_vb": 1,
"minimum_fee_sat_vb": 1,
"is_closed": true
}
],
"next": "/v1/btc/fees/history?limit=3&before_ms=1794142198426&order=desc"
}GET /v1/btc/mempool
Bitcoin mempool. Pending transactions, virtual size, total fees, fee histogram and the 1 h / 4 h / 24 h trend.
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,tx_count. Unknown field: 422 unknown_field with a suggestion. |
10 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Point-in-time value: the instant of the measurement (when the source was read). |
tx_count | integer | count | Unconfirmed transactions in the mempool. |
vsize | integer | virtual bytes | Total virtual size of the mempool. |
total_fee_sats | integer | satoshis | Total fees waiting in the mempool. |
fee_histogram | number[][] | [fee_rate, vsize] pairs: how much virtual size (virtual bytes) waits at each fee rate (sat/vB). | |
trend | object | Mempool size change over 1 h, 4 h and 24 h, and its label (filling, draining, stable). | |
trend.vsize_change_1h | integer | virtual bytes | Mempool size change over 1 hour. |
trend.vsize_change_4h | integer | virtual bytes | Mempool size change over 4 hours. |
trend.vsize_change_24h | integer | virtual bytes | Mempool size change over 24 hours. |
trend.label | string | filling (vsize grew over 1 h), draining (shrank) or stable. |
Essayer
GET https://api.bytnode.com/v1/btc/mempool
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/btc/mempool"{
"status": "ok",
"server_time": "2026-11-08T12:52:13.579Z",
"data_type": "btc_mempool",
"data": {
"time": "2026-11-08T12:51:58.515Z",
"tx_count": 59805,
"vsize": 19831921,
"total_fee_sats": 3870622,
"fee_histogram": [
[
4.484305,
50152
],
[
3.1548116,
50467
],
[
3.000193,
62510
]
],
"trend": {
"vsize_change_1h": 6207739,
"vsize_change_4h": 5765766,
"vsize_change_24h": 7370214,
"label": "filling"
}
}
}GET /v1/btc/mempool/history
Mempool history. Most recent first, or oldest first with order=asc. Follow next to read the following page (it never repeats a row).
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
since_ms | integer | — | Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range. |
until_ms | integer | — | Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next. |
limit | integer · 1–1000 | 100 | Number of rows to return, in the reading order (most recent first by default). Bounded by your plan's history window: an explicit limit (or since_ms) reaching beyond it returns 403 history_depth; without them the page simply stops at the window. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,tx_count. Unknown field: 422 unknown_field with a suggestion. |
before_ms | integer | — | Upper time bound, EXCLUSIVE, in epoch milliseconds: rows strictly before it. Pass the oldest time you received to read the previous page without repeating a row. Not combinable with until_ms (422 invalid_time_range). |
order | string | desc | Reading order: desc (most recent first, the default) or asc (oldest first, reading forward from since_ms, which is then required). Follow next to read the following page. |
5 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
[].time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Point-in-time value: the instant of the measurement (when the source was read). |
[].tx_count | integer | count | Unconfirmed transactions in the mempool. |
[].vsize | integer | virtual bytes | Total virtual size of the mempool. |
[].total_fee_sats | integer | satoshis | Total fees waiting in the mempool. |
[].is_closed | boolean | true = the row is final; false = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with ?live=1 on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades. |
Essayer
GET https://api.bytnode.com/v1/btc/mempool/history?limit=3
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/btc/mempool/history?limit=3"{
"status": "ok",
"server_time": "2026-11-08T12:52:14.121Z",
"data_type": "btc_mempool_history",
"step": "1m",
"data": [
{
"time": "2026-11-08T12:51:58.515Z",
"tx_count": 59805,
"vsize": 19831921,
"total_fee_sats": 3870622,
"is_closed": true
},
{
"time": "2026-11-08T12:50:58.469Z",
"tx_count": 59637,
"vsize": 19791521,
"total_fee_sats": 3770151,
"is_closed": true
},
{
"time": "2026-11-08T12:49:58.426Z",
"tx_count": 59482,
"vsize": 19683178,
"total_fee_sats": 3522173,
"is_closed": true
}
],
"next": "/v1/btc/mempool/history?limit=3&before_ms=1794142198426&order=desc"
}GET /v1/btc/mining
Mining pool concentration. Share of the largest pools, pool ranking and the latest block reward in sats and USD, with the BTC price AT THAT BLOCK (latest_reward.btc_price_usd, with its block_height and time) — not the current price (see /v1/klines).
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time. Unknown field: 422 unknown_field with a suggestion. |
19 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Point-in-time value: the instant of the measurement (when the source was read). |
concentration | object | Mining pool concentration over the last period. | |
concentration.total_block_count | integer | count | Blocks in the period. |
concentration.top1_share_pct | number | percent (58.5 = 58.5 %) | Share of blocks mined by the largest pool. |
concentration.top3_share_pct | number | percent (58.5 = 58.5 %) | Share of blocks mined by the three largest pools. |
concentration.pool_count | integer | count | Number of pools that mined at least one block. |
concentration.label | string | Centralisation risk from the top-3 pool share: healthy (<= 40 %), moderate (> 40 %), high_risk (> 50 %). | |
latest_reward | object | Average block reward (subsidy + fees) of the latest blocks, in satoshis and USD. | |
latest_reward.time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Point-in-time value: the instant of the measurement (when the source was read). |
latest_reward.block_height | integer | block height | Height of a block: the latest block on /v1/btc/network; the reward sample in latest_reward; the block where a difficulty adjustment took effect on /v1/btc/mining/history?dataset=difficulty. |
latest_reward.avg_reward_sats | integer | satoshis | Average block reward. |
latest_reward.avg_reward_usd | number | USD | Average block reward in USD. |
latest_reward.btc_price_usd | number | USD | BTC price in USD at the time of the row: the current price on /v1/eth/price-btc, the price at the block of the reward in latest_reward of /v1/btc/mining (used for avg_reward_usd). |
pools | object[] | Pools ranked by blocks mined: name, slug, block_count, rank, share_pct. | |
pools[].name | string | Human-readable name. | |
pools[].slug | string | Stable identifier. | |
pools[].block_count | integer | count | Blocks mined over the period. |
pools[].rank | integer | rank (1 = first) | Rank. |
pools[].share_pct | number | percent (58.5 = 58.5 %) | Share of blocks. |
Essayer
GET https://api.bytnode.com/v1/btc/mining
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/btc/mining"{
"status": "ok",
"server_time": "2026-11-08T12:52:14.669Z",
"data_type": "btc_mining",
"data": {
"time": "2026-11-08T12:51:18.856Z",
"concentration": {
"total_block_count": 936,
"top1_share_pct": 24.1452991453,
"top3_share_pct": 60.8974358974,
"pool_count": 15,
"label": "high_risk"
},
"latest_reward": {
"time": "2026-11-08T12:40:01.000Z",
"block_height": 975062,
"avg_reward_sats": 313431969,
"avg_reward_usd": 237825.909438,
"btc_price_usd": 75878
},
"pools": [
{
"name": "Foundry USA",
"slug": "foundryusa",
"block_count": 226,
"rank": 1,
"share_pct": 24.1452991453
},
{
"name": "AntPool",
"slug": "antpool",
"block_count": 175,
"rank": 2,
"share_pct": 18.6965811966
},
{
"name": "F2Pool",
"slug": "f2pool",
"block_count": 169,
"rank": 3,
"share_pct": 18.0555555556
}
]
}
}GET /v1/btc/mining/history
Mining history. One series selected by dataset. Most recent first, or oldest first with order=asc. Follow next to read the following page (it never repeats a row).
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
dataset | string | concentration | Which mining series to return: concentration (pool shares), rewards (block rewards), difficulty or fee_rates. |
since_ms | integer | — | Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range. |
until_ms | integer | — | Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next. |
limit | integer · 1–1000 | 100 | Number of rows to return, in the reading order (most recent first by default). Bounded by your plan's history window: an explicit limit (or since_ms) reaching beyond it returns 403 history_depth; without them the page simply stops at the window. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,total_block_count. Unknown field: 422 unknown_field with a suggestion. |
before_ms | integer | — | Upper time bound, EXCLUSIVE, in epoch milliseconds: rows strictly before it. Pass the oldest time you received to read the previous page without repeating a row. Not combinable with until_ms (422 invalid_time_range). |
order | string | desc | Reading order: desc (most recent first, the default) or asc (oldest first, reading forward from since_ms, which is then required). Follow next to read the following page. |
22 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
[].time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Point-in-time value: the instant of the measurement (when the source was read). |
[].total_block_count | integer | count | Blocks in the period. |
[].top1_share_pct | number | percent (58.5 = 58.5 %) | Share of blocks mined by the largest pool. |
[].top3_share_pct | number | percent (58.5 = 58.5 %) | Share of blocks mined by the three largest pools. |
[].pool_count | integer | count | Number of pools that mined at least one block. |
[].label | string | Centralisation risk from the top-3 pool share: healthy (<= 40 %), moderate (> 40 %), high_risk (> 50 %). | |
[].is_closed | boolean | true = the row is final; false = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with ?live=1 on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades. | |
[].block_height | integer | null | block height | Height of a block: the latest block on /v1/btc/network; the reward sample in latest_reward; the block where a difficulty adjustment took effect on /v1/btc/mining/history?dataset=difficulty. |
[].avg_reward_sats | integer | null | satoshis | Average block reward. |
[].avg_reward_usd | number | null | USD | Average block reward in USD. |
[].btc_price_usd | number | null | USD | BTC price in USD at the time of the row: the current price on /v1/eth/price-btc, the price at the block of the reward in latest_reward of /v1/btc/mining (used for avg_reward_usd). |
[].difficulty | number | null | difficulty units | Network mining difficulty (on a difficulty-adjustment row, the difficulty after it). |
[].previous_difficulty | number | null | difficulty units | Difficulty before the adjustment. |
[].difficulty_change_pct | number | null | percent (58.5 = 58.5 %) | Expected difficulty change at the next adjustment (/v1/btc/mining/history?dataset=difficulty: the change applied at that adjustment). |
[].adjustment_multiplier | number | null | dimensionless ratio | difficulty / previous_difficulty (1.05 = a 5 % rise). |
[].fee_rate_p0_sat_vb | integer | null | satoshis per virtual byte (sat/vB) | Lowest fee rate paid in the blocks (0th percentile). |
[].fee_rate_p10_sat_vb | integer | null | satoshis per virtual byte (sat/vB) | 10th percentile of the fee rates paid in the blocks. |
[].fee_rate_p25_sat_vb | integer | null | satoshis per virtual byte (sat/vB) | 25th percentile of the fee rates paid in the blocks. |
[].fee_rate_p50_sat_vb | integer | null | satoshis per virtual byte (sat/vB) | Median fee rate paid in the blocks. |
[].fee_rate_p75_sat_vb | integer | null | satoshis per virtual byte (sat/vB) | 75th percentile of the fee rates paid in the blocks. |
[].fee_rate_p90_sat_vb | integer | null | satoshis per virtual byte (sat/vB) | 90th percentile of the fee rates paid in the blocks. |
[].fee_rate_p100_sat_vb | integer | null | satoshis per virtual byte (sat/vB) | Highest fee rate paid in the blocks. |
Essayer
GET https://api.bytnode.com/v1/btc/mining/history?dataset=concentration&limit=3
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/btc/mining/history?dataset=concentration&limit=3"{
"status": "ok",
"server_time": "2026-11-08T12:52:15.477Z",
"data_type": "btc_mining_history",
"dataset": "concentration",
"step": "10m",
"data": [
{
"time": "2026-11-08T12:51:18.856Z",
"total_block_count": 936,
"top1_share_pct": 24.1452991453,
"top3_share_pct": 60.8974358974,
"pool_count": 15,
"label": "high_risk",
"is_closed": true
},
{
"time": "2026-11-08T12:41:18.756Z",
"total_block_count": 934,
"top1_share_pct": 24.1970021413,
"top3_share_pct": 61.0278372591,
"pool_count": 15,
"label": "high_risk",
"is_closed": true
},
{
"time": "2026-11-08T12:31:18.658Z",
"total_block_count": 935,
"top1_share_pct": 24.2780748663,
"top3_share_pct": 61.0695187166,
"pool_count": 15,
"label": "high_risk",
"is_closed": true
}
],
"next": "/v1/btc/mining/history?dataset=concentration&limit=3&before_ms=1794141078658&order=desc"
}GET /v1/btc/network
Bitcoin network state. Height, difficulty and progress of the current period under the same names as the history, plus the 24 h block time and the details of the next difficulty adjustment.
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,difficulty. Unknown field: 422 unknown_field with a suggestion. |
14 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Point-in-time value: the instant of the measurement (when the source was read). |
difficulty | number | null | difficulty units | Network mining difficulty (on a difficulty-adjustment row, the difficulty after it). |
block_height | integer | block height | Height of a block: the latest block on /v1/btc/network; the reward sample in latest_reward; the block where a difficulty adjustment took effect on /v1/btc/mining/history?dataset=difficulty. |
progress_pct | number | percent (58.5 = 58.5 %) | Progress through the current 2016-block difficulty period. |
difficulty_change_pct | number | percent (58.5 = 58.5 %) | Expected difficulty change at the next adjustment (/v1/btc/mining/history?dataset=difficulty: the change applied at that adjustment). |
block_time | object | Average block time over 24 h (avg_24h_s), its deviation from the 600 s target, and a label. | |
block_time.avg_24h_s | number | seconds | Average block time over 24 hours. |
block_time.deviation_s | number | seconds | avg_24h_s - 600. |
block_time.label | string | 24 h block time versus the 600 s target: slow (> +30 s), fast (< -30 s) or on_target. | |
next_adjustment | object | Next difficulty adjustment: progress, expected change, date, remaining blocks and time. | |
next_adjustment.estimated_retarget_at | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Estimated instant of the next adjustment. |
next_adjustment.remaining_block_count | integer | count | Blocks left before the adjustment. |
next_adjustment.next_retarget_block_height | integer | block height | Height of the block of the next adjustment. |
next_adjustment.remaining_s | number | seconds | Estimated time left before the adjustment, seconds. |
Essayer
GET https://api.bytnode.com/v1/btc/network
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/btc/network"{
"status": "ok",
"server_time": "2026-11-08T12:52:16.080Z",
"data_type": "btc_network",
"data": {
"time": "2026-11-08T12:49:40.632Z",
"difficulty": 148364561003867,
"block_height": 975062,
"progress_pct": 66.1706349206,
"difficulty_change_pct": -4.74265055656,
"block_time": {
"avg_24h_s": 675.246031746,
"deviation_s": 75.246031746,
"label": "slow"
},
"next_adjustment": {
"estimated_retarget_at": "2026-11-13T12:14:32.608Z",
"remaining_block_count": 682,
"next_retarget_block_height": 975744,
"remaining_s": 429894.608
}
}
}GET /v1/btc/network/history
Network history. Most recent first, or oldest first with order=asc. Follow next to read the following page (it never repeats a row).
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
since_ms | integer | — | Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range. |
until_ms | integer | — | Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next. |
limit | integer · 1–1000 | 100 | Number of rows to return, in the reading order (most recent first by default). Bounded by your plan's history window: an explicit limit (or since_ms) reaching beyond it returns 403 history_depth; without them the page simply stops at the window. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,difficulty. Unknown field: 422 unknown_field with a suggestion. |
before_ms | integer | — | Upper time bound, EXCLUSIVE, in epoch milliseconds: rows strictly before it. Pass the oldest time you received to read the previous page without repeating a row. Not combinable with until_ms (422 invalid_time_range). |
order | string | desc | Reading order: desc (most recent first, the default) or asc (oldest first, reading forward from since_ms, which is then required). Follow next to read the following page. |
6 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
[].time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Point-in-time value: the instant of the measurement (when the source was read). |
[].difficulty | number | null | difficulty units | Network mining difficulty (on a difficulty-adjustment row, the difficulty after it). |
[].block_height | integer | block height | Height of a block: the latest block on /v1/btc/network; the reward sample in latest_reward; the block where a difficulty adjustment took effect on /v1/btc/mining/history?dataset=difficulty. |
[].progress_pct | number | percent (58.5 = 58.5 %) | Progress through the current 2016-block difficulty period. |
[].difficulty_change_pct | number | percent (58.5 = 58.5 %) | Expected difficulty change at the next adjustment (/v1/btc/mining/history?dataset=difficulty: the change applied at that adjustment). |
[].is_closed | boolean | true = the row is final; false = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with ?live=1 on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades. |
Essayer
GET https://api.bytnode.com/v1/btc/network/history?limit=3
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/btc/network/history?limit=3"{
"status": "ok",
"server_time": "2026-11-08T12:52:16.591Z",
"data_type": "btc_network_history",
"step": "5m",
"data": [
{
"time": "2026-11-08T12:49:40.632Z",
"difficulty": 148364561003867,
"block_height": 975062,
"progress_pct": 66.1706349206,
"difficulty_change_pct": -4.74265055656,
"is_closed": true
},
{
"time": "2026-11-08T12:44:40.588Z",
"difficulty": 148364561003867,
"block_height": 975062,
"progress_pct": 66.1706349206,
"difficulty_change_pct": -4.70888027581,
"is_closed": true
},
{
"time": "2026-11-08T12:39:40.352Z",
"difficulty": 148364561003867,
"block_height": 975061,
"progress_pct": 66.121031746,
"difficulty_change_pct": -4.74626375431,
"is_closed": true
}
],
"next": "/v1/btc/network/history?limit=3&before_ms=1794141580352&order=desc"
}#Ethereum
Ethereum fundamentals: gas, supply and burn, staking and yield, DeFi TVL, ETH/BTC ratio and derived signals (deflation, supply squeeze, gas momentum).
GET /v1/eth/defi
Ethereum DeFi. TVL, DEX volume, TVL / market cap and the 30-day trend.
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,tvl_usd. Unknown field: 422 unknown_field with a suggestion. |
8 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Point-in-time value: the instant of the measurement (when the source was read). |
tvl_usd | number | USD | Total value locked in Ethereum DeFi. |
dex_volume_24h_usd | number | null | USD | DEX volume over 24 h. |
dex_volume_7d_usd | number | null | USD | DEX volume over 7 days. |
eth_market_cap_usd | number | USD | ETH market capitalisation. |
defi_health_ratio | number | fraction (0.585 = 58.5 %) | tvl_usd / eth_market_cap_usd. |
defi_health_change_30d_pct | number | null | percent (58.5 = 58.5 %) | Relative change of defi_health_ratio (TVL / ETH market cap) over 30 days, percent. |
label | string | 30-day trend of defi_health_ratio (TVL / ETH market cap): growing, declining or stable. |
Essayer
GET https://api.bytnode.com/v1/eth/defi
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/eth/defi"{
"status": "ok",
"server_time": "2026-11-08T12:52:24.925Z",
"data_type": "eth_defi",
"data": {
"time": "2026-11-08T12:52:02.175Z",
"tvl_usd": 43358254681.1,
"dex_volume_24h_usd": 794814356.52,
"dex_volume_7d_usd": 12703593992.5,
"eth_market_cap_usd": 273518557539,
"defi_health_ratio": 0.158520339794,
"defi_health_change_30d_pct": -5.80953077907,
"label": "declining"
}
}GET /v1/eth/defi/history
DeFi history. One row per day. Most recent first, or oldest first with order=asc. Follow next to read the following page (it never repeats a row).
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
since_ms | integer | — | Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range. |
until_ms | integer | — | Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next. |
limit | integer · 1–1000 | 100 | Number of rows to return, in the reading order (most recent first by default). Bounded by your plan's history window: an explicit limit (or since_ms) reaching beyond it returns 403 history_depth; without them the page simply stops at the window. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,tvl_usd. Unknown field: 422 unknown_field with a suggestion. |
before_ms | integer | — | Upper time bound, EXCLUSIVE, in epoch milliseconds: rows strictly before it. Pass the oldest time you received to read the previous page without repeating a row. Not combinable with until_ms (422 invalid_time_range). |
order | string | desc | Reading order: desc (most recent first, the default) or asc (oldest first, reading forward from since_ms, which is then required). Follow next to read the following page. |
9 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
[].time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | The day, at midnight UTC; the value is the LAST measurement of that day. |
[].tvl_usd | number | USD | Total value locked in Ethereum DeFi. |
[].dex_volume_24h_usd | number | null | USD | DEX volume over 24 h. |
[].dex_volume_7d_usd | number | null | USD | DEX volume over 7 days. |
[].eth_market_cap_usd | number | USD | ETH market capitalisation. |
[].defi_health_ratio | number | fraction (0.585 = 58.5 %) | tvl_usd / eth_market_cap_usd. |
[].defi_health_change_30d_pct | number | null | percent (58.5 = 58.5 %) | Relative change of defi_health_ratio (TVL / ETH market cap) over 30 days, percent. |
[].label | string | null | 30-day trend of defi_health_ratio (TVL / ETH market cap): growing, declining or stable. | |
[].is_closed | boolean | true = the row is final; false = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with ?live=1 on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades. |
Essayer
GET https://api.bytnode.com/v1/eth/defi/history?limit=3
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/eth/defi/history?limit=3"{
"status": "ok",
"server_time": "2026-11-08T12:52:25.821Z",
"data_type": "eth_defi_history",
"step": "1d",
"data": [
{
"time": "2026-11-07T00:00:00.000Z",
"tvl_usd": 43296892871,
"dex_volume_24h_usd": 1688080819.41,
"dex_volume_7d_usd": 13792365451.1,
"eth_market_cap_usd": 272983032881,
"defi_health_ratio": 0.158606534678,
"defi_health_change_30d_pct": -6.41655088783,
"label": "declining",
"is_closed": true
},
{
"time": "2026-11-06T00:00:00.000Z",
"tvl_usd": 43252934565.3,
"dex_volume_24h_usd": 2730211736.14,
"dex_volume_7d_usd": 15851784047,
"eth_market_cap_usd": 273247086595,
"defi_health_ratio": 0.158292390613,
"defi_health_change_30d_pct": -5.19189511923,
"label": "declining",
"is_closed": true
},
{
"time": "2026-11-05T00:00:00.000Z",
"tvl_usd": 43283650929.1,
"dex_volume_24h_usd": 2440332261.87,
"dex_volume_7d_usd": 19365321924.3,
"eth_market_cap_usd": 272510501273,
"defi_health_ratio": 0.158832965067,
"defi_health_change_30d_pct": -3.46247634401,
"label": "declining",
"is_closed": true
}
],
"next": "/v1/eth/defi/history?limit=3&before_ms=1793836800000&order=desc"
}GET /v1/eth/deflation
ETH deflation. 24 h burn versus issuance and the annualised net supply change.
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,burn_24h. Unknown field: 422 unknown_field with a suggestion. |
5 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Point-in-time value: the instant of the measurement (when the source was read). |
burn_24h | number | null | ETH | ETH burnt over the last 24 h. |
net_issuance_24h | number | null | ETH | New ETH issued minus ETH burnt over 24 h. Negative = deflationary. |
net_issuance_annualized_pct | number | null | percent (58.5 = 58.5 %) | Net issuance annualised, as a percent of supply. Negative = the supply shrinks. |
label | string | deflationary (24 h net issuance < 0) or inflationary. |
Essayer
GET https://api.bytnode.com/v1/eth/deflation
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/eth/deflation"{
"status": "ok",
"server_time": "2026-11-08T12:52:21.859Z",
"data_type": "eth_deflation",
"data": {
"time": "2026-11-08T12:47:59.064Z",
"burn_24h": 11.2727003312,
"net_issuance_24h": 2983.24817616,
"net_issuance_annualized_pct": 0.891062002774,
"label": "inflationary"
}
}GET /v1/eth/deflation/history
Deflation history. One row per day. Most recent first, or oldest first with order=asc. Follow next to read the following page (it never repeats a row).
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
since_ms | integer | — | Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range. |
until_ms | integer | — | Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next. |
limit | integer · 1–1000 | 100 | Number of rows to return, in the reading order (most recent first by default). Bounded by your plan's history window: an explicit limit (or since_ms) reaching beyond it returns 403 history_depth; without them the page simply stops at the window. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,burn_24h. Unknown field: 422 unknown_field with a suggestion. |
before_ms | integer | — | Upper time bound, EXCLUSIVE, in epoch milliseconds: rows strictly before it. Pass the oldest time you received to read the previous page without repeating a row. Not combinable with until_ms (422 invalid_time_range). |
order | string | desc | Reading order: desc (most recent first, the default) or asc (oldest first, reading forward from since_ms, which is then required). Follow next to read the following page. |
6 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
[].time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | The day, at midnight UTC; the value is the LAST measurement of that day. |
[].burn_24h | number | null | ETH | ETH burnt over the last 24 h. |
[].net_issuance_24h | number | null | ETH | New ETH issued minus ETH burnt over 24 h. Negative = deflationary. |
[].net_issuance_annualized_pct | number | null | percent (58.5 = 58.5 %) | Net issuance annualised, as a percent of supply. Negative = the supply shrinks. |
[].label | string | null | deflationary (24 h net issuance < 0) or inflationary. | |
[].is_closed | boolean | true = the row is final; false = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with ?live=1 on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades. |
Essayer
GET https://api.bytnode.com/v1/eth/deflation/history?limit=3
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/eth/deflation/history?limit=3"{
"status": "ok",
"server_time": "2026-11-08T12:52:22.590Z",
"data_type": "eth_deflation_history",
"step": "1d",
"data": [
{
"time": "2026-11-07T00:00:00.000Z",
"burn_24h": 35.4133653371,
"net_issuance_24h": 2983.19655961,
"net_issuance_annualized_pct": 0.891056067136,
"label": "inflationary",
"is_closed": true
},
{
"time": "2026-11-06T00:00:00.000Z",
"burn_24h": 133.565159891,
"net_issuance_24h": 2963.79023159,
"net_issuance_annualized_pct": 0.88528116985,
"label": "inflationary",
"is_closed": true
},
{
"time": "2026-11-05T00:00:00.000Z",
"burn_24h": 52.4289467158,
"net_issuance_24h": 2844.03535852,
"net_issuance_annualized_pct": 0.849531114129,
"label": "inflationary",
"is_closed": true
}
],
"next": "/v1/eth/deflation/history?limit=3&before_ms=1793836800000&order=desc"
}GET /v1/eth/gas
Ethereum gas. Gas prices (gwei), base fee, block usage and congestion.
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,base_fee_gwei. Unknown field: 422 unknown_field with a suggestion. |
4 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Point-in-time value: the instant of the measurement (when the source was read). |
base_fee_gwei | number | gwei | EIP-1559 base fee (burnt). |
gas_used_ratio | number | fraction (0.585 = 58.5 %) | Block gas used / gas target over recent blocks. |
label | string | Congestion: low (gas_used_ratio < 0.5), normal, or high (> 0.8). |
Essayer
GET https://api.bytnode.com/v1/eth/gas
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/eth/gas"{
"status": "ok",
"server_time": "2026-11-08T12:52:17.163Z",
"data_type": "eth_gas",
"data": {
"time": "2026-11-08T12:47:59.064Z",
"base_fee_gwei": 0.033973573,
"gas_used_ratio": 0.514355255285,
"label": "normal"
}
}GET /v1/eth/gas-momentum
Gas momentum. 7-day versus 30-day base fee average: rising or falling demand for block space.
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,base_fee_gwei. Unknown field: 422 unknown_field with a suggestion. |
7 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Point-in-time value: the instant of the measurement (when the source was read). |
base_fee_gwei | number | gwei | EIP-1559 base fee (burnt). |
gas_used_ratio | number | fraction (0.585 = 58.5 %) | Block gas used / gas target over recent blocks. |
gas_sma_7d_gwei | number | gwei | 7-day simple moving average of the base fee. |
gas_sma_30d_gwei | number | gwei | 30-day simple moving average of the base fee. |
sma_7d_vs_30d_pct | number | percent (58.5 = 58.5 %) | (7-day simple moving average - 30-day simple moving average) / 30-day average, percent. |
label | string | high_demand (gas_used_ratio > 0.8 and sma_7d_vs_30d_pct > 0), low_demand (< 0.5 and sma_7d_vs_30d_pct < 0), otherwise normal. |
Essayer
GET https://api.bytnode.com/v1/eth/gas-momentum
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/eth/gas-momentum"{
"status": "ok",
"server_time": "2026-11-08T12:52:18.640Z",
"data_type": "eth_gas_momentum",
"data": {
"time": "2026-11-08T12:47:59.064Z",
"base_fee_gwei": 0.033973573,
"gas_used_ratio": 0.514355255285,
"gas_sma_7d_gwei": 0.18831936312,
"gas_sma_30d_gwei": 0.431214971248,
"sma_7d_vs_30d_pct": -56.3281945951,
"label": "normal"
}
}GET /v1/eth/gas-momentum/history
Gas momentum history. One row per day. Most recent first, or oldest first with order=asc. Follow next to read the following page (it never repeats a row).
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
since_ms | integer | — | Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range. |
until_ms | integer | — | Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next. |
limit | integer · 1–1000 | 100 | Number of rows to return, in the reading order (most recent first by default). Bounded by your plan's history window: an explicit limit (or since_ms) reaching beyond it returns 403 history_depth; without them the page simply stops at the window. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,base_fee_gwei. Unknown field: 422 unknown_field with a suggestion. |
before_ms | integer | — | Upper time bound, EXCLUSIVE, in epoch milliseconds: rows strictly before it. Pass the oldest time you received to read the previous page without repeating a row. Not combinable with until_ms (422 invalid_time_range). |
order | string | desc | Reading order: desc (most recent first, the default) or asc (oldest first, reading forward from since_ms, which is then required). Follow next to read the following page. |
8 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
[].time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | The day, at midnight UTC; the value is the LAST measurement of that day. |
[].base_fee_gwei | number | gwei | EIP-1559 base fee (burnt). |
[].gas_used_ratio | number | fraction (0.585 = 58.5 %) | Block gas used / gas target over recent blocks. |
[].gas_sma_7d_gwei | number | gwei | 7-day simple moving average of the base fee. |
[].gas_sma_30d_gwei | number | gwei | 30-day simple moving average of the base fee. |
[].sma_7d_vs_30d_pct | number | percent (58.5 = 58.5 %) | (7-day simple moving average - 30-day simple moving average) / 30-day average, percent. |
[].label | string | high_demand (gas_used_ratio > 0.8 and sma_7d_vs_30d_pct > 0), low_demand (< 0.5 and sma_7d_vs_30d_pct < 0), otherwise normal. | |
[].is_closed | boolean | true = the row is final; false = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with ?live=1 on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades. |
Essayer
GET https://api.bytnode.com/v1/eth/gas-momentum/history?limit=3
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/eth/gas-momentum/history?limit=3"{
"status": "ok",
"server_time": "2026-11-08T12:52:19.440Z",
"data_type": "eth_gas_momentum_history",
"step": "1d",
"data": [
{
"time": "2026-11-07T00:00:00.000Z",
"base_fee_gwei": 0.034265274,
"gas_used_ratio": 0.480113603333,
"gas_sma_7d_gwei": 0.18831936312,
"gas_sma_30d_gwei": 0.431214971248,
"sma_7d_vs_30d_pct": -56.3281945951,
"label": "low_demand",
"is_closed": true
},
{
"time": "2026-11-06T00:00:00.000Z",
"base_fee_gwei": 0.041685805,
"gas_used_ratio": 0.488086706667,
"gas_sma_7d_gwei": 0.192059069299,
"gas_sma_30d_gwei": 0.461027820291,
"sma_7d_vs_30d_pct": -58.3411106995,
"label": "low_demand",
"is_closed": true
},
{
"time": "2026-11-05T00:00:00.000Z",
"base_fee_gwei": 0.055939064,
"gas_used_ratio": 0.43538465,
"gas_sma_7d_gwei": 0.329075219195,
"gas_sma_30d_gwei": 0.47792545541,
"sma_7d_vs_30d_pct": -31.1450738875,
"label": "low_demand",
"is_closed": true
}
],
"next": "/v1/eth/gas-momentum/history?limit=3&before_ms=1793836800000&order=desc"
}GET /v1/eth/gas/history
Gas history. One row per day. Most recent first, or oldest first with order=asc. Follow next to read the following page (it never repeats a row).
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
since_ms | integer | — | Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range. |
until_ms | integer | — | Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next. |
limit | integer · 1–1000 | 100 | Number of rows to return, in the reading order (most recent first by default). Bounded by your plan's history window: an explicit limit (or since_ms) reaching beyond it returns 403 history_depth; without them the page simply stops at the window. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,base_fee_gwei. Unknown field: 422 unknown_field with a suggestion. |
before_ms | integer | — | Upper time bound, EXCLUSIVE, in epoch milliseconds: rows strictly before it. Pass the oldest time you received to read the previous page without repeating a row. Not combinable with until_ms (422 invalid_time_range). |
order | string | desc | Reading order: desc (most recent first, the default) or asc (oldest first, reading forward from since_ms, which is then required). Follow next to read the following page. |
5 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
[].time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | The day, at midnight UTC; the value is the LAST measurement of that day. |
[].base_fee_gwei | number | gwei | EIP-1559 base fee (burnt). |
[].gas_used_ratio | number | fraction (0.585 = 58.5 %) | Block gas used / gas target over recent blocks. |
[].label | string | Congestion: low (gas_used_ratio < 0.5), normal, or high (> 0.8). | |
[].is_closed | boolean | true = the row is final; false = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with ?live=1 on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades. |
Essayer
GET https://api.bytnode.com/v1/eth/gas/history?limit=3
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/eth/gas/history?limit=3"{
"status": "ok",
"server_time": "2026-11-08T12:52:17.939Z",
"data_type": "eth_gas_history",
"step": "1d",
"data": [
{
"time": "2026-11-07T00:00:00.000Z",
"base_fee_gwei": 0.034265274,
"gas_used_ratio": 0.480113603333,
"label": "low",
"is_closed": true
},
{
"time": "2026-11-06T00:00:00.000Z",
"base_fee_gwei": 0.041685805,
"gas_used_ratio": 0.488086706667,
"label": "low",
"is_closed": true
},
{
"time": "2026-11-05T00:00:00.000Z",
"base_fee_gwei": 0.055939064,
"gas_used_ratio": 0.43538465,
"label": "low",
"is_closed": true
}
],
"next": "/v1/eth/gas/history?limit=3&before_ms=1793836800000&order=desc"
}GET /v1/eth/price-btc
ETH price in BTC. The ETH price in BTC (eth_price_btc), with both USD prices, its 7-day change and which asset outperforms.
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,eth_price_usd. Unknown field: 422 unknown_field with a suggestion. |
6 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Point-in-time value: the instant of the measurement (when the source was read). |
eth_price_usd | number | USD | ETH price. |
btc_price_usd | number | USD | BTC price in USD at the time of the row: the current price on /v1/eth/price-btc, the price at the block of the reward in latest_reward of /v1/btc/mining (used for avg_reward_usd). |
eth_price_btc | number | BTC | ETH price in BTC (ETH price / BTC price). |
change_7d_pct | number | null | percent (58.5 = 58.5 %) | Relative change of the value over 7 days, percent. |
label | string | 7-day momentum of ETH/BTC: eth_outperform (> 0), btc_outperform (< 0) or neutral. |
Essayer
GET https://api.bytnode.com/v1/eth/price-btc
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/eth/price-btc"{
"status": "ok",
"server_time": "2026-11-08T12:52:26.672Z",
"data_type": "eth_price_btc",
"data": {
"time": "2026-11-08T12:51:07.379Z",
"eth_price_usd": 2238.27,
"btc_price_usd": 75948.79,
"eth_price_btc": 0.0294707789288,
"change_7d_pct": 1.47320191034,
"label": "eth_outperform"
}
}GET /v1/eth/price-btc/history
ETH price in BTC history. One row per day. Most recent first, or oldest first with order=asc. Follow next to read the following page (it never repeats a row).
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
since_ms | integer | — | Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range. |
until_ms | integer | — | Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next. |
limit | integer · 1–1000 | 100 | Number of rows to return, in the reading order (most recent first by default). Bounded by your plan's history window: an explicit limit (or since_ms) reaching beyond it returns 403 history_depth; without them the page simply stops at the window. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,eth_price_usd. Unknown field: 422 unknown_field with a suggestion. |
before_ms | integer | — | Upper time bound, EXCLUSIVE, in epoch milliseconds: rows strictly before it. Pass the oldest time you received to read the previous page without repeating a row. Not combinable with until_ms (422 invalid_time_range). |
order | string | desc | Reading order: desc (most recent first, the default) or asc (oldest first, reading forward from since_ms, which is then required). Follow next to read the following page. |
7 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
[].time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | The day, at midnight UTC; the value is the LAST measurement of that day. |
[].eth_price_usd | number | USD | ETH price. |
[].btc_price_usd | number | USD | BTC price in USD at the time of the row: the current price on /v1/eth/price-btc, the price at the block of the reward in latest_reward of /v1/btc/mining (used for avg_reward_usd). |
[].eth_price_btc | number | BTC | ETH price in BTC (ETH price / BTC price). |
[].change_7d_pct | number | null | percent (58.5 = 58.5 %) | Relative change of the value over 7 days, percent. |
[].label | string | null | 7-day momentum of ETH/BTC: eth_outperform (> 0), btc_outperform (< 0) or neutral. | |
[].is_closed | boolean | true = the row is final; false = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with ?live=1 on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades. |
Essayer
GET https://api.bytnode.com/v1/eth/price-btc/history?limit=3
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/eth/price-btc/history?limit=3"{
"status": "ok",
"server_time": "2026-11-08T12:52:27.446Z",
"data_type": "eth_price_btc_history",
"step": "1d",
"data": [
{
"time": "2026-11-07T00:00:00.000Z",
"eth_price_usd": 2239.51,
"btc_price_usd": 75901.01,
"eth_price_btc": 0.0295056679746,
"change_7d_pct": 1.47363595754,
"label": "eth_outperform",
"is_closed": true
},
{
"time": "2026-11-06T00:00:00.000Z",
"eth_price_usd": 2239.02,
"btc_price_usd": 75924.01,
"eth_price_btc": 0.0294902758693,
"change_7d_pct": 1.60472163423,
"label": "eth_outperform",
"is_closed": true
},
{
"time": "2026-11-05T00:00:00.000Z",
"eth_price_usd": 2235.89,
"btc_price_usd": 75966,
"eth_price_btc": 0.0294327725561,
"change_7d_pct": 1.96265863145,
"label": "eth_outperform",
"is_closed": true
}
],
"next": "/v1/eth/price-btc/history?limit=3&before_ms=1793836800000&order=desc"
}GET /v1/eth/squeeze
ETH supply squeeze index. 0-100 index combining the staked share and net issuance.
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,staking_ratio. Unknown field: 422 unknown_field with a suggestion. |
5 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Point-in-time value: the instant of the measurement (when the source was read). |
staking_ratio | number | null | fraction (0.585 = 58.5 %) | Share of the ETH supply staked. |
net_issuance_annualized_pct | number | null | percent (58.5 = 58.5 %) | Net issuance annualised, as a percent of supply. Negative = the supply shrinks. |
squeeze_index | number | null | score from 0 to 100 | Supply squeeze index: combines the staked share and net issuance. Higher = less liquid ETH available. |
label | string | low (< 33), moderate (>= 33), high (>= 66). |
Essayer
GET https://api.bytnode.com/v1/eth/squeeze
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/eth/squeeze"{
"status": "ok",
"server_time": "2026-11-08T12:52:28.307Z",
"data_type": "eth_squeeze",
"data": {
"time": "2026-11-08T12:47:59.064Z",
"staking_ratio": 0.364607556953,
"net_issuance_annualized_pct": 0.891062002774,
"squeeze_index": 18.675908849,
"label": "low"
}
}GET /v1/eth/squeeze/history
Supply squeeze history. One row per day. Most recent first, or oldest first with order=asc. Follow next to read the following page (it never repeats a row).
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
since_ms | integer | — | Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range. |
until_ms | integer | — | Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next. |
limit | integer · 1–1000 | 100 | Number of rows to return, in the reading order (most recent first by default). Bounded by your plan's history window: an explicit limit (or since_ms) reaching beyond it returns 403 history_depth; without them the page simply stops at the window. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,staking_ratio. Unknown field: 422 unknown_field with a suggestion. |
before_ms | integer | — | Upper time bound, EXCLUSIVE, in epoch milliseconds: rows strictly before it. Pass the oldest time you received to read the previous page without repeating a row. Not combinable with until_ms (422 invalid_time_range). |
order | string | desc | Reading order: desc (most recent first, the default) or asc (oldest first, reading forward from since_ms, which is then required). Follow next to read the following page. |
6 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
[].time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | The day, at midnight UTC; the value is the LAST measurement of that day. |
[].staking_ratio | number | null | fraction (0.585 = 58.5 %) | Share of the ETH supply staked. |
[].net_issuance_annualized_pct | number | null | percent (58.5 = 58.5 %) | Net issuance annualised, as a percent of supply. Negative = the supply shrinks. |
[].squeeze_index | number | null | score from 0 to 100 | Supply squeeze index: combines the staked share and net issuance. Higher = less liquid ETH available. |
[].label | string | null | low (< 33), moderate (>= 33), high (>= 66). | |
[].is_closed | boolean | true = the row is final; false = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with ?live=1 on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades. |
Essayer
GET https://api.bytnode.com/v1/eth/squeeze/history?limit=3
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/eth/squeeze/history?limit=3"{
"status": "ok",
"server_time": "2026-11-08T12:52:28.992Z",
"data_type": "eth_squeeze_history",
"step": "1d",
"data": [
{
"time": "2026-11-07T00:00:00.000Z",
"staking_ratio": 0.364396059924,
"net_issuance_annualized_pct": 0.891056067136,
"squeeze_index": 18.6653310298,
"label": "low",
"is_closed": true
},
{
"time": "2026-11-06T00:00:00.000Z",
"staking_ratio": 0.364378601626,
"net_issuance_annualized_pct": 0.88528116985,
"squeeze_index": 18.6615706662,
"label": "low",
"is_closed": true
},
{
"time": "2026-11-05T00:00:00.000Z",
"staking_ratio": 0.364270335948,
"net_issuance_annualized_pct": 0.849531114129,
"squeeze_index": 18.6382823544,
"label": "low",
"is_closed": true
}
],
"next": "/v1/eth/squeeze/history?limit=3&before_ms=1793836800000&order=desc"
}GET /v1/eth/staking
ETH staking. Share of ETH staked, total staked and the staking APR. The Fed funds rate is served by /v1/macro (series DFF).
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,staking_ratio. Unknown field: 422 unknown_field with a suggestion. |
5 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Point-in-time value: the instant of the measurement (when the source was read). |
staking_ratio | number | null | fraction (0.585 = 58.5 %) | Share of the ETH supply staked. |
total_staked | number | null | ETH | ETH staked (beacon chain). |
total_supply | number | null | coins | Total coins issued (circulating + locked), net of burns. |
apr_pct | number | null | percent (58.5 = 58.5 %) | Annualised rate in percent. |
Essayer
GET https://api.bytnode.com/v1/eth/staking
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/eth/staking"{
"status": "ok",
"server_time": "2026-11-08T12:52:23.124Z",
"data_type": "eth_staking",
"data": {
"time": "2026-11-08T12:43:07.522Z",
"staking_ratio": 0.364607556953,
"total_staked": 44555363.3144,
"total_supply": 122200877.257,
"apr_pct": 2.25474
}
}GET /v1/eth/staking/history
Staking history. One row per day. Most recent first, or oldest first with order=asc. Follow next to read the following page (it never repeats a row).
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
since_ms | integer | — | Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range. |
until_ms | integer | — | Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next. |
limit | integer · 1–1000 | 100 | Number of rows to return, in the reading order (most recent first by default). Bounded by your plan's history window: an explicit limit (or since_ms) reaching beyond it returns 403 history_depth; without them the page simply stops at the window. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,staking_ratio. Unknown field: 422 unknown_field with a suggestion. |
before_ms | integer | — | Upper time bound, EXCLUSIVE, in epoch milliseconds: rows strictly before it. Pass the oldest time you received to read the previous page without repeating a row. Not combinable with until_ms (422 invalid_time_range). |
order | string | desc | Reading order: desc (most recent first, the default) or asc (oldest first, reading forward from since_ms, which is then required). Follow next to read the following page. |
6 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
[].time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | The day, at midnight UTC; the value is the LAST measurement of that day. |
[].staking_ratio | number | null | fraction (0.585 = 58.5 %) | Share of the ETH supply staked. |
[].total_staked | number | null | ETH | ETH staked (beacon chain). |
[].total_supply | number | null | coins | Total coins issued (circulating + locked), net of burns. |
[].apr_pct | number | null | percent (58.5 = 58.5 %) | Annualised rate in percent. |
[].is_closed | boolean | true = the row is final; false = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with ?live=1 on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades. |
Essayer
GET https://api.bytnode.com/v1/eth/staking/history?limit=3
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/eth/staking/history?limit=3"{
"status": "ok",
"server_time": "2026-11-08T12:52:23.856Z",
"data_type": "eth_staking_history",
"step": "1d",
"data": [
{
"time": "2026-11-07T00:00:00.000Z",
"staking_ratio": 0.364396059924,
"total_staked": 44529044.358,
"total_supply": 122199576.931,
"apr_pct": 2.25474,
"is_closed": true
},
{
"time": "2026-11-06T00:00:00.000Z",
"staking_ratio": 0.364378601626,
"total_staked": 44525823.9483,
"total_supply": 122196593.734,
"apr_pct": 2.71121,
"is_closed": true
},
{
"time": "2026-11-05T00:00:00.000Z",
"staking_ratio": 0.364270335948,
"total_staked": 44511514.6304,
"total_supply": 122193629.944,
"apr_pct": 2.26242,
"is_closed": true
}
],
"next": "/v1/eth/staking/history?limit=3&before_ms=1793836800000&order=desc"
}GET /v1/eth/supply
ETH supply and burn. Supply, staking, burnt fees, withdrawals, 24 h burn and net issuance.
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,execution_issuance_cumulative. Unknown field: 422 unknown_field with a suggestion. |
9 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Point-in-time value: the instant of the measurement (when the source was read). |
execution_issuance_cumulative | number | null | ETH | Cumulative execution-layer issuance (genesis + proof-of-work rewards before the Merge), as published by Etherscan. NOT the supply: total_supply = this + consensus_rewards_cumulative - burnt_fees_cumulative (was eth_supply). |
consensus_rewards_cumulative | number | null | ETH | Cumulative consensus-layer issuance (staking rewards) since the Beacon Chain launch. NOT the ETH staked: see total_staked on /v1/eth/staking. |
burnt_fees_cumulative | number | null | ETH | ETH burnt since EIP-1559 (cumulative). |
withdrawn_cumulative | number | null | ETH | ETH withdrawn from staking (cumulative). |
total_supply | number | null | coins | Total coins issued (circulating + locked), net of burns. |
burn_24h | number | null | ETH | ETH burnt over the last 24 h. |
net_issuance_24h | number | null | ETH | New ETH issued minus ETH burnt over 24 h. Negative = deflationary. |
label | string | deflationary (24 h net issuance < 0), inflationary (> 0) or neutral. |
Essayer
GET https://api.bytnode.com/v1/eth/supply
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/eth/supply"{
"status": "ok",
"server_time": "2026-11-08T12:52:20.341Z",
"data_type": "eth_supply",
"data": {
"time": "2026-11-08T12:47:59.064Z",
"execution_issuance_cumulative": 122373866.218,
"consensus_rewards_cumulative": 4470267.30596,
"burnt_fees_cumulative": 4643256.26631,
"withdrawn_cumulative": 7618584.34895,
"total_supply": 122200877.257,
"burn_24h": 11.2727003312,
"net_issuance_24h": 2983.24817616,
"label": "inflationary"
}
}GET /v1/eth/supply/history
ETH supply history. One row per day. Most recent first, or oldest first with order=asc. Follow next to read the following page (it never repeats a row).
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
since_ms | integer | — | Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range. |
until_ms | integer | — | Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next. |
limit | integer · 1–1000 | 100 | Number of rows to return, in the reading order (most recent first by default). Bounded by your plan's history window: an explicit limit (or since_ms) reaching beyond it returns 403 history_depth; without them the page simply stops at the window. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,execution_issuance_cumulative. Unknown field: 422 unknown_field with a suggestion. |
before_ms | integer | — | Upper time bound, EXCLUSIVE, in epoch milliseconds: rows strictly before it. Pass the oldest time you received to read the previous page without repeating a row. Not combinable with until_ms (422 invalid_time_range). |
order | string | desc | Reading order: desc (most recent first, the default) or asc (oldest first, reading forward from since_ms, which is then required). Follow next to read the following page. |
10 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
[].time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | The day, at midnight UTC; the value is the LAST measurement of that day. |
[].execution_issuance_cumulative | number | null | ETH | Cumulative execution-layer issuance (genesis + proof-of-work rewards before the Merge), as published by Etherscan. NOT the supply: total_supply = this + consensus_rewards_cumulative - burnt_fees_cumulative (was eth_supply). |
[].consensus_rewards_cumulative | number | null | ETH | Cumulative consensus-layer issuance (staking rewards) since the Beacon Chain launch. NOT the ETH staked: see total_staked on /v1/eth/staking. |
[].burnt_fees_cumulative | number | null | ETH | ETH burnt since EIP-1559 (cumulative). |
[].withdrawn_cumulative | number | null | ETH | ETH withdrawn from staking (cumulative). |
[].total_supply | number | null | coins | Total coins issued (circulating + locked), net of burns. |
[].burn_24h | number | null | ETH | ETH burnt over the last 24 h. |
[].net_issuance_24h | number | null | ETH | New ETH issued minus ETH burnt over 24 h. Negative = deflationary. |
[].label | string | null | deflationary (24 h net issuance < 0), inflationary (> 0) or neutral. | |
[].is_closed | boolean | true = the row is final; false = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with ?live=1 on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades. |
Essayer
GET https://api.bytnode.com/v1/eth/supply/history?limit=3
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/eth/supply/history?limit=3"{
"status": "ok",
"server_time": "2026-11-08T12:52:21.089Z",
"data_type": "eth_supply_history",
"step": "1d",
"data": [
{
"time": "2026-11-07T00:00:00.000Z",
"execution_issuance_cumulative": 122373866.218,
"consensus_rewards_cumulative": 4467272.78508,
"burnt_fees_cumulative": 4643244.99361,
"withdrawn_cumulative": 7618584.34895,
"total_supply": 122199576.931,
"burn_24h": 35.4133653371,
"net_issuance_24h": 2983.19655961,
"label": "inflationary",
"is_closed": true
},
{
"time": "2026-11-06T00:00:00.000Z",
"execution_issuance_cumulative": 122373866.218,
"consensus_rewards_cumulative": 4464273.57918,
"burnt_fees_cumulative": 4643209.58025,
"withdrawn_cumulative": 7618584.34895,
"total_supply": 122196593.734,
"burn_24h": 133.565159891,
"net_issuance_24h": 2963.79023159,
"label": "inflationary",
"is_closed": true
},
{
"time": "2026-11-05T00:00:00.000Z",
"execution_issuance_cumulative": 122373866.218,
"consensus_rewards_cumulative": 4461281.65252,
"burnt_fees_cumulative": 4643076.01509,
"withdrawn_cumulative": 7618584.34895,
"total_supply": 122193629.944,
"burn_24h": 52.4289467158,
"net_issuance_24h": 2844.03535852,
"label": "inflationary",
"is_closed": true
}
],
"next": "/v1/eth/supply/history?limit=3&before_ms=1793836800000&order=desc"
}#On-chain Bitcoin
Daily on-chain valuation and activity: MVRV, NVT, active addresses, miner stress.
GET /v1/btc/active-addresses
Bitcoin active addresses. Daily active addresses, 7- and 30-day averages and momentum.
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,active_addresses. Unknown field: 422 unknown_field with a suggestion. |
6 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | The day the value refers to, at midnight UTC. |
active_addresses | number | count | Addresses active on the day. |
active_addresses_sma_7d | number | count | 7-day simple moving average of active_addresses. |
active_addresses_sma_30d | number | count | 30-day simple moving average of active_addresses. |
sma_7d_vs_30d_pct | number | percent (58.5 = 58.5 %) | (7-day simple moving average - 30-day simple moving average) / 30-day average, percent. |
label | string | 7-day vs 30-day average: accelerating (> +5 %), decelerating (< -5 %) or stable. |
Essayer
GET https://api.bytnode.com/v1/btc/active-addresses
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/btc/active-addresses"{
"status": "ok",
"server_time": "2026-11-08T12:52:31.850Z",
"data_type": "btc_active_addresses",
"data": {
"time": "2026-11-07T00:00:00.000Z",
"active_addresses": 633362,
"active_addresses_sma_7d": 669746.857143,
"active_addresses_sma_30d": 638659,
"sma_7d_vs_30d_pct": 4.867676983,
"label": "stable"
}
}GET /v1/btc/active-addresses/history
Active addresses history. One point per day. Most recent first, or oldest first with order=asc. Follow next to read the following page (it never repeats a row).
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
since_ms | integer | — | Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range. |
until_ms | integer | — | Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next. |
limit | integer · 1–1000 | 100 | Number of rows to return, in the reading order (most recent first by default). Bounded by your plan's history window: an explicit limit (or since_ms) reaching beyond it returns 403 history_depth; without them the page simply stops at the window. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,active_addresses. Unknown field: 422 unknown_field with a suggestion. |
before_ms | integer | — | Upper time bound, EXCLUSIVE, in epoch milliseconds: rows strictly before it. Pass the oldest time you received to read the previous page without repeating a row. Not combinable with until_ms (422 invalid_time_range). |
order | string | desc | Reading order: desc (most recent first, the default) or asc (oldest first, reading forward from since_ms, which is then required). Follow next to read the following page. |
7 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
[].time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | The day the value refers to, at midnight UTC. |
[].active_addresses | number | count | Addresses active on the day. |
[].active_addresses_sma_7d | number | count | 7-day simple moving average of active_addresses. |
[].active_addresses_sma_30d | number | count | 30-day simple moving average of active_addresses. |
[].sma_7d_vs_30d_pct | number | percent (58.5 = 58.5 %) | (7-day simple moving average - 30-day simple moving average) / 30-day average, percent. |
[].label | string | 7-day vs 30-day average: accelerating (> +5 %), decelerating (< -5 %) or stable. | |
[].is_closed | boolean | true = the row is final; false = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with ?live=1 on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades. |
Essayer
GET https://api.bytnode.com/v1/btc/active-addresses/history?limit=3
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/btc/active-addresses/history?limit=3"{
"status": "ok",
"server_time": "2026-11-08T12:52:32.402Z",
"data_type": "btc_active_addresses_history",
"step": "1d",
"data": [
{
"time": "2026-11-07T00:00:00.000Z",
"active_addresses": 633362,
"active_addresses_sma_7d": 669746.857143,
"active_addresses_sma_30d": 638659,
"sma_7d_vs_30d_pct": 4.867676983,
"label": "stable",
"is_closed": true
},
{
"time": "2026-11-06T00:00:00.000Z",
"active_addresses": 693063,
"active_addresses_sma_7d": 664666.285714,
"active_addresses_sma_30d": 639319.133333,
"sma_7d_vs_30d_pct": 3.96471043324,
"label": "stable",
"is_closed": true
},
{
"time": "2026-11-05T00:00:00.000Z",
"active_addresses": 741025,
"active_addresses_sma_7d": 680087,
"active_addresses_sma_30d": 637241.5,
"sma_7d_vs_30d_pct": 6.72358909456,
"label": "accelerating",
"is_closed": true
}
],
"next": "/v1/btc/active-addresses/history?limit=3&before_ms=1793836800000&order=desc"
}GET /v1/btc/mvrv
Bitcoin MVRV. Market value / realised value with its zone and 30-day momentum. Daily.
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,mvrv. Unknown field: 422 unknown_field with a suggestion. |
4 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | The day the value refers to, at midnight UTC. |
mvrv | number | dimensionless ratio | Market value / realised value. |
label | string | undervalued (<= 1), fair (> 1), elevated (> 2.5), overvalued (> 3.5). | |
change_30d_pct | number | null | percent (58.5 = 58.5 %) | Relative change of the value over 30 days, percent. |
Essayer
GET https://api.bytnode.com/v1/btc/mvrv
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/btc/mvrv"{
"status": "ok",
"server_time": "2026-11-08T12:52:29.597Z",
"data_type": "btc_mvrv",
"data": {
"time": "2026-11-01T00:00:00.000Z",
"mvrv": 1.4493,
"label": "fair",
"change_30d_pct": -8.67099376142
}
}GET /v1/btc/mvrv/history
MVRV history. One point per day. Most recent first, or oldest first with order=asc. Follow next to read the following page (it never repeats a row).
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
since_ms | integer | — | Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range. |
until_ms | integer | — | Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next. |
limit | integer · 1–1000 | 100 | Number of rows to return, in the reading order (most recent first by default). Bounded by your plan's history window: an explicit limit (or since_ms) reaching beyond it returns 403 history_depth; without them the page simply stops at the window. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,mvrv. Unknown field: 422 unknown_field with a suggestion. |
before_ms | integer | — | Upper time bound, EXCLUSIVE, in epoch milliseconds: rows strictly before it. Pass the oldest time you received to read the previous page without repeating a row. Not combinable with until_ms (422 invalid_time_range). |
order | string | desc | Reading order: desc (most recent first, the default) or asc (oldest first, reading forward from since_ms, which is then required). Follow next to read the following page. |
5 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
[].time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | The day the value refers to, at midnight UTC. |
[].mvrv | number | dimensionless ratio | Market value / realised value. |
[].label | string | undervalued (<= 1), fair (> 1), elevated (> 2.5), overvalued (> 3.5). | |
[].change_30d_pct | number | null | percent (58.5 = 58.5 %) | Relative change of the value over 30 days, percent. |
[].is_closed | boolean | true = the row is final; false = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with ?live=1 on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades. |
Essayer
GET https://api.bytnode.com/v1/btc/mvrv/history?limit=3
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/btc/mvrv/history?limit=3"{
"status": "ok",
"server_time": "2026-11-08T12:52:30.126Z",
"data_type": "btc_mvrv_history",
"step": "1d",
"data": [
{
"time": "2026-11-01T00:00:00.000Z",
"mvrv": 1.4493,
"label": "fair",
"change_30d_pct": -8.67099376142,
"is_closed": true
},
{
"time": "2026-10-31T00:00:00.000Z",
"mvrv": 1.4368,
"label": "fair",
"change_30d_pct": -9.77708006279,
"is_closed": true
},
{
"time": "2026-10-30T00:00:00.000Z",
"mvrv": 1.4321,
"label": "fair",
"change_30d_pct": -8.81248010188,
"is_closed": true
}
],
"next": "/v1/btc/mvrv/history?limit=3&before_ms=1793318400000&order=desc"
}GET /v1/btc/nvt
Bitcoin NVT. Network value to transactions ratio and its NVT Signal, computed from Bitcoin blocks. Daily. A secondary indicator: part of the trading volume no longer goes through the chain.
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,nvt. Unknown field: 422 unknown_field with a suggestion. |
4 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | The day the value refers to, at midnight UTC. |
nvt | number | dimensionless ratio | Market cap / on-chain transaction volume of the day (NVT ratio), change returned to the sender excluded. |
nvt_signal | number | null | dimensionless ratio | NVT Signal: market cap of the day / 90-day average of the on-chain transaction volume in USD. null with less than 90 days of data. |
label | string | null | Zone of the NVT Signal against its own last 730 days (share of those days when it was lower): undervalued (below 25 %), fair (from 25 %), overvalued (from 75 %), bubble (from 95 %). null with less than 365 days of NVT Signal. |
Essayer
GET https://api.bytnode.com/v1/btc/nvt
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/btc/nvt"{
"status": "ok",
"server_time": "2026-11-08T12:52:30.731Z",
"data_type": "btc_nvt",
"data": {
"time": "2026-11-07T00:00:00.000Z",
"nvt": 222.454467004,
"nvt_signal": 105.057179774,
"label": "overvalued"
}
}GET /v1/btc/nvt/history
NVT history. One point per day. Most recent first, or oldest first with order=asc. Follow next to read the following page (it never repeats a row).
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
since_ms | integer | — | Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range. |
until_ms | integer | — | Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next. |
limit | integer · 1–1000 | 100 | Number of rows to return, in the reading order (most recent first by default). Bounded by your plan's history window: an explicit limit (or since_ms) reaching beyond it returns 403 history_depth; without them the page simply stops at the window. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,nvt. Unknown field: 422 unknown_field with a suggestion. |
before_ms | integer | — | Upper time bound, EXCLUSIVE, in epoch milliseconds: rows strictly before it. Pass the oldest time you received to read the previous page without repeating a row. Not combinable with until_ms (422 invalid_time_range). |
order | string | desc | Reading order: desc (most recent first, the default) or asc (oldest first, reading forward from since_ms, which is then required). Follow next to read the following page. |
5 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
[].time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | The day the value refers to, at midnight UTC. |
[].nvt | number | dimensionless ratio | Market cap / on-chain transaction volume of the day (NVT ratio), change returned to the sender excluded. |
[].nvt_signal | number | null | dimensionless ratio | NVT Signal: market cap of the day / 90-day average of the on-chain transaction volume in USD. null with less than 90 days of data. |
[].label | string | null | Zone of the NVT Signal against its own last 730 days (share of those days when it was lower): undervalued (below 25 %), fair (from 25 %), overvalued (from 75 %), bubble (from 95 %). null with less than 365 days of NVT Signal. | |
[].is_closed | boolean | true = the row is final; false = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with ?live=1 on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades. |
Essayer
GET https://api.bytnode.com/v1/btc/nvt/history?limit=3
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/btc/nvt/history?limit=3"{
"status": "ok",
"server_time": "2026-11-08T12:52:31.343Z",
"data_type": "btc_nvt_history",
"step": "1d",
"data": [
{
"time": "2026-11-07T00:00:00.000Z",
"nvt": 222.454467004,
"nvt_signal": 105.057179774,
"label": "overvalued",
"is_closed": true
},
{
"time": "2026-11-06T00:00:00.000Z",
"nvt": 82.0343720529,
"nvt_signal": 105.19234961,
"label": "overvalued",
"is_closed": true
},
{
"time": "2026-11-05T00:00:00.000Z",
"nvt": 73.392318293,
"nvt_signal": 106.604613436,
"label": "overvalued",
"is_closed": true
}
],
"next": "/v1/btc/nvt/history?limit=3&before_ms=1793836800000&order=desc"
}GET /v1/btc/revenue-per-difficulty
Bitcoin revenue per difficulty. Miner revenue per unit of difficulty (revenue_per_difficulty_usd) against its 30-day average, and its reading: healthy, stress or capitulation. Daily.
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,revenue_per_difficulty_usd. Unknown field: 422 unknown_field with a suggestion. |
4 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | The day the value refers to, at midnight UTC. |
revenue_per_difficulty_usd | number | USD per unit of difficulty | Miners' daily revenue (USD) divided by the network difficulty of the day: revenue per unit of work. Read it against its 30-day average. |
revenue_per_difficulty_sma_30d_usd | number | USD per unit of difficulty | 30-day simple moving average of revenue_per_difficulty_usd. |
label | string | healthy (at or above its 30-day average), stress (below it), capitulation (below 70 % of it — historically near BTC bottoms). |
Essayer
GET https://api.bytnode.com/v1/btc/revenue-per-difficulty
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/btc/revenue-per-difficulty"{
"status": "ok",
"server_time": "2026-11-08T12:52:32.936Z",
"data_type": "btc_revenue_per_difficulty",
"data": {
"time": "2026-11-07T00:00:00.000Z",
"revenue_per_difficulty_usd": 2.15501953606e-7,
"revenue_per_difficulty_sma_30d_usd": 2.6763666354e-7,
"label": "stress"
}
}GET /v1/btc/revenue-per-difficulty/history
Revenue per difficulty history. One point per day. Most recent first, or oldest first with order=asc. Follow next to read the following page (it never repeats a row).
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
since_ms | integer | — | Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range. |
until_ms | integer | — | Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next. |
limit | integer · 1–1000 | 100 | Number of rows to return, in the reading order (most recent first by default). Bounded by your plan's history window: an explicit limit (or since_ms) reaching beyond it returns 403 history_depth; without them the page simply stops at the window. |
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,revenue_per_difficulty_usd. Unknown field: 422 unknown_field with a suggestion. |
before_ms | integer | — | Upper time bound, EXCLUSIVE, in epoch milliseconds: rows strictly before it. Pass the oldest time you received to read the previous page without repeating a row. Not combinable with until_ms (422 invalid_time_range). |
order | string | desc | Reading order: desc (most recent first, the default) or asc (oldest first, reading forward from since_ms, which is then required). Follow next to read the following page. |
5 champs de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
[].time | date-time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | The day the value refers to, at midnight UTC. |
[].revenue_per_difficulty_usd | number | USD per unit of difficulty | Miners' daily revenue (USD) divided by the network difficulty of the day: revenue per unit of work. Read it against its 30-day average. |
[].revenue_per_difficulty_sma_30d_usd | number | USD per unit of difficulty | 30-day simple moving average of revenue_per_difficulty_usd. |
[].label | string | healthy (at or above its 30-day average), stress (below it), capitulation (below 70 % of it — historically near BTC bottoms). | |
[].is_closed | boolean | true = the row is final; false = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with ?live=1 on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades. |
Essayer
GET https://api.bytnode.com/v1/btc/revenue-per-difficulty/history?limit=3
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/btc/revenue-per-difficulty/history?limit=3"{
"status": "ok",
"server_time": "2026-11-08T12:52:33.514Z",
"data_type": "btc_revenue_per_difficulty_history",
"step": "1d",
"data": [
{
"time": "2026-11-07T00:00:00.000Z",
"revenue_per_difficulty_usd": 2.15501953606e-7,
"revenue_per_difficulty_sma_30d_usd": 2.6763666354e-7,
"label": "stress",
"is_closed": true
},
{
"time": "2026-11-06T00:00:00.000Z",
"revenue_per_difficulty_usd": 2.18941264728e-7,
"revenue_per_difficulty_sma_30d_usd": 2.69434126674e-7,
"label": "stress",
"is_closed": true
},
{
"time": "2026-11-05T00:00:00.000Z",
"revenue_per_difficulty_usd": 2.13594826637e-7,
"revenue_per_difficulty_sma_30d_usd": 2.72261649443e-7,
"label": "stress",
"is_closed": true
}
],
"next": "/v1/btc/revenue-per-difficulty/history?limit=3&before_ms=1793836800000&order=desc"
}#Technical indicators
19 technical indicators computed server-side on the same candles as /v1/klines, several per request (RSI, MACD, Bollinger, ATR, Ichimoku...).
POST /v1/indicators
Compute technical indicators. POST a JSON body: symbol, timeframe, limit (values per indicator, 1 to 1000, default 1) and indicators, a list of {id, type, <parameters flat>} — e.g. {"id": "rsi_14", "type": "rsi", "period": 14}. id is your own name for the result (1 to 64 characters among letters, digits, _, -, .), unique in the call: data.indicators is keyed by it, and a type may appear any number of times. Parameters go FLAT in the indicator object; an unknown body field is a 422 unknown_parameter. Computed on the same candles as /v1/klines/history; limit + warm-up is capped at 1000 candles. Each result gives values: one row per candle, MOST RECENT FIRST like every list of the API — {time, value}, or the named outputs of a multi-output indicator ({time, macd, signal, histogram}). Errors on the indicators are 422 invalid_indicator. On a stablecoin: 200, data: null, unavailable: "not_applicable".
1 champ de la réponse
| Champ de data | Type | Unité | Description |
|---|---|---|---|
indicators | object | One result per indicator of the request, keyed by the id you gave it. |
Essayer
POST https://api.bytnode.com/v1/indicators
La clé reste dans cet onglet : elle n’est envoyée qu’à api.bytnode.com, jamais à ce site.
Exemple : requête et réponse réelle
{
"symbol": "BTCUSDT",
"timeframe": "1h",
"limit": 3,
"indicators": [
{
"id": "rsi_14",
"type": "rsi",
"period": 14
},
{
"id": "macd",
"type": "macd",
"fast": 12,
"slow": 26,
"signal": 9
},
{
"id": "bb_20",
"type": "bb",
"period": 20
}
]
}curl -X POST -H "X-API-KEY: $BYTNODE_API_KEY" -H "Content-Type: application/json" \
-d '{"symbol": "BTCUSDT", "timeframe": "1h", "limit": 3, "indicators": [{"id": "rsi_14", "type": "rsi", "period": 14}, {"id": "macd", "type": "macd", "fast": 12, "slow": 26, "signal": 9}, {"id": "bb_20", "type": "bb", "period": 20}]}' \
https://api.bytnode.com/v1/indicators{
"status": "ok",
"server_time": "2026-11-08T12:52:44.953Z",
"data_type": "indicators",
"symbol": "BTCUSDT",
"timeframe": "1h",
"data": {
"indicators": {
"rsi_14": {
"type": "rsi",
"period": 14,
"values": [
{
"time": "2026-11-08T11:00:00.000Z",
"value": 54.072013544
},
{
"time": "2026-11-08T10:00:00.000Z",
"value": 49.3688670483
},
{
"time": "2026-11-08T09:00:00.000Z",
"value": 51.577078526
}
]
},
"macd": {
"type": "macd",
"fast": 12,
"slow": 26,
"signal": 9,
"values": [
{
"time": "2026-11-08T11:00:00.000Z",
"macd": -14.2249104846,
"signal": -45.998361242,
"histogram": 31.7734507574
},
{
"time": "2026-11-08T10:00:00.000Z",
"macd": -24.0339550779,
"signal": -53.9417239313,
"histogram": 29.9077688534
},
{
"time": "2026-11-08T09:00:00.000Z",
"macd": -27.3827508304,
"signal": -61.4186661447,
"histogram": 34.0359153142
}
]
},
"bb_20": {
"type": "bb",
"period": 20,
"std": 2,
"values": [
{
"time": "2026-11-08T11:00:00.000Z",
"upper": 75998.1649923,
"middle": 75839.8095,
"lower": 75681.4540077
},
{
"time": "2026-11-08T10:00:00.000Z",
"upper": 75976.7264653,
"middle": 75828.6555,
"lower": 75680.5845347
},
{
"time": "2026-11-08T09:00:00.000Z",
"upper": 75985.9705718,
"middle": 75831.36,
"lower": 75676.7494282
}
]
}
}
}
}