交互式 API 参考
API 的每个接口,均由其 OpenAPI 契约生成:参数及其默认值和上限,响应的每个字段及其类型和单位,以及在生产环境中捕获的真实响应。本页没有任何内容是手写的,因此不会与 API 脱节。
同一份契约,供你的工具使用:openapi.json(OpenAPI 3.1,适用于 SDK 生成器和 Swagger UI)、Postman 集合,以及 llms-full.txt——将整份参考汇于一个文本文件,供 AI 智能体使用。
#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.
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
symbol 必填 | 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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
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. |
试用
GET https://api.bytnode.com/v1/capabilities?symbol=BTCUSDT
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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/health无需密钥
Service health. Liveness of the API and its database (data.database). No key needed, counted for nobody.
响应的 1 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
database | string | connected when the service reaches its database. A failing check answers 503 service_unavailable with database in error.details. |
试用
GET https://api.bytnode.com/v1/health
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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.
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=plan,families. Unknown field: 422 unknown_field with a suggestion. |
响应的 18 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
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. |
试用
GET https://api.bytnode.com/v1/limits
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
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). |
试用
GET https://api.bytnode.com/v1/status
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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.
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
[].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). |
试用
GET https://api.bytnode.com/v1/symbols
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
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. |
试用
POST https://api.bytnode.com/v1/ws/token
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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).
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
symbol 必填 | 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. |
另有 78 个多周期字段,命名为 field@tf(cvd@1h、trades_kline@5m…)。
响应的 124 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
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). |
试用
GET https://api.bytnode.com/v1/snapshot?symbol=BTCUSDT&basis=1&fear_greed=1&funding_rate=1&cvd@1h=2
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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.
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
timeframe 必填 | 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 必填 | 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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
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. |
试用
GET https://api.bytnode.com/v1/klines?timeframe=1h&symbol=BTCUSDT
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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).
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
timeframe 必填 | 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 必填 | 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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
[].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. |
试用
GET https://api.bytnode.com/v1/klines/history?timeframe=1h&limit=3&symbol=BTCUSDT
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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.
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
symbol 必填 | 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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
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. |
试用
GET https://api.bytnode.com/v1/price-change?symbol=BTCUSDT
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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.
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
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 必填 | 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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
[].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. |
试用
GET https://api.bytnode.com/v1/trades/futures?limit=3&symbol=BTCUSDT
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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).
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
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 必填 | 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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
[].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. |
试用
GET https://api.bytnode.com/v1/trades/large?min_usd=100000&limit=3&symbol=BTCUSDT
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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.
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
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 必填 | 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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
[].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. |
试用
GET https://api.bytnode.com/v1/trades/spot?limit=3&symbol=BTCUSDT
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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.
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
timeframe 必填 | 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 必填 | 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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
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. |
试用
GET https://api.bytnode.com/v1/buy-sell-ratio?timeframe=1h&symbol=BTCUSDT
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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.
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
timeframe 必填 | 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 必填 | 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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
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. |
试用
GET https://api.bytnode.com/v1/buy-sell-ratio/futures?timeframe=1h&symbol=BTCUSDT
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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.
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
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 | — | 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 必填 | 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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
[].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. |
试用
GET https://api.bytnode.com/v1/buy-sell-ratio/futures/history?limit=3&timeframe=1h&symbol=BTCUSDT
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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).
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
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 | — | 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 必填 | 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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
[].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. |
试用
GET https://api.bytnode.com/v1/buy-sell-ratio/history?limit=3&timeframe=1h&symbol=BTCUSDT
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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.
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
timeframe 必填 | 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 必填 | 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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
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. |
试用
GET https://api.bytnode.com/v1/buy-sell-ratio/spot?timeframe=1h&symbol=BTCUSDT
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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.
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
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 | — | 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 必填 | 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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
[].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. |
试用
GET https://api.bytnode.com/v1/buy-sell-ratio/spot/history?limit=3&timeframe=1h&symbol=BTCUSDT
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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.
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
timeframe 必填 | 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 必填 | 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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
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. |
试用
GET https://api.bytnode.com/v1/cvd?timeframe=1h&symbol=BTCUSDT
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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.
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
timeframe 必填 | 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 必填 | 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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
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. |
试用
GET https://api.bytnode.com/v1/cvd/futures?timeframe=1h&symbol=BTCUSDT
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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.
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
timeframe 必填 | 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 必填 | 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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
[].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. |
试用
GET https://api.bytnode.com/v1/cvd/futures/history?timeframe=1h&limit=3&symbol=BTCUSDT
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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).
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
timeframe 必填 | 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 必填 | 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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
[].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. |
试用
GET https://api.bytnode.com/v1/cvd/history?timeframe=1h&limit=3&symbol=BTCUSDT
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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.
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
timeframe 必填 | 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 必填 | 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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
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. |
试用
GET https://api.bytnode.com/v1/cvd/spot?timeframe=1h&symbol=BTCUSDT
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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.
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
timeframe 必填 | 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 必填 | 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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
[].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. |
试用
GET https://api.bytnode.com/v1/cvd/spot/history?timeframe=1h&limit=3&symbol=BTCUSDT
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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.
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
timeframe 必填 | 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 必填 | 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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
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. |
试用
GET https://api.bytnode.com/v1/orderbook?timeframe=1h&symbol=BTCUSDT
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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.
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
timeframe 必填 | 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 必填 | 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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
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. |
试用
GET https://api.bytnode.com/v1/orderbook/futures?timeframe=1h&symbol=BTCUSDT
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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.
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
timeframe 必填 | 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 必填 | 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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
[].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. |
试用
GET https://api.bytnode.com/v1/orderbook/futures/history?timeframe=1h&limit=3&symbol=BTCUSDT
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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).
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
timeframe 必填 | 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 必填 | 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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
[].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. |
试用
GET https://api.bytnode.com/v1/orderbook/history?timeframe=1h&limit=3&symbol=BTCUSDT
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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.
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
timeframe 必填 | 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 必填 | 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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
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. |
试用
GET https://api.bytnode.com/v1/orderbook/spot?timeframe=1h&symbol=BTCUSDT
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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.
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
timeframe 必填 | 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 必填 | 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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
[].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. |
试用
GET https://api.bytnode.com/v1/orderbook/spot/history?timeframe=1h&limit=3&symbol=BTCUSDT
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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.
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
timeframe 必填 | 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 必填 | 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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
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. |
试用
GET https://api.bytnode.com/v1/spread/interexchange?timeframe=1h&symbol=BTCUSDT
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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).
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
timeframe 必填 | 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 必填 | 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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
[].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. |
试用
GET https://api.bytnode.com/v1/spread/interexchange/history?timeframe=1h&limit=3&symbol=BTCUSDT
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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.
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
symbol 必填 | 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 必填 | 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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
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. |
试用
GET https://api.bytnode.com/v1/trades-kline?symbol=BTCUSDT&timeframe=1h
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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.
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
symbol 必填 | 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 必填 | 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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
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. |
试用
GET https://api.bytnode.com/v1/trades-kline/futures?symbol=BTCUSDT&timeframe=1h
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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).
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
symbol 必填 | 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 必填 | 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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
[].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. |
试用
GET https://api.bytnode.com/v1/trades-kline/futures/history?symbol=BTCUSDT&timeframe=1h&limit=3
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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).
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
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 必填 | 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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
[].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). |
试用
GET https://api.bytnode.com/v1/trades-kline/futures/seconds?limit=3&symbol=BTCUSDT
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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).
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
symbol 必填 | 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 必填 | 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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
[].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. |
试用
GET https://api.bytnode.com/v1/trades-kline/history?symbol=BTCUSDT&timeframe=1h&limit=3
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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.
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
symbol 必填 | 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 必填 | 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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
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. |
试用
GET https://api.bytnode.com/v1/trades-kline/spot?symbol=BTCUSDT&timeframe=1h
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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).
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
symbol 必填 | 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 必填 | 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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
[].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. |
试用
GET https://api.bytnode.com/v1/trades-kline/spot/history?symbol=BTCUSDT&timeframe=1h&limit=3
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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.
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
timeframe 必填 | 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 必填 | 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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
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. |
试用
GET https://api.bytnode.com/v1/trades/avg-size?timeframe=1h&symbol=BTCUSDT
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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.
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
timeframe 必填 | 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 必填 | 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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
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. |
试用
GET https://api.bytnode.com/v1/trades/avg-size/futures?timeframe=1h&symbol=BTCUSDT
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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.
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
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 | — | 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 必填 | 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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
[].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. |
试用
GET https://api.bytnode.com/v1/trades/avg-size/futures/history?limit=3&timeframe=1h&symbol=BTCUSDT
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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).
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
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 | — | 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 必填 | 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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
[].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. |
试用
GET https://api.bytnode.com/v1/trades/avg-size/history?limit=3&timeframe=1h&symbol=BTCUSDT
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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.
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
timeframe 必填 | 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 必填 | 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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
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. |
试用
GET https://api.bytnode.com/v1/trades/avg-size/spot?timeframe=1h&symbol=BTCUSDT
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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.
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
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 | — | 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 必填 | 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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
[].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. |
试用
GET https://api.bytnode.com/v1/trades/avg-size/spot/history?limit=3&timeframe=1h&symbol=BTCUSDT
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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.
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
symbol 必填 | 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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
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. |
试用
GET https://api.bytnode.com/v1/basis?symbol=BTCUSDT
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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).
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
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 | — | 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 必填 | 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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
[].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. |
试用
GET https://api.bytnode.com/v1/basis/history?limit=3&timeframe=1h&symbol=BTCUSDT
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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.
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
symbol 必填 | 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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
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. |
试用
GET https://api.bytnode.com/v1/funding/cumulative?symbol=BTCUSDT
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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).
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
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 必填 | 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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
[].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. |
试用
GET https://api.bytnode.com/v1/funding/cumulative/history?limit=3&symbol=BTCUSDT
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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.
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
symbol 必填 | 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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
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). |
试用
GET https://api.bytnode.com/v1/funding/next?symbol=BTCUSDT
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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.
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
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 必填 | 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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
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. |
试用
GET https://api.bytnode.com/v1/funding/rate?symbol=BTCUSDT
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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).
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
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 必填 | 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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
[].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. |
试用
GET https://api.bytnode.com/v1/funding/rate/history?limit=3&symbol=BTCUSDT
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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.
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
symbol 必填 | 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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
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. |
试用
GET https://api.bytnode.com/v1/oi?symbol=BTCUSDT
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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.
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
symbol 必填 | 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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
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). |
试用
GET https://api.bytnode.com/v1/oi/change?symbol=BTCUSDT
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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).
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
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 | — | 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 必填 | 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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
[].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. |
试用
GET https://api.bytnode.com/v1/oi/change/history?limit=3&timeframe=1h&symbol=BTCUSDT
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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).
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
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 | — | 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 必填 | 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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
[].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. |
试用
GET https://api.bytnode.com/v1/oi/history?limit=3&timeframe=1h&symbol=BTCUSDT
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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.
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
timeframe 必填 | 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 必填 | 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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
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. |
试用
GET https://api.bytnode.com/v1/liquidations/big-small-ratio?timeframe=1h&symbol=BTCUSDT
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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).
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
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 | — | 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 必填 | 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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
[].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. |
试用
GET https://api.bytnode.com/v1/liquidations/big-small-ratio/history?limit=3&timeframe=1h&symbol=BTCUSDT
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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.
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
symbol 必填 | 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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
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). |
试用
GET https://api.bytnode.com/v1/liquidations/cumulative?symbol=BTCUSDT
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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).
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
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 | — | 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 必填 | 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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
[].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. |
试用
GET https://api.bytnode.com/v1/liquidations/cumulative/history?limit=3&timeframe=1h&symbol=BTCUSDT
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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.
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
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 必填 | 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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
[].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). |
试用
GET https://api.bytnode.com/v1/liquidations/events?limit=3&symbol=BTCUSDT
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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.
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,value. Unknown field: 422 unknown_field with a suggestion. |
响应的 7 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
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). |
试用
GET https://api.bytnode.com/v1/altcoin-season
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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).
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
[].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. |
试用
GET https://api.bytnode.com/v1/altcoin-season/history?limit=3
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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).
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,value. Unknown field: 422 unknown_field with a suggestion. |
响应的 3 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
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). |
试用
GET https://api.bytnode.com/v1/fear-greed
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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.
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,value. Unknown field: 422 unknown_field with a suggestion. |
响应的 3 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
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). |
试用
GET https://api.bytnode.com/v1/fear-greed/cmc
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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).
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
[].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. |
试用
GET https://api.bytnode.com/v1/fear-greed/cmc/history?limit=3
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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).
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
[].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. |
试用
GET https://api.bytnode.com/v1/fear-greed/history?limit=3
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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.
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
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. |
试用
GET https://api.bytnode.com/v1/global
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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).
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
[].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. |
试用
GET https://api.bytnode.com/v1/global/history?limit=3
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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.
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,value. Unknown field: 422 unknown_field with a suggestion. |
响应的 7 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
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. |
试用
GET https://api.bytnode.com/v1/indices/cmc100
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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).
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
[].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. |
试用
GET https://api.bytnode.com/v1/indices/cmc100/history?limit=3
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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.
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,value. Unknown field: 422 unknown_field with a suggestion. |
响应的 7 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
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. |
试用
GET https://api.bytnode.com/v1/indices/cmc20
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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).
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
[].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. |
试用
GET https://api.bytnode.com/v1/indices/cmc20/history?limit=3
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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).
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
symbol 必填 | 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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
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. |
试用
GET https://api.bytnode.com/v1/tokenomics?symbol=BTCUSDT
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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).
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
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 必填 | 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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
[].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. |
试用
GET https://api.bytnode.com/v1/tokenomics/history?limit=3&symbol=BTCUSDT
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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.
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
series 必填 | 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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
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. |
试用
GET https://api.bytnode.com/v1/macro?series=DGS10
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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.
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
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. |
试用
GET https://api.bytnode.com/v1/macro/correlations
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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).
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
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 必填 | 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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
[].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. |
试用
GET https://api.bytnode.com/v1/macro/history?limit=3&series=DGS10
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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).
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
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 必填 | string | — | The series returned by GET /v1/macro/intraday/series (e.g. PAXGUSDT), in any case. The instrument_code column is NOT accepted. |
timeframe 必填 | 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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
[].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. |
试用
GET https://api.bytnode.com/v1/macro/intraday/history?limit=3&series=PAXGUSDT&timeframe=1h
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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.
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=series,source. Unknown field: 422 unknown_field with a suggestion. |
响应的 16 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
[].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). |
试用
GET https://api.bytnode.com/v1/macro/intraday/series
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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.
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
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. |
试用
GET https://api.bytnode.com/v1/macro/momentum
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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).
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
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). |
试用
GET https://api.bytnode.com/v1/macro/net-liquidity
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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).
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
[].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. |
试用
GET https://api.bytnode.com/v1/macro/net-liquidity/history?limit=3
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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.
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
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. |
试用
GET https://api.bytnode.com/v1/macro/risk
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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.
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
[].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. |
试用
GET https://api.bytnode.com/v1/macro/series
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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.
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
asset 必填 | 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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
[].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. |
试用
GET https://api.bytnode.com/v1/etf/fundamentals?asset=BTC
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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).
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
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 必填 | 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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
[].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. |
试用
GET https://api.bytnode.com/v1/etf/fundamentals/history?limit=3&asset=BTC
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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.
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
asset 必填 | 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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
[].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). |
试用
GET https://api.bytnode.com/v1/options/expiry?asset=BTC
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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.
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
asset 必填 | 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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
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. |
试用
GET https://api.bytnode.com/v1/options/greeks?asset=BTC
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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.
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
asset 必填 | 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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
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. |
试用
GET https://api.bytnode.com/v1/options/iv?asset=BTC
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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.
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
timeframe 必填 | 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 必填 | 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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
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. |
试用
GET https://api.bytnode.com/v1/options/iv/klines?timeframe=1h&asset=BTC
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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).
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
timeframe 必填 | 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 必填 | 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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
[].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. |
试用
GET https://api.bytnode.com/v1/options/iv/klines/history?timeframe=1h&limit=3&asset=BTC
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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.
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
asset 必填 | 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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
[].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. |
试用
GET https://api.bytnode.com/v1/options/max-pain?asset=BTC
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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).
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
expiry 必填 | 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 必填 | 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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
[].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. |
试用
GET https://api.bytnode.com/v1/options/max-pain/history?expiry=2026-11-09&limit=3&asset=BTC
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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.
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
asset 必填 | 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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
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. |
试用
GET https://api.bytnode.com/v1/options/oi?asset=BTC
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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.
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
timeframe 必填 | 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 必填 | 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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
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. |
试用
GET https://api.bytnode.com/v1/options/oi/change?timeframe=1h&asset=BTC
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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).
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
timeframe 必填 | 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 必填 | 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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
[].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. |
试用
GET https://api.bytnode.com/v1/options/oi/change/history?timeframe=1h&limit=3&asset=BTC
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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.
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
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 必填 | 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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
[].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. |
试用
GET https://api.bytnode.com/v1/options/oi/distribution?asset=BTC
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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).
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
timeframe 必填 | 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 必填 | 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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
[].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. |
试用
GET https://api.bytnode.com/v1/options/oi/history?timeframe=1h&limit=3&asset=BTC
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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).
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
asset 必填 | 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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
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). |
试用
GET https://api.bytnode.com/v1/options/put-call-ratio?asset=BTC
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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).
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
timeframe 必填 | 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 必填 | 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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
[].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. |
试用
GET https://api.bytnode.com/v1/options/put-call-ratio/history?timeframe=1h&limit=3&asset=BTC
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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.
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
asset 必填 | 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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
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. |
试用
GET https://api.bytnode.com/v1/options/summary?asset=BTC
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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.
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
asset 必填 | 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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
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. |
试用
GET https://api.bytnode.com/v1/options/volume?asset=BTC
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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).
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
timeframe 必填 | 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 必填 | 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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
[].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. |
试用
GET https://api.bytnode.com/v1/options/volume/history?timeframe=1h&limit=3&asset=BTC
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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).
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
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). |
试用
GET https://api.bytnode.com/v1/btc/fees
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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).
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
[].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. |
试用
GET https://api.bytnode.com/v1/btc/fees/history?limit=3
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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.
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
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. |
试用
GET https://api.bytnode.com/v1/btc/mempool
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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).
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
[].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. |
试用
GET https://api.bytnode.com/v1/btc/mempool/history?limit=3
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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).
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time. Unknown field: 422 unknown_field with a suggestion. |
响应的 19 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
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. |
试用
GET https://api.bytnode.com/v1/btc/mining
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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).
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
[].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. |
试用
GET https://api.bytnode.com/v1/btc/mining/history?dataset=concentration&limit=3
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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.
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,difficulty. Unknown field: 422 unknown_field with a suggestion. |
响应的 14 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
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. |
试用
GET https://api.bytnode.com/v1/btc/network
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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).
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
[].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. |
试用
GET https://api.bytnode.com/v1/btc/network/history?limit=3
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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.
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
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. |
试用
GET https://api.bytnode.com/v1/eth/defi
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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).
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
[].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. |
试用
GET https://api.bytnode.com/v1/eth/defi/history?limit=3
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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.
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
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. |
试用
GET https://api.bytnode.com/v1/eth/deflation
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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).
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
[].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. |
试用
GET https://api.bytnode.com/v1/eth/deflation/history?limit=3
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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.
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
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). |
试用
GET https://api.bytnode.com/v1/eth/gas
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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.
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
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. |
试用
GET https://api.bytnode.com/v1/eth/gas-momentum
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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).
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
[].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. |
试用
GET https://api.bytnode.com/v1/eth/gas-momentum/history?limit=3
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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).
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
[].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. |
试用
GET https://api.bytnode.com/v1/eth/gas/history?limit=3
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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.
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
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. |
试用
GET https://api.bytnode.com/v1/eth/price-btc
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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).
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
[].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. |
试用
GET https://api.bytnode.com/v1/eth/price-btc/history?limit=3
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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.
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
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). |
试用
GET https://api.bytnode.com/v1/eth/squeeze
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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).
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
[].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. |
试用
GET https://api.bytnode.com/v1/eth/squeeze/history?limit=3
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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).
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
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. |
试用
GET https://api.bytnode.com/v1/eth/staking
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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).
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
[].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. |
试用
GET https://api.bytnode.com/v1/eth/staking/history?limit=3
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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.
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
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. |
试用
GET https://api.bytnode.com/v1/eth/supply
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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).
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
[].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. |
试用
GET https://api.bytnode.com/v1/eth/supply/history?limit=3
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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.
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
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. |
试用
GET https://api.bytnode.com/v1/btc/active-addresses
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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).
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
[].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. |
试用
GET https://api.bytnode.com/v1/btc/active-addresses/history?limit=3
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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.
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,mvrv. Unknown field: 422 unknown_field with a suggestion. |
响应的 4 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
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. |
试用
GET https://api.bytnode.com/v1/btc/mvrv
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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).
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
[].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. |
试用
GET https://api.bytnode.com/v1/btc/mvrv/history?limit=3
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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.
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
fields | string | — | Comma-separated projection of data (dot notation for nested keys): fields=time,nvt. Unknown field: 422 unknown_field with a suggestion. |
响应的 4 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
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. |
试用
GET https://api.bytnode.com/v1/btc/nvt
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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).
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
[].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. |
试用
GET https://api.bytnode.com/v1/btc/nvt/history?limit=3
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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.
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
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). |
试用
GET https://api.bytnode.com/v1/btc/revenue-per-difficulty
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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).
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
[].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. |
试用
GET https://api.bytnode.com/v1/btc/revenue-per-difficulty/history?limit=3
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
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 个字段
| data 字段 | 类型 | 单位 | 说明 |
|---|---|---|---|
indicators | object | One result per indicator of the request, keyed by the id you gave it. |
试用
POST https://api.bytnode.com/v1/indicators
密钥只保存在当前浏览器标签页中:只会发送到 api.bytnode.com,绝不会发送到本网站。
示例:请求与真实响应
{
"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
}
]
}
}
}
}