Reference

Interactive API reference

Every route of the API, generated from its OpenAPI contract: parameters with their default and ceiling, every field of the response with its type and its unit, and a real response captured in production. Nothing on this page is written by hand, so it cannot drift from the API.

The same contract, for your tools: openapi.json (OpenAPI 3.1, for SDK generators and Swagger UI), a Postman collection, and llms-full.txt, the whole reference in one text file for AI agents.

#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.

ParameterTypeDefaultDescription
symbol requiredstring—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.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=asset_class. Unknown field: 422 unknown_field with a suggestion.
25 fields of the response
Field of dataTypeUnitDescription
asset_classstringcrypto or stablecoin (spot only, no futures metrics).
feeds_active_last_24hobjectPer 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_1mbooleantrue 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_spotbooleantrue 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_futuresbooleantrue 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.oibooleanbase 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_ratebooleantrue 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_eventsbooleantrue 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_secondsbooleantrue 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_multibooleantrue 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_1mbooleantrue 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_multibooleantrue 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_1mbooleantrue when the orderbook_1m feed delivered data in the last 24 hours; null when its probe did not conclude in time.
computed_metrics_availablestring[]Derived metrics available for the symbol.
computed_metrics_blockedobjectDerived metrics unavailable, with the missing feeds.
feeds_not_applicablestring[]Feeds that do not exist for this symbol (the futures feeds of a spot-only stablecoin), under their /v1/status names.
stablecoin_notestringSpot-only stablecoin: why its futures feeds and derived metrics do not apply. Absent for any other symbol.
computed_metrics_not_applicableobjectDerived metrics that do not apply (stablecoins have no futures).
computed_metrics_not_applicable.basisstringWhy basis does not apply to this symbol.
computed_metrics_not_applicable.oi_changestringbase asset quantity (BTC for BTCUSDT)Why oi_change does not apply to this symbol.
computed_metrics_not_applicable.liquidations_cumulativestringWhy liquidations_cumulative does not apply to this symbol.
computed_metrics_not_applicable.liquidations_big_small_ratiostringWhy liquidations_big_small_ratio does not apply to this symbol.
computed_metrics_not_applicable.funding_cumulativestringWhy funding_cumulative does not apply to this symbol.
computed_metrics_not_applicable.indicatorsstringWhy indicators does not apply to this symbol.
computed_metrics_not_applicable.trades_kline_futuresstringWhy trades_kline_futures does not apply to this symbol.
Try it

GET https://api.bytnode.com/v1/capabilities?symbol=BTCUSDT

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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/healthno key

Service health. Liveness of the API and its database (data.database). No key needed, counted for nobody.

1 field of the response
Field of dataTypeUnitDescription
databasestringconnected when the service reaches its database. A failing check answers 503 service_unavailable with database in error.details.
Try it

GET https://api.bytnode.com/v1/health

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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.

ParameterTypeDefaultDescription
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=plan,families. Unknown field: 422 unknown_field with a suggestion.
18 fields of the response
Field of dataTypeUnitDescription
planstringYour plan: free, traders, financial, startup or enterprise (legacy for an internal unmetered key: every limit below is then unset).
familiesstring[] | nullData 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.
historyobject[]History window per timeframe, one object per timeframe the API serves.
history[].timeframestringThe timeframe the window applies to.
history[].window_sinteger | nullsecondsHow far back this timeframe may be read, in seconds, measured from now; null = unlimited. Beyond it: 403 history_depth.
trades_window_sinteger | nullsecondsHow 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_countinteger | nullcountHow 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).
rateobject | nullThe per-minute rate, as a token bucket; null = unlimited or unmetered key. The same values as the RateLimit headers (rate policy).
rate.requests_per_minuteinteger | nullcountRequests per minute of your plan (the bucket refills at this pace).
rate.burst_countintegercountCapacity of the bucket: requests you can send at once.
rate.refill_sintegersecondsSeconds to refill the bucket from empty.
rate.remaining_countinteger | nullcountRequests left right now (after this one).
rate.reset_sinteger | nullsecondsSeconds until fully restored.
quotaobject | nullThe 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_countintegercountRequests included per calendar month.
quota.month_length_sintegersecondsLength of the current calendar month, in seconds.
quota.remaining_countinteger | nullcountRequests left right now (after this one).
quota.reset_sinteger | nullsecondsSeconds until fully restored.
Try it

GET https://api.bytnode.com/v1/limits

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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 fields of the response
Field of dataTypeUnitDescription
computed_atdate-timeISO 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.
statestringok, or degraded when at least one feed is stale or failed its check. The envelope's status stays ok (the request succeeded).
feed_countintegercountPublic feeds checked.
stale_feed_countintegercountFeeds older than their threshold.
error_feed_countintegercountFeeds that could not be checked.
max_age_snumbersecondsAge of the oldest feed.
feedsobject[]One row per public feed.
feeds[].feedstringPublic feed name. The closed list of this contract version; routes gives the routes each one supplies.
feeds[].familystringData 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[].routesstring[]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_snumber | nullsecondsAge 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_sintegersecondsMaximum legitimate age of the feed.
feeds[].threshold_sintegersecondsAge above which the feed is stale (1.5 × expected_interval_s).
feeds[].is_staleboolean | nullWhether 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_countinteger | nullcountVenues lagging on this feed; null when the feed is not split by venue (every non-market feed).
Try it

GET https://api.bytnode.com/v1/status

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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.

ParameterTypeDefaultDescription
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=symbol,base_asset. Unknown field: 422 unknown_field with a suggestion.
5 fields of the response
Field of dataTypeUnitDescription
[].symbolstringTrading pair, e.g. BTCUSDT.
[].base_assetstringBase asset of the pair.
[].namestringHuman-readable name.
[].quote_assetstringQuote currency of the pair (USDT for BTCUSDT, USDC for USDTUSDC): the currency of its prices.
[].marketsstring[]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).
Try it

GET https://api.bytnode.com/v1/symbols

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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 fields of the response
Field of dataTypeUnitDescription
tokenstring | nullThe 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_atdate-time | nullISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z)Instant after which the token no longer opens a connection.
expires_in_sinteger | nullsecondsLifetime of the token from its issue, in seconds (60).
urlstring | nullThe stream URL with the token already in it, ready to open.
Try it

POST https://api.bytnode.com/v1/ws/token

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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).

ParameterTypeDefaultDescription
symbol requiredstring—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_seasoninteger · 1–1—Altcoin Season Index. Same content as /v1/altcoin-season. Value: true (or 1): the latest value only.
basisinteger · 1–1—Futures-spot basis (latest value). Same content as /v1/basis. Value: true (or 1): the latest value only.
btc_active_addressesinteger · 1–1—Bitcoin active addresses. Same content as /v1/btc/active-addresses. Value: true (or 1): the latest value only.
btc_feesinteger · 1–1—Recommended Bitcoin fees. Same content as /v1/btc/fees. Value: true (or 1): the latest value only.
btc_mempoolinteger · 1–1—Bitcoin mempool. Same content as /v1/btc/mempool. Value: true (or 1): the latest value only.
btc_mininginteger · 1–1—Mining pool concentration. Same content as /v1/btc/mining. Value: true (or 1): the latest value only.
btc_mvrvinteger · 1–1—Bitcoin MVRV. Same content as /v1/btc/mvrv. Value: true (or 1): the latest value only.
btc_networkinteger · 1–1—Bitcoin network state. Same content as /v1/btc/network. Value: true (or 1): the latest value only.
btc_nvtinteger · 1–1—Bitcoin NVT. Same content as /v1/btc/nvt. Value: true (or 1): the latest value only.
btc_revenue_per_difficultyinteger · 1–1—Bitcoin revenue per difficulty. Same content as /v1/btc/revenue-per-difficulty. Value: true (or 1): the latest value only.
cmc100integer · 1–1—CoinMarketCap 100 Index and its constituents. Same content as /v1/indices/cmc100. Value: true (or 1): the latest value only.
cmc20integer · 1–1—CoinMarketCap 20 Index and its constituents. Same content as /v1/indices/cmc20. Value: true (or 1): the latest value only.
eth_defiinteger · 1–1—Ethereum DeFi. Same content as /v1/eth/defi. Value: true (or 1): the latest value only.
eth_deflationinteger · 1–1—ETH deflation. Same content as /v1/eth/deflation. Value: true (or 1): the latest value only.
eth_gasinteger · 1–1—Ethereum gas. Same content as /v1/eth/gas. Value: true (or 1): the latest value only.
eth_gas_momentuminteger · 1–1—Gas momentum. Same content as /v1/eth/gas-momentum. Value: true (or 1): the latest value only.
eth_price_btcinteger · 1–1—ETH price in BTC. Same content as /v1/eth/price-btc. Value: true (or 1): the latest value only.
eth_squeezeinteger · 1–1—ETH supply squeeze index. Same content as /v1/eth/squeeze. Value: true (or 1): the latest value only.
eth_stakinginteger · 1–1—ETH staking. Same content as /v1/eth/staking. Value: true (or 1): the latest value only.
eth_supplyinteger · 1–1—ETH supply and burn. Same content as /v1/eth/supply. Value: true (or 1): the latest value only.
fear_greedinteger · 1–1—Crypto Fear & Greed Index. Same content as /v1/fear-greed. Value: true (or 1): the latest value only.
fear_greed_cmcinteger · 1–1—CMC Crypto Fear & Greed Index. Same content as /v1/fear-greed/cmc. Value: true (or 1): the latest value only.
funding_cumulativeinteger · 1–1—Funding summed over 24 h. Same content as /v1/funding/cumulative. Value: true (or 1): the latest value only.
funding_nextinteger · 1–1—Next funding forecast. Same content as /v1/funding/next. Value: true (or 1): the latest value only.
funding_rateinteger · 1–1—Latest settled funding window. Same content as /v1/funding/rate. Value: true (or 1): the latest value only.
globalinteger · 1–1—Total crypto market cap and dominance. Same content as /v1/global. Value: true (or 1): the latest value only.
liquidations_cumulativeinteger · 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_eventsinteger · 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_correlationsinteger · 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_momentuminteger · 1–1—Macro momentum score. Same content as /v1/macro/momentum. Value: true (or 1): the latest value only.
macro_net_liquidityinteger · 1–1—US net liquidity. Same content as /v1/macro/net-liquidity. Value: true (or 1): the latest value only.
macro_riskinteger · 1–1—Risk-on / risk-off score. Same content as /v1/macro/risk. Value: true (or 1): the latest value only.
macro_seriesinteger · 1–1—Latest value of every FRED series. Same content as /v1/macro/series. Value: true (or 1): the latest value only.
oi_changeinteger · 1–1—Open interest change (latest value). Same content as /v1/oi/change. Value: true (or 1): the latest value only.
options_summaryinteger · 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_changeinteger · 1–1—Price change over 1m to 1w, in percent. Same content as /v1/price-change. Value: true (or 1): the latest value only.
tokenomicsinteger · 1–1—Supply, market cap, FDV. Same content as /v1/tokenomics. Value: true (or 1): the latest value only.
trades_futuresinteger · 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_secondsinteger · 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_spotinteger · 1–10000—Individual spot trades (N trades), bounded by your plan's tick window. Same content as /v1/trades/spot. Value: depth N (at most 10000), or true for 1.

Plus 78 multi-timeframe fields, named field@tf (cvd@1h, trades_kline@5m…).

124 fields of the response
Field of dataTypeUnitDescription
altcoin_seasonobject | any | nullAltcoin Season Index. Same content as /v1/altcoin-season. Value: true (or 1): the latest value only.
basisobject | any | nullFutures-spot basis (latest value). Same content as /v1/basis. Value: true (or 1): the latest value only.
btc_active_addressesobject | any | nullBitcoin active addresses. Same content as /v1/btc/active-addresses. Value: true (or 1): the latest value only.
btc_feesobject | any | nullRecommended Bitcoin fees. Same content as /v1/btc/fees. Value: true (or 1): the latest value only.
btc_mempoolobject | any | nullBitcoin mempool. Same content as /v1/btc/mempool. Value: true (or 1): the latest value only.
btc_miningobject | any | nullMining pool concentration. Same content as /v1/btc/mining. Value: true (or 1): the latest value only.
btc_mvrvobject | any | nullBitcoin MVRV. Same content as /v1/btc/mvrv. Value: true (or 1): the latest value only.
btc_networkobject | any | nullBitcoin network state. Same content as /v1/btc/network. Value: true (or 1): the latest value only.
btc_nvtobject | any | nullBitcoin NVT. Same content as /v1/btc/nvt. Value: true (or 1): the latest value only.
btc_revenue_per_difficultyobject | any | nullBitcoin revenue per difficulty. Same content as /v1/btc/revenue-per-difficulty. Value: true (or 1): the latest value only.
cmc100object | any | nullCoinMarketCap 100 Index and its constituents. Same content as /v1/indices/cmc100. Value: true (or 1): the latest value only.
cmc20object | any | nullCoinMarketCap 20 Index and its constituents. Same content as /v1/indices/cmc20. Value: true (or 1): the latest value only.
eth_defiobject | any | nullEthereum DeFi. Same content as /v1/eth/defi. Value: true (or 1): the latest value only.
eth_deflationobject | any | nullETH deflation. Same content as /v1/eth/deflation. Value: true (or 1): the latest value only.
eth_gasobject | any | nullEthereum gas. Same content as /v1/eth/gas. Value: true (or 1): the latest value only.
eth_gas_momentumobject | any | nullGas momentum. Same content as /v1/eth/gas-momentum. Value: true (or 1): the latest value only.
eth_price_btcobject | any | nullETH price in BTC. Same content as /v1/eth/price-btc. Value: true (or 1): the latest value only.
eth_squeezeobject | any | nullETH supply squeeze index. Same content as /v1/eth/squeeze. Value: true (or 1): the latest value only.
eth_stakingobject | any | nullETH staking. Same content as /v1/eth/staking. Value: true (or 1): the latest value only.
eth_supplyobject | any | nullETH supply and burn. Same content as /v1/eth/supply. Value: true (or 1): the latest value only.
fear_greedobject | any | nullCrypto Fear & Greed Index. Same content as /v1/fear-greed. Value: true (or 1): the latest value only.
fear_greed_cmcobject | any | nullCMC Crypto Fear & Greed Index. Same content as /v1/fear-greed/cmc. Value: true (or 1): the latest value only.
funding_cumulativeobject | any | nullFunding summed over 24 h. Same content as /v1/funding/cumulative. Value: true (or 1): the latest value only.
funding_nextobject | any | nullNext funding forecast. Same content as /v1/funding/next. Value: true (or 1): the latest value only.
funding_rateobject | any | nullLatest settled funding window. Same content as /v1/funding/rate. Value: true (or 1): the latest value only.
globalobject | any | nullTotal crypto market cap and dominance. Same content as /v1/global. Value: true (or 1): the latest value only.
liquidations_cumulativeobject | any | nullLiquidations 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_eventsobject[] | object | any | nullIndividual 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_correlationsobject | any | nullBTC correlation with DXY, S&P 500, gold, VIX. Same content as /v1/macro/correlations. Value: true (or 1): the latest value only.
macro_momentumobject | any | nullMacro momentum score. Same content as /v1/macro/momentum. Value: true (or 1): the latest value only.
macro_net_liquidityobject | any | nullUS net liquidity. Same content as /v1/macro/net-liquidity. Value: true (or 1): the latest value only.
macro_riskobject | any | nullRisk-on / risk-off score. Same content as /v1/macro/risk. Value: true (or 1): the latest value only.
macro_seriesobject | any | nullLatest value of every FRED series. Same content as /v1/macro/series. Value: true (or 1): the latest value only.
oi_changeobject | any | nullOpen interest change (latest value). Same content as /v1/oi/change. Value: true (or 1): the latest value only.
options_summaryobject | any | nullOptions market summary for the symbol's asset. Same content as /v1/options/summary. Value: true (or 1): the latest value only.
price_changeobject | any | nullPrice change over 1m to 1w, in percent. Same content as /v1/price-change. Value: true (or 1): the latest value only.
tokenomicsobject | any | nullSupply, market cap, FDV. Same content as /v1/tokenomics. Value: true (or 1): the latest value only.
trades_futuresobject[] | object | any | nullIndividual 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_secondsobject[] | object | any | nullFutures 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_spotobject[] | object | any | nullIndividual 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@1mobject[] | objectBuy/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@5mobject[] | objectBuy/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@15mobject[] | objectBuy/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@30mobject[] | objectBuy/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@1hobject[] | objectBuy/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@4hobject[] | objectBuy/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@1dobject[] | objectBuy/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@1mobject[] | objectCVD per bucket (cvd@<tf>=N: the N latest closed buckets). Timeframe 1m. Same content as /v1/cvd/history?timeframe=1m.
cvd@5mobject[] | objectCVD per bucket (cvd@<tf>=N: the N latest closed buckets). Timeframe 5m. Same content as /v1/cvd/history?timeframe=5m.
cvd@15mobject[] | objectCVD per bucket (cvd@<tf>=N: the N latest closed buckets). Timeframe 15m. Same content as /v1/cvd/history?timeframe=15m.
cvd@30mobject[] | objectCVD per bucket (cvd@<tf>=N: the N latest closed buckets). Timeframe 30m. Same content as /v1/cvd/history?timeframe=30m.
cvd@1hobject[] | objectCVD per bucket (cvd@<tf>=N: the N latest closed buckets). Timeframe 1h. Same content as /v1/cvd/history?timeframe=1h.
cvd@4hobject[] | objectCVD per bucket (cvd@<tf>=N: the N latest closed buckets). Timeframe 4h. Same content as /v1/cvd/history?timeframe=4h.
cvd@1dobject[] | objectCVD per bucket (cvd@<tf>=N: the N latest closed buckets). Timeframe 1d. Same content as /v1/cvd/history?timeframe=1d.
klines@1mobject[] | objectOHLCV candles (klines@<tf>=N: the N latest closed candles). Timeframe 1m. Same content as /v1/klines/history?timeframe=1m.
klines@5mobject[] | objectOHLCV candles (klines@<tf>=N: the N latest closed candles). Timeframe 5m. Same content as /v1/klines/history?timeframe=5m.
klines@15mobject[] | objectOHLCV candles (klines@<tf>=N: the N latest closed candles). Timeframe 15m. Same content as /v1/klines/history?timeframe=15m.
klines@30mobject[] | objectOHLCV candles (klines@<tf>=N: the N latest closed candles). Timeframe 30m. Same content as /v1/klines/history?timeframe=30m.
klines@1hobject[] | objectOHLCV candles (klines@<tf>=N: the N latest closed candles). Timeframe 1h. Same content as /v1/klines/history?timeframe=1h.
klines@4hobject[] | objectOHLCV candles (klines@<tf>=N: the N latest closed candles). Timeframe 4h. Same content as /v1/klines/history?timeframe=4h.
klines@1dobject[] | objectOHLCV candles (klines@<tf>=N: the N latest closed candles). Timeframe 1d. Same content as /v1/klines/history?timeframe=1d.
klines@1wobject[] | objectOHLCV candles (klines@<tf>=N: the N latest closed candles). Timeframe 1w. Same content as /v1/klines/history?timeframe=1w.
liquidations_big_small_ratio@1mobject[] | objectBig 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@5mobject[] | objectBig 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@15mobject[] | objectBig 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@30mobject[] | objectBig 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@1hobject[] | objectBig 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@4hobject[] | objectBig 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@1dobject[] | objectBig 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@1mobject[] | objectTotal open interest per closed bucket (oi@<tf>=N: the N latest buckets). Timeframe 1m. Same content as /v1/oi/history?timeframe=1m.
oi@5mobject[] | objectTotal open interest per closed bucket (oi@<tf>=N: the N latest buckets). Timeframe 5m. Same content as /v1/oi/history?timeframe=5m.
oi@15mobject[] | objectTotal open interest per closed bucket (oi@<tf>=N: the N latest buckets). Timeframe 15m. Same content as /v1/oi/history?timeframe=15m.
oi@30mobject[] | objectTotal open interest per closed bucket (oi@<tf>=N: the N latest buckets). Timeframe 30m. Same content as /v1/oi/history?timeframe=30m.
oi@1hobject[] | objectTotal open interest per closed bucket (oi@<tf>=N: the N latest buckets). Timeframe 1h. Same content as /v1/oi/history?timeframe=1h.
oi@4hobject[] | objectTotal open interest per closed bucket (oi@<tf>=N: the N latest buckets). Timeframe 4h. Same content as /v1/oi/history?timeframe=4h.
oi@1dobject[] | objectTotal open interest per closed bucket (oi@<tf>=N: the N latest buckets). Timeframe 1d. Same content as /v1/oi/history?timeframe=1d.
orderbook@1mobject[] | objectOrder 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@5mobject[] | objectOrder 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@15mobject[] | objectOrder 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@30mobject[] | objectOrder 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@1hobject[] | objectOrder 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@4hobject[] | objectOrder 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@1dobject[] | objectOrder 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@1mobject[] | objectInter-venue spread per bucket. Timeframe 1m. Same content as /v1/spread/interexchange?timeframe=1m.
spread_interexchange@5mobject[] | objectInter-venue spread per bucket. Timeframe 5m. Same content as /v1/spread/interexchange?timeframe=5m.
spread_interexchange@15mobject[] | objectInter-venue spread per bucket. Timeframe 15m. Same content as /v1/spread/interexchange?timeframe=15m.
spread_interexchange@30mobject[] | objectInter-venue spread per bucket. Timeframe 30m. Same content as /v1/spread/interexchange?timeframe=30m.
spread_interexchange@1hobject[] | objectInter-venue spread per bucket. Timeframe 1h. Same content as /v1/spread/interexchange?timeframe=1h.
spread_interexchange@4hobject[] | objectInter-venue spread per bucket. Timeframe 4h. Same content as /v1/spread/interexchange?timeframe=4h.
spread_interexchange@1dobject[] | objectInter-venue spread per bucket. Timeframe 1d. Same content as /v1/spread/interexchange?timeframe=1d.
trades_avg_size@1mobject[] | objectAverage 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@5mobject[] | objectAverage 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@15mobject[] | objectAverage 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@30mobject[] | objectAverage 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@1hobject[] | objectAverage 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@4hobject[] | objectAverage 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@1dobject[] | objectAverage 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@1mobject[] | objectTrade candles, spot + futures (N latest closed buckets). Timeframe 1m. Same content as /v1/trades-kline?timeframe=1m.
trades_kline@5mobject[] | objectTrade candles, spot + futures (N latest closed buckets). Timeframe 5m. Same content as /v1/trades-kline?timeframe=5m.
trades_kline@15mobject[] | objectTrade candles, spot + futures (N latest closed buckets). Timeframe 15m. Same content as /v1/trades-kline?timeframe=15m.
trades_kline@30mobject[] | objectTrade candles, spot + futures (N latest closed buckets). Timeframe 30m. Same content as /v1/trades-kline?timeframe=30m.
trades_kline@1hobject[] | objectTrade candles, spot + futures (N latest closed buckets). Timeframe 1h. Same content as /v1/trades-kline?timeframe=1h.
trades_kline@4hobject[] | objectTrade candles, spot + futures (N latest closed buckets). Timeframe 4h. Same content as /v1/trades-kline?timeframe=4h.
trades_kline@1dobject[] | objectTrade candles, spot + futures (N latest closed buckets). Timeframe 1d. Same content as /v1/trades-kline?timeframe=1d.
trades_kline_futures@1mobject[] | objectTrade candles, futures only. Timeframe 1m. Same content as /v1/trades-kline/futures?timeframe=1m.
trades_kline_futures@5mobject[] | objectTrade candles, futures only. Timeframe 5m. Same content as /v1/trades-kline/futures?timeframe=5m.
trades_kline_futures@15mobject[] | objectTrade candles, futures only. Timeframe 15m. Same content as /v1/trades-kline/futures?timeframe=15m.
trades_kline_futures@30mobject[] | objectTrade candles, futures only. Timeframe 30m. Same content as /v1/trades-kline/futures?timeframe=30m.
trades_kline_futures@1hobject[] | objectTrade candles, futures only. Timeframe 1h. Same content as /v1/trades-kline/futures?timeframe=1h.
trades_kline_futures@4hobject[] | objectTrade candles, futures only. Timeframe 4h. Same content as /v1/trades-kline/futures?timeframe=4h.
trades_kline_futures@1dobject[] | objectTrade candles, futures only. Timeframe 1d. Same content as /v1/trades-kline/futures?timeframe=1d.
trades_kline_spot@1mobject[] | objectTrade candles, spot only. Timeframe 1m. Same content as /v1/trades-kline/spot?timeframe=1m.
trades_kline_spot@5mobject[] | objectTrade candles, spot only. Timeframe 5m. Same content as /v1/trades-kline/spot?timeframe=5m.
trades_kline_spot@15mobject[] | objectTrade candles, spot only. Timeframe 15m. Same content as /v1/trades-kline/spot?timeframe=15m.
trades_kline_spot@30mobject[] | objectTrade candles, spot only. Timeframe 30m. Same content as /v1/trades-kline/spot?timeframe=30m.
trades_kline_spot@1hobject[] | objectTrade candles, spot only. Timeframe 1h. Same content as /v1/trades-kline/spot?timeframe=1h.
trades_kline_spot@4hobject[] | objectTrade candles, spot only. Timeframe 4h. Same content as /v1/trades-kline/spot?timeframe=4h.
trades_kline_spot@1dobject[] | objectTrade candles, spot only. Timeframe 1d. Same content as /v1/trades-kline/spot?timeframe=1d.
available_fieldsstring[]Catalogue (?symbol= alone): the single-value fields your plan includes.
available_multi_tf_fieldsstring[]Catalogue: the fields requested per timeframe, as <field>@<tf>=<depth>.
multi_tf_syntaxstringCatalogue: how to request a multi-timeframe field.
timeframesstring[]Catalogue: the timeframes a multi-timeframe field accepts by default.
timeframes_by_fieldobjectCatalogue: the fields whose timeframes differ from timeframes.
max_depthobjectCatalogue: the largest depth each field accepts (a larger one: 422 depth_too_large).
Try it

GET https://api.bytnode.com/v1/snapshot?symbol=BTCUSDT&basis=1&fear_greed=1&funding_rate=1&cvd@1h=2

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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.

ParameterTypeDefaultDescription
timeframe requiredstring—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.
livebooleanfalse1 or true to return the CURRENT, still-open period computed on the fly (is_closed: false). Default: the last closed period only.
symbol requiredstring—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.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,open. Unknown field: 422 unknown_field with a suggestion.
18 fields of the response
Field of dataTypeUnitDescription
timedate-timeISO 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.
opennumberquote currency (USDT for BTCUSDT)Opening price of the candle.
highnumberquote currency (USDT for BTCUSDT)Highest price of the candle.
lownumberquote currency (USDT for BTCUSDT)Lowest price of the candle.
closenumberquote currency (USDT for BTCUSDT)Closing price of the candle (last price for the open candle).
volumenumber | nullbase 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_volumenumber | nullbase asset quantity (BTC for BTCUSDT)Aggressive (taker) buy volume, base asset units, aggregated across venues.
sell_volumenumber | nullbase asset quantity (BTC for BTCUSDT)Aggressive (taker) sell volume, base asset units, aggregated across venues.
is_volume_estimatedboolean | nulltrue 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_spotnumber | nullbase 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_spotnumber | nullbase asset quantity (BTC for BTCUSDT)Aggressive (taker) buy volume on the SPOT market, across venues.
sell_volume_spotnumber | nullbase asset quantity (BTC for BTCUSDT)Aggressive (taker) sell volume on the SPOT market, across venues.
is_volume_spot_estimatedboolean | nulltrue 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_futuresnumber | nullbase 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_futuresnumber | nullbase asset quantity (BTC for BTCUSDT)Aggressive (taker) buy volume on PERPETUAL FUTURES, across venues.
sell_volume_futuresnumber | nullbase asset quantity (BTC for BTCUSDT)Aggressive (taker) sell volume on PERPETUAL FUTURES, across venues.
is_volume_futures_estimatedboolean | nulltrue 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_closedbooleantrue = 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.
Try it

GET https://api.bytnode.com/v1/klines?timeframe=1h&symbol=BTCUSDT

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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).

ParameterTypeDefaultDescription
timeframe requiredstring—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_msinteger—Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range.
until_msinteger—Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next.
limitinteger · 1–1000100Number 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 requiredstring—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.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,open. Unknown field: 422 unknown_field with a suggestion.
before_msinteger—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).
orderstringdescReading 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 fields of the response
Field of dataTypeUnitDescription
[].timedate-timeISO 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.
[].opennumberquote currency (USDT for BTCUSDT)Opening price of the candle.
[].highnumberquote currency (USDT for BTCUSDT)Highest price of the candle.
[].lownumberquote currency (USDT for BTCUSDT)Lowest price of the candle.
[].closenumberquote currency (USDT for BTCUSDT)Closing price of the candle (last price for the open candle).
[].volumenumber | nullbase 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_volumenumber | nullbase asset quantity (BTC for BTCUSDT)Aggressive (taker) buy volume, base asset units, aggregated across venues.
[].sell_volumenumber | nullbase asset quantity (BTC for BTCUSDT)Aggressive (taker) sell volume, base asset units, aggregated across venues.
[].is_volume_estimatedboolean | nulltrue 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_spotnumber | nullbase 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_spotnumber | nullbase asset quantity (BTC for BTCUSDT)Aggressive (taker) buy volume on the SPOT market, across venues.
[].sell_volume_spotnumber | nullbase asset quantity (BTC for BTCUSDT)Aggressive (taker) sell volume on the SPOT market, across venues.
[].is_volume_spot_estimatedboolean | nulltrue 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_futuresnumber | nullbase 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_futuresnumber | nullbase asset quantity (BTC for BTCUSDT)Aggressive (taker) buy volume on PERPETUAL FUTURES, across venues.
[].sell_volume_futuresnumber | nullbase asset quantity (BTC for BTCUSDT)Aggressive (taker) sell volume on PERPETUAL FUTURES, across venues.
[].is_volume_futures_estimatedboolean | nulltrue 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_closedbooleantrue = 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.
Try it

GET https://api.bytnode.com/v1/klines/history?timeframe=1h&limit=3&symbol=BTCUSDT

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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.

ParameterTypeDefaultDescription
symbol requiredstring—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.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,price. Unknown field: 422 unknown_field with a suggestion.
11 fields of the response
Field of dataTypeUnitDescription
timedate-timeISO 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.
pricenumberquote currency (USDT for BTCUSDT)Price.
changes_pctobjectPrice change over each window, keyed by window (1m … 1w), in percent.
changes_pct.1mnumberpercentPrice change over the last 1m, in percent.
changes_pct.5mnumberpercentPrice change over the last 5m, in percent.
changes_pct.15mnumberpercentPrice change over the last 15m, in percent.
changes_pct.30mnumberpercentPrice change over the last 30m, in percent.
changes_pct.1hnumberpercentPrice change over the last 1h, in percent.
changes_pct.4hnumber | nullpercentPrice change over the last 4h, in percent.
changes_pct.1dnumber | nullpercentPrice change over the last 1d, in percent.
changes_pct.1wnumber | nullpercentPrice change over the last 1w, in percent.
Try it

GET https://api.bytnode.com/v1/price-change?symbol=BTCUSDT

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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.

ParameterTypeDefaultDescription
limitinteger · 1–10000100Number 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_msinteger—Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range.
until_msinteger—Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next.
before_msinteger—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_idstring—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.
orderstring—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 requiredstring—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.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,id. Unknown field: 422 unknown_field with a suggestion.
6 fields of the response
Field of dataTypeUnitDescription
[].timedate-timeISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z)Execution instant of the trade, as stated by the venue (milliseconds).
[].idstringOpaque, 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.
[].sidestringTrades: buy or sell (aggressor side). Liquidations: long or short (the position liquidated).
[].pricenumberquote currency (USDT for BTCUSDT)Price.
[].quantitynumberbase asset quantity (BTC for BTCUSDT)Quantity traded or liquidated, in base asset units.
[].value_usdnumberUSDNotional value: price × quantity, in the pair's quote currency (USDT for BTCUSDT), taken as USD.
Try it

GET https://api.bytnode.com/v1/trades/futures?limit=3&symbol=BTCUSDT

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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).

ParameterTypeDefaultDescription
min_usdnumber100000Minimum notional in USD (default 100000, minimum 1000).
limitinteger · 1–10000100Number 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_msinteger—Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range.
until_msinteger—Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next.
before_msinteger—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_idstring—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.
orderstring—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 requiredstring—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.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,id. Unknown field: 422 unknown_field with a suggestion.
6 fields of the response
Field of dataTypeUnitDescription
[].timedate-timeISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z)Execution instant of the trade, as stated by the venue (milliseconds).
[].idstringOpaque, 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.
[].sidestringTrades: buy or sell (aggressor side). Liquidations: long or short (the position liquidated).
[].pricenumberquote currency (USDT for BTCUSDT)Price.
[].quantitynumberbase asset quantity (BTC for BTCUSDT)Quantity traded or liquidated, in base asset units.
[].value_usdnumberUSDNotional value: price × quantity, in the pair's quote currency (USDT for BTCUSDT), taken as USD.
Try it

GET https://api.bytnode.com/v1/trades/large?min_usd=100000&limit=3&symbol=BTCUSDT

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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.

ParameterTypeDefaultDescription
limitinteger · 1–10000100Number 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_msinteger—Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range.
until_msinteger—Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next.
before_msinteger—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_idstring—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.
orderstring—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 requiredstring—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.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,id. Unknown field: 422 unknown_field with a suggestion.
6 fields of the response
Field of dataTypeUnitDescription
[].timedate-timeISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z)Execution instant of the trade, as stated by the venue (milliseconds).
[].idstringOpaque, 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.
[].sidestringTrades: buy or sell (aggressor side). Liquidations: long or short (the position liquidated).
[].pricenumberquote currency (USDT for BTCUSDT)Price.
[].quantitynumberbase asset quantity (BTC for BTCUSDT)Quantity traded or liquidated, in base asset units.
[].value_usdnumberUSDNotional value: price × quantity, in the pair's quote currency (USDT for BTCUSDT), taken as USD.
Try it

GET https://api.bytnode.com/v1/trades/spot?limit=3&symbol=BTCUSDT

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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.

ParameterTypeDefaultDescription
timeframe requiredstring—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 requiredstring—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.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,buy_volume. Unknown field: 422 unknown_field with a suggestion.
8 fields of the response
Field of dataTypeUnitDescription
timedate-timeISO 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_volumenumber | nullbase asset quantity (BTC for BTCUSDT)Aggressive (taker) buy volume, base asset units, aggregated across venues.
sell_volumenumber | nullbase asset quantity (BTC for BTCUSDT)Aggressive (taker) sell volume, base asset units, aggregated across venues.
buy_rationumber | nullfraction (0.585 = 58.5 %)buy_volume / (buy_volume + sell_volume). Above 0.5 = buyers dominate.
sample_countinteger | nullcountNumber of points of the CVD series behind the bucket — the sample_count of /v1/cvd for the same bucket.
buy_sell_coverage_rationumber | nullfraction (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_estimatedboolean | nulltrue 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_closedbooleantrue = 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.
Try it

GET https://api.bytnode.com/v1/buy-sell-ratio?timeframe=1h&symbol=BTCUSDT

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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.

ParameterTypeDefaultDescription
timeframe requiredstring—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 requiredstring—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.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,buy_volume. Unknown field: 422 unknown_field with a suggestion.
8 fields of the response
Field of dataTypeUnitDescription
timedate-timeISO 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_volumenumber | nullbase asset quantity (BTC for BTCUSDT)Aggressive (taker) buy volume, base asset units, aggregated across venues.
sell_volumenumber | nullbase asset quantity (BTC for BTCUSDT)Aggressive (taker) sell volume, base asset units, aggregated across venues.
buy_rationumber | nullfraction (0.585 = 58.5 %)buy_volume / (buy_volume + sell_volume). Above 0.5 = buyers dominate.
sample_countinteger | nullcountNumber of points of the CVD series behind the bucket — the sample_count of /v1/cvd for the same bucket.
buy_sell_coverage_rationumber | nullfraction (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_estimatedboolean | nulltrue 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_closedbooleantrue = 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.
Try it

GET https://api.bytnode.com/v1/buy-sell-ratio/futures?timeframe=1h&symbol=BTCUSDT

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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.

ParameterTypeDefaultDescription
since_msinteger—Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range.
until_msinteger—Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next.
limitinteger · 1–1000100Number 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 requiredstring—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 requiredstring—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.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,buy_volume. Unknown field: 422 unknown_field with a suggestion.
before_msinteger—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).
orderstringdescReading 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 fields of the response
Field of dataTypeUnitDescription
[].timedate-timeISO 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_volumenumber | nullbase asset quantity (BTC for BTCUSDT)Aggressive (taker) buy volume, base asset units, aggregated across venues.
[].sell_volumenumber | nullbase asset quantity (BTC for BTCUSDT)Aggressive (taker) sell volume, base asset units, aggregated across venues.
[].buy_rationumber | nullfraction (0.585 = 58.5 %)buy_volume / (buy_volume + sell_volume). Above 0.5 = buyers dominate.
[].sample_countinteger | nullcountNumber of points of the CVD series behind the bucket — the sample_count of /v1/cvd/history for the same bucket.
[].buy_sell_coverage_rationumber | nullfraction (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_estimatedboolean | nulltrue 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_closedbooleantrue = 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.
Try it

GET https://api.bytnode.com/v1/buy-sell-ratio/futures/history?limit=3&timeframe=1h&symbol=BTCUSDT

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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).

ParameterTypeDefaultDescription
since_msinteger—Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range.
until_msinteger—Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next.
limitinteger · 1–1000100Number 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 requiredstring—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 requiredstring—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.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,buy_volume. Unknown field: 422 unknown_field with a suggestion.
before_msinteger—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).
orderstringdescReading 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 fields of the response
Field of dataTypeUnitDescription
[].timedate-timeISO 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_volumenumber | nullbase asset quantity (BTC for BTCUSDT)Aggressive (taker) buy volume, base asset units, aggregated across venues.
[].sell_volumenumber | nullbase asset quantity (BTC for BTCUSDT)Aggressive (taker) sell volume, base asset units, aggregated across venues.
[].buy_rationumber | nullfraction (0.585 = 58.5 %)buy_volume / (buy_volume + sell_volume). Above 0.5 = buyers dominate.
[].sample_countinteger | nullcountNumber of points of the CVD series behind the bucket — the sample_count of /v1/cvd/history for the same bucket.
[].buy_sell_coverage_rationumber | nullfraction (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_estimatedboolean | nulltrue 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_closedbooleantrue = 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.
Try it

GET https://api.bytnode.com/v1/buy-sell-ratio/history?limit=3&timeframe=1h&symbol=BTCUSDT

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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.

ParameterTypeDefaultDescription
timeframe requiredstring—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 requiredstring—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.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,buy_volume. Unknown field: 422 unknown_field with a suggestion.
8 fields of the response
Field of dataTypeUnitDescription
timedate-timeISO 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_volumenumber | nullbase asset quantity (BTC for BTCUSDT)Aggressive (taker) buy volume, base asset units, aggregated across venues.
sell_volumenumber | nullbase asset quantity (BTC for BTCUSDT)Aggressive (taker) sell volume, base asset units, aggregated across venues.
buy_rationumber | nullfraction (0.585 = 58.5 %)buy_volume / (buy_volume + sell_volume). Above 0.5 = buyers dominate.
sample_countinteger | nullcountNumber of points of the CVD series behind the bucket — the sample_count of /v1/cvd for the same bucket.
buy_sell_coverage_rationumber | nullfraction (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_estimatedboolean | nulltrue 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_closedbooleantrue = 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.
Try it

GET https://api.bytnode.com/v1/buy-sell-ratio/spot?timeframe=1h&symbol=BTCUSDT

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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.

ParameterTypeDefaultDescription
since_msinteger—Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range.
until_msinteger—Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next.
limitinteger · 1–1000100Number 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 requiredstring—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 requiredstring—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.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,buy_volume. Unknown field: 422 unknown_field with a suggestion.
before_msinteger—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).
orderstringdescReading 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 fields of the response
Field of dataTypeUnitDescription
[].timedate-timeISO 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_volumenumber | nullbase asset quantity (BTC for BTCUSDT)Aggressive (taker) buy volume, base asset units, aggregated across venues.
[].sell_volumenumber | nullbase asset quantity (BTC for BTCUSDT)Aggressive (taker) sell volume, base asset units, aggregated across venues.
[].buy_rationumber | nullfraction (0.585 = 58.5 %)buy_volume / (buy_volume + sell_volume). Above 0.5 = buyers dominate.
[].sample_countinteger | nullcountNumber of points of the CVD series behind the bucket — the sample_count of /v1/cvd/history for the same bucket.
[].buy_sell_coverage_rationumber | nullfraction (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_estimatedboolean | nulltrue 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_closedbooleantrue = 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.
Try it

GET https://api.bytnode.com/v1/buy-sell-ratio/spot/history?limit=3&timeframe=1h&symbol=BTCUSDT

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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.

ParameterTypeDefaultDescription
timeframe requiredstring—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.
livebooleanfalse1 or true to return the CURRENT, still-open period computed on the fly (is_closed: false). Default: the last closed period only.
symbol requiredstring—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.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,net_volume. Unknown field: 422 unknown_field with a suggestion.
9 fields of the response
Field of dataTypeUnitDescription
timedate-timeISO 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_seriesnumber[] | nullbase 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_volumenumber | nullbase asset quantity (BTC for BTCUSDT)buy_volume - sell_volume over the row, base asset units. Positive = net buying.
buy_volumenumber | nullbase asset quantity (BTC for BTCUSDT)Aggressive (taker) buy volume, base asset units, aggregated across venues.
sell_volumenumber | nullbase asset quantity (BTC for BTCUSDT)Aggressive (taker) sell volume, base asset units, aggregated across venues.
sample_countinteger | nullcountNumber of points in cvd_series; 1 when cvd_series is null (the bucket's candle alone).
buy_sell_coverage_rationumber | nullfraction (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_estimatedboolean | nulltrue 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_closedbooleantrue = 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.
Try it

GET https://api.bytnode.com/v1/cvd?timeframe=1h&symbol=BTCUSDT

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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.

ParameterTypeDefaultDescription
timeframe requiredstring—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.
livebooleanfalse1 or true to return the CURRENT, still-open period computed on the fly (is_closed: false). Default: the last closed period only.
symbol requiredstring—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.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,net_volume. Unknown field: 422 unknown_field with a suggestion.
9 fields of the response
Field of dataTypeUnitDescription
timedate-timeISO 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_seriesnumber[] | nullbase 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_volumenumber | nullbase asset quantity (BTC for BTCUSDT)buy_volume - sell_volume over the row, base asset units. Positive = net buying.
buy_volumenumber | nullbase asset quantity (BTC for BTCUSDT)Aggressive (taker) buy volume, base asset units, aggregated across venues.
sell_volumenumber | nullbase asset quantity (BTC for BTCUSDT)Aggressive (taker) sell volume, base asset units, aggregated across venues.
sample_countinteger | nullcountNumber of points in cvd_series; 1 when cvd_series is null (the bucket's candle alone).
buy_sell_coverage_rationumber | nullfraction (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_estimatedboolean | nulltrue 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_closedbooleantrue = 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.
Try it

GET https://api.bytnode.com/v1/cvd/futures?timeframe=1h&symbol=BTCUSDT

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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.

ParameterTypeDefaultDescription
timeframe requiredstring—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_msinteger—Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range.
until_msinteger—Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next.
limitinteger · 1–1000100Number 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 requiredstring—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.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,net_volume. Unknown field: 422 unknown_field with a suggestion.
before_msinteger—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).
orderstringdescReading 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 fields of the response
Field of dataTypeUnitDescription
[].timedate-timeISO 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_seriesnumber[] | nullbase 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_volumenumber | nullbase asset quantity (BTC for BTCUSDT)buy_volume - sell_volume over the row, base asset units. Positive = net buying.
[].buy_volumenumber | nullbase asset quantity (BTC for BTCUSDT)Aggressive (taker) buy volume, base asset units, aggregated across venues.
[].sell_volumenumber | nullbase asset quantity (BTC for BTCUSDT)Aggressive (taker) sell volume, base asset units, aggregated across venues.
[].sample_countinteger | nullcountNumber of points in cvd_series; 1 when cvd_series is null (the bucket's candle alone).
[].buy_sell_coverage_rationumber | nullfraction (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_estimatedboolean | nulltrue 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_closedbooleantrue = 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.
Try it

GET https://api.bytnode.com/v1/cvd/futures/history?timeframe=1h&limit=3&symbol=BTCUSDT

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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).

ParameterTypeDefaultDescription
timeframe requiredstring—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_msinteger—Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range.
until_msinteger—Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next.
limitinteger · 1–1000100Number 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 requiredstring—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.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,net_volume. Unknown field: 422 unknown_field with a suggestion.
before_msinteger—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).
orderstringdescReading 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 fields of the response
Field of dataTypeUnitDescription
[].timedate-timeISO 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_seriesnumber[] | nullbase 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_volumenumber | nullbase asset quantity (BTC for BTCUSDT)buy_volume - sell_volume over the row, base asset units. Positive = net buying.
[].buy_volumenumber | nullbase asset quantity (BTC for BTCUSDT)Aggressive (taker) buy volume, base asset units, aggregated across venues.
[].sell_volumenumber | nullbase asset quantity (BTC for BTCUSDT)Aggressive (taker) sell volume, base asset units, aggregated across venues.
[].sample_countinteger | nullcountNumber of points in cvd_series; 1 when cvd_series is null (the bucket's candle alone).
[].buy_sell_coverage_rationumber | nullfraction (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_estimatedboolean | nulltrue 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_closedbooleantrue = 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.
Try it

GET https://api.bytnode.com/v1/cvd/history?timeframe=1h&limit=3&symbol=BTCUSDT

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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.

ParameterTypeDefaultDescription
timeframe requiredstring—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.
livebooleanfalse1 or true to return the CURRENT, still-open period computed on the fly (is_closed: false). Default: the last closed period only.
symbol requiredstring—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.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,net_volume. Unknown field: 422 unknown_field with a suggestion.
9 fields of the response
Field of dataTypeUnitDescription
timedate-timeISO 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_seriesnumber[] | nullbase 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_volumenumber | nullbase asset quantity (BTC for BTCUSDT)buy_volume - sell_volume over the row, base asset units. Positive = net buying.
buy_volumenumber | nullbase asset quantity (BTC for BTCUSDT)Aggressive (taker) buy volume, base asset units, aggregated across venues.
sell_volumenumber | nullbase asset quantity (BTC for BTCUSDT)Aggressive (taker) sell volume, base asset units, aggregated across venues.
sample_countinteger | nullcountNumber of points in cvd_series; 1 when cvd_series is null (the bucket's candle alone).
buy_sell_coverage_rationumber | nullfraction (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_estimatedboolean | nulltrue 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_closedbooleantrue = 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.
Try it

GET https://api.bytnode.com/v1/cvd/spot?timeframe=1h&symbol=BTCUSDT

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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.

ParameterTypeDefaultDescription
timeframe requiredstring—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_msinteger—Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range.
until_msinteger—Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next.
limitinteger · 1–1000100Number 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 requiredstring—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.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,net_volume. Unknown field: 422 unknown_field with a suggestion.
before_msinteger—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).
orderstringdescReading 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 fields of the response
Field of dataTypeUnitDescription
[].timedate-timeISO 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_seriesnumber[] | nullbase 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_volumenumber | nullbase asset quantity (BTC for BTCUSDT)buy_volume - sell_volume over the row, base asset units. Positive = net buying.
[].buy_volumenumber | nullbase asset quantity (BTC for BTCUSDT)Aggressive (taker) buy volume, base asset units, aggregated across venues.
[].sell_volumenumber | nullbase asset quantity (BTC for BTCUSDT)Aggressive (taker) sell volume, base asset units, aggregated across venues.
[].sample_countinteger | nullcountNumber of points in cvd_series; 1 when cvd_series is null (the bucket's candle alone).
[].buy_sell_coverage_rationumber | nullfraction (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_estimatedboolean | nulltrue 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_closedbooleantrue = 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.
Try it

GET https://api.bytnode.com/v1/cvd/spot/history?timeframe=1h&limit=3&symbol=BTCUSDT

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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.

ParameterTypeDefaultDescription
timeframe requiredstring—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 requiredstring—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.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,is_closed. Unknown field: 422 unknown_field with a suggestion.
9 fields of the response
Field of dataTypeUnitDescription
timedate-timeISO 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_closedbooleantrue = 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.
rangesobject[]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_pctnumberpercent (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_quantitynumber | nullbase 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_quantitynumber | nullbase 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_usdnumberUSDUSD value (Σ price × quantity) of the buy orders inside the range.
ranges[].asks_usdnumberUSDUSD value (Σ price × quantity) of the sell orders inside the range.
ranges[].imbalance_rationumber | nullfraction from -1 to 1(bids_usd - asks_usd) / (bids_usd + asks_usd). Positive = more bids than asks. null when one side is not measured.
Try it

GET https://api.bytnode.com/v1/orderbook?timeframe=1h&symbol=BTCUSDT

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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.

ParameterTypeDefaultDescription
timeframe requiredstring—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 requiredstring—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.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,is_closed. Unknown field: 422 unknown_field with a suggestion.
9 fields of the response
Field of dataTypeUnitDescription
timedate-timeISO 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_closedbooleantrue = 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.
rangesobject[]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_pctnumberpercent (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_quantitynumber | nullbase 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_quantitynumber | nullbase 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_usdnumberUSDUSD value (Σ price × quantity) of the buy orders inside the range.
ranges[].asks_usdnumberUSDUSD value (Σ price × quantity) of the sell orders inside the range.
ranges[].imbalance_rationumber | nullfraction from -1 to 1(bids_usd - asks_usd) / (bids_usd + asks_usd). Positive = more bids than asks. null when one side is not measured.
Try it

GET https://api.bytnode.com/v1/orderbook/futures?timeframe=1h&symbol=BTCUSDT

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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.

ParameterTypeDefaultDescription
timeframe requiredstring—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_msinteger—Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range.
until_msinteger—Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next.
limitinteger · 1–1000100Number 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 requiredstring—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.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,is_closed. Unknown field: 422 unknown_field with a suggestion.
before_msinteger—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).
orderstringdescReading 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 fields of the response
Field of dataTypeUnitDescription
[].timedate-timeISO 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_closedbooleantrue = 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.
[].rangesobject[]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_pctnumberpercent (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_quantitynumber | nullbase 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_quantitynumber | nullbase 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_usdnumberUSDUSD value (Σ price × quantity) of the buy orders inside the range.
[].ranges[].asks_usdnumberUSDUSD value (Σ price × quantity) of the sell orders inside the range.
[].ranges[].imbalance_rationumber | nullfraction from -1 to 1(bids_usd - asks_usd) / (bids_usd + asks_usd). Positive = more bids than asks. null when one side is not measured.
Try it

GET https://api.bytnode.com/v1/orderbook/futures/history?timeframe=1h&limit=3&symbol=BTCUSDT

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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).

ParameterTypeDefaultDescription
timeframe requiredstring—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_msinteger—Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range.
until_msinteger—Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next.
limitinteger · 1–1000100Number 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 requiredstring—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.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,is_closed. Unknown field: 422 unknown_field with a suggestion.
before_msinteger—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).
orderstringdescReading 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 fields of the response
Field of dataTypeUnitDescription
[].timedate-timeISO 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_closedbooleantrue = 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.
[].rangesobject[]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_pctnumberpercent (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_quantitynumber | nullbase 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_quantitynumber | nullbase 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_usdnumberUSDUSD value (Σ price × quantity) of the buy orders inside the range.
[].ranges[].asks_usdnumberUSDUSD value (Σ price × quantity) of the sell orders inside the range.
[].ranges[].imbalance_rationumber | nullfraction from -1 to 1(bids_usd - asks_usd) / (bids_usd + asks_usd). Positive = more bids than asks. null when one side is not measured.
Try it

GET https://api.bytnode.com/v1/orderbook/history?timeframe=1h&limit=3&symbol=BTCUSDT

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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.

ParameterTypeDefaultDescription
timeframe requiredstring—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 requiredstring—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.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,is_closed. Unknown field: 422 unknown_field with a suggestion.
9 fields of the response
Field of dataTypeUnitDescription
timedate-timeISO 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_closedbooleantrue = 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.
rangesobject[]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_pctnumberpercent (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_quantitynumber | nullbase 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_quantitynumber | nullbase 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_usdnumberUSDUSD value (Σ price × quantity) of the buy orders inside the range.
ranges[].asks_usdnumberUSDUSD value (Σ price × quantity) of the sell orders inside the range.
ranges[].imbalance_rationumber | nullfraction from -1 to 1(bids_usd - asks_usd) / (bids_usd + asks_usd). Positive = more bids than asks. null when one side is not measured.
Try it

GET https://api.bytnode.com/v1/orderbook/spot?timeframe=1h&symbol=BTCUSDT

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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.

ParameterTypeDefaultDescription
timeframe requiredstring—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_msinteger—Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range.
until_msinteger—Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next.
limitinteger · 1–1000100Number 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 requiredstring—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.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,is_closed. Unknown field: 422 unknown_field with a suggestion.
before_msinteger—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).
orderstringdescReading 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 fields of the response
Field of dataTypeUnitDescription
[].timedate-timeISO 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_closedbooleantrue = 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.
[].rangesobject[]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_pctnumberpercent (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_quantitynumber | nullbase 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_quantitynumber | nullbase 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_usdnumberUSDUSD value (Σ price × quantity) of the buy orders inside the range.
[].ranges[].asks_usdnumberUSDUSD value (Σ price × quantity) of the sell orders inside the range.
[].ranges[].imbalance_rationumber | nullfraction from -1 to 1(bids_usd - asks_usd) / (bids_usd + asks_usd). Positive = more bids than asks. null when one side is not measured.
Try it

GET https://api.bytnode.com/v1/orderbook/spot/history?timeframe=1h&limit=3&symbol=BTCUSDT

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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.

ParameterTypeDefaultDescription
timeframe requiredstring—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.
livebooleanfalse1 or true to return the CURRENT, still-open period computed on the fly (is_closed: false). Default: the last closed period only.
symbol requiredstring—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.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,is_closed. Unknown field: 422 unknown_field with a suggestion.
13 fields of the response
Field of dataTypeUnitDescription
timedate-timeISO 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_closedbooleantrue = 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_pricenumberquote 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.
weightingstringHow venues are combined: oi (open-interest weighted) or volume (volume weighted).
max_spread_bpsnumberbasis points (1 bp = 0.01 %)Gap between the highest and the lowest venue price, relative to ref_price.
high_venuestringVenue with the highest price over the bucket.
high_pricenumberquote currency (USDT for BTCUSDT)Its volume-weighted price over the bucket.
low_venuestringVenue with the lowest price over the bucket.
low_pricenumberquote currency (USDT for BTCUSDT)Its volume-weighted price over the bucket.
venuesobject[]Per-venue prices and premiums ([{venue, price, premium_bps}]).
venues[].venuestringVenue name (with the liquidations, the only data that names its venues).
venues[].pricenumberquote currency (USDT for BTCUSDT)Volume-weighted price of the venue over the bucket.
venues[].premium_bpsnumberbasis points (1 bp = 0.01 %)Venue price premium (positive) or discount (negative) versus ref_price.
Try it

GET https://api.bytnode.com/v1/spread/interexchange?timeframe=1h&symbol=BTCUSDT

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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).

ParameterTypeDefaultDescription
timeframe requiredstring—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_msinteger—Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range.
until_msinteger—Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next.
limitinteger · 1–1000100Number 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 requiredstring—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.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,is_closed. Unknown field: 422 unknown_field with a suggestion.
before_msinteger—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).
orderstringdescReading 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 fields of the response
Field of dataTypeUnitDescription
[].timedate-timeISO 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_closedbooleantrue = 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_pricenumberquote 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.
[].weightingstringHow venues are combined: oi (open-interest weighted) or volume (volume weighted).
[].max_spread_bpsnumberbasis points (1 bp = 0.01 %)Gap between the highest and the lowest venue price, relative to ref_price.
[].high_venuestringVenue with the highest price over the bucket.
[].high_pricenumberquote currency (USDT for BTCUSDT)Its volume-weighted price over the bucket.
[].low_venuestringVenue with the lowest price over the bucket.
[].low_pricenumberquote currency (USDT for BTCUSDT)Its volume-weighted price over the bucket.
[].venuesobject[]Per-venue prices and premiums ([{venue, price, premium_bps}]).
[].venues[].venuestringVenue name (with the liquidations, the only data that names its venues).
[].venues[].pricenumberquote currency (USDT for BTCUSDT)Volume-weighted price of the venue over the bucket.
[].venues[].premium_bpsnumberbasis points (1 bp = 0.01 %)Venue price premium (positive) or discount (negative) versus ref_price.
Try it

GET https://api.bytnode.com/v1/spread/interexchange/history?timeframe=1h&limit=3&symbol=BTCUSDT

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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.

ParameterTypeDefaultDescription
symbol requiredstring—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 requiredstring—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.
livebooleanfalse1 or true to return the CURRENT, still-open period computed on the fly (is_closed: false). Default: the last closed period only.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,trade_count. Unknown field: 422 unknown_field with a suggestion.
11 fields of the response
Field of dataTypeUnitDescription
timedate-timeISO 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_countinteger | nullcountNumber 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_sizenumber | nullbase asset quantity (BTC for BTCUSDT)Average trade size, base asset units (NOT dollars: multiply by the price for a notional).
volumenumber | nullbase 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_volumenumber | nullbase asset quantity (BTC for BTCUSDT)Aggressive (taker) buy volume, base asset units, aggregated across venues.
sell_volumenumber | nullbase asset quantity (BTC for BTCUSDT)Aggressive (taker) sell volume, base asset units, aggregated across venues.
net_volumenumber | nullbase asset quantity (BTC for BTCUSDT)buy_volume - sell_volume over the row, base asset units. Positive = net buying.
buy_sell_coverage_rationumber | nullfraction (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_ratenumber | nulltrades per secondAverage number of trades per second over the bucket. null when trade_count is.
is_volume_estimatedboolean | nulltrue 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_closedbooleantrue = 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.
Try it

GET https://api.bytnode.com/v1/trades-kline?symbol=BTCUSDT&timeframe=1h

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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.

ParameterTypeDefaultDescription
symbol requiredstring—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 requiredstring—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.
livebooleanfalse1 or true to return the CURRENT, still-open period computed on the fly (is_closed: false). Default: the last closed period only.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,trade_count. Unknown field: 422 unknown_field with a suggestion.
11 fields of the response
Field of dataTypeUnitDescription
timedate-timeISO 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_countinteger | nullcountNumber 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_sizenumber | nullbase asset quantity (BTC for BTCUSDT)Average trade size, base asset units (NOT dollars: multiply by the price for a notional).
volumenumber | nullbase 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_volumenumber | nullbase asset quantity (BTC for BTCUSDT)Aggressive (taker) buy volume, base asset units, aggregated across venues.
sell_volumenumber | nullbase asset quantity (BTC for BTCUSDT)Aggressive (taker) sell volume, base asset units, aggregated across venues.
net_volumenumber | nullbase asset quantity (BTC for BTCUSDT)buy_volume - sell_volume over the row, base asset units. Positive = net buying.
buy_sell_coverage_rationumber | nullfraction (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_ratenumber | nulltrades per secondAverage number of trades per second over the bucket. null when trade_count is.
is_volume_estimatedboolean | nulltrue 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_closedbooleantrue = 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.
Try it

GET https://api.bytnode.com/v1/trades-kline/futures?symbol=BTCUSDT&timeframe=1h

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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).

ParameterTypeDefaultDescription
symbol requiredstring—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 requiredstring—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_msinteger—Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range.
until_msinteger—Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next.
limitinteger · 1–1000100Number 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.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,trade_count. Unknown field: 422 unknown_field with a suggestion.
before_msinteger—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).
orderstringdescReading 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 fields of the response
Field of dataTypeUnitDescription
[].timedate-timeISO 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_countinteger | nullcountNumber 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_sizenumber | nullbase asset quantity (BTC for BTCUSDT)Average trade size, base asset units (NOT dollars: multiply by the price for a notional).
[].volumenumber | nullbase 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_volumenumber | nullbase asset quantity (BTC for BTCUSDT)Aggressive (taker) buy volume, base asset units, aggregated across venues.
[].sell_volumenumber | nullbase asset quantity (BTC for BTCUSDT)Aggressive (taker) sell volume, base asset units, aggregated across venues.
[].net_volumenumber | nullbase asset quantity (BTC for BTCUSDT)buy_volume - sell_volume over the row, base asset units. Positive = net buying.
[].buy_sell_coverage_rationumber | nullfraction (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_ratenumber | nulltrades per secondAverage number of trades per second over the bucket. null when trade_count is.
[].is_volume_estimatedboolean | nulltrue 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_closedbooleantrue = 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.
Try it

GET https://api.bytnode.com/v1/trades-kline/futures/history?symbol=BTCUSDT&timeframe=1h&limit=3

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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).

ParameterTypeDefaultDescription
limitinteger · 1–1000100Number of seconds to return (one row per second with trades). In range reading, a page covers limit seconds of time.
since_msinteger—Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range.
until_msinteger—Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next.
orderstring—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 requiredstring—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.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,volume. Unknown field: 422 unknown_field with a suggestion.
before_msinteger—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 fields of the response
Field of dataTypeUnitDescription
[].timedate-timeISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z)Start of the second the row covers.
[].volumenumber | nullbase 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_countinteger | nullcountNumber 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_volumenumber | nullbase asset quantity (BTC for BTCUSDT)Aggressive (taker) buy volume, base asset units, aggregated across venues.
[].sell_volumenumber | nullbase asset quantity (BTC for BTCUSDT)Aggressive (taker) sell volume, base asset units, aggregated across venues.
[].is_closedbooleantrue = 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_volumenumber | nullbase asset quantity (BTC for BTCUSDT)buy_volume - sell_volume over the row, base asset units. Positive = net buying.
[].avg_trade_sizenumber | nullbase asset quantity (BTC for BTCUSDT)Average trade size, base asset units (NOT dollars: multiply by the price for a notional).
[].trade_ratenumber | nulltrades per secondAverage number of trades per second over the bucket. null when trade_count is.
[].is_volume_estimatedboolean | nulltrue 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).
Try it

GET https://api.bytnode.com/v1/trades-kline/futures/seconds?limit=3&symbol=BTCUSDT

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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).

ParameterTypeDefaultDescription
symbol requiredstring—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 requiredstring—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_msinteger—Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range.
until_msinteger—Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next.
limitinteger · 1–1000100Number 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.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,trade_count. Unknown field: 422 unknown_field with a suggestion.
before_msinteger—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).
orderstringdescReading 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 fields of the response
Field of dataTypeUnitDescription
[].timedate-timeISO 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_countinteger | nullcountNumber 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_sizenumber | nullbase asset quantity (BTC for BTCUSDT)Average trade size, base asset units (NOT dollars: multiply by the price for a notional).
[].volumenumber | nullbase 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_volumenumber | nullbase asset quantity (BTC for BTCUSDT)Aggressive (taker) buy volume, base asset units, aggregated across venues.
[].sell_volumenumber | nullbase asset quantity (BTC for BTCUSDT)Aggressive (taker) sell volume, base asset units, aggregated across venues.
[].net_volumenumber | nullbase asset quantity (BTC for BTCUSDT)buy_volume - sell_volume over the row, base asset units. Positive = net buying.
[].buy_sell_coverage_rationumber | nullfraction (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_ratenumber | nulltrades per secondAverage number of trades per second over the bucket. null when trade_count is.
[].is_volume_estimatedboolean | nulltrue 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_closedbooleantrue = 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.
Try it

GET https://api.bytnode.com/v1/trades-kline/history?symbol=BTCUSDT&timeframe=1h&limit=3

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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.

ParameterTypeDefaultDescription
symbol requiredstring—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 requiredstring—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.
livebooleanfalse1 or true to return the CURRENT, still-open period computed on the fly (is_closed: false). Default: the last closed period only.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,trade_count. Unknown field: 422 unknown_field with a suggestion.
11 fields of the response
Field of dataTypeUnitDescription
timedate-timeISO 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_countinteger | nullcountNumber 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_sizenumber | nullbase asset quantity (BTC for BTCUSDT)Average trade size, base asset units (NOT dollars: multiply by the price for a notional).
volumenumber | nullbase 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_volumenumber | nullbase asset quantity (BTC for BTCUSDT)Aggressive (taker) buy volume, base asset units, aggregated across venues.
sell_volumenumber | nullbase asset quantity (BTC for BTCUSDT)Aggressive (taker) sell volume, base asset units, aggregated across venues.
net_volumenumber | nullbase asset quantity (BTC for BTCUSDT)buy_volume - sell_volume over the row, base asset units. Positive = net buying.
buy_sell_coverage_rationumber | nullfraction (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_ratenumber | nulltrades per secondAverage number of trades per second over the bucket. null when trade_count is.
is_volume_estimatedboolean | nulltrue 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_closedbooleantrue = 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.
Try it

GET https://api.bytnode.com/v1/trades-kline/spot?symbol=BTCUSDT&timeframe=1h

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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).

ParameterTypeDefaultDescription
symbol requiredstring—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 requiredstring—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_msinteger—Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range.
until_msinteger—Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next.
limitinteger · 1–1000100Number 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.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,trade_count. Unknown field: 422 unknown_field with a suggestion.
before_msinteger—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).
orderstringdescReading 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 fields of the response
Field of dataTypeUnitDescription
[].timedate-timeISO 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_countinteger | nullcountNumber 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_sizenumber | nullbase asset quantity (BTC for BTCUSDT)Average trade size, base asset units (NOT dollars: multiply by the price for a notional).
[].volumenumber | nullbase 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_volumenumber | nullbase asset quantity (BTC for BTCUSDT)Aggressive (taker) buy volume, base asset units, aggregated across venues.
[].sell_volumenumber | nullbase asset quantity (BTC for BTCUSDT)Aggressive (taker) sell volume, base asset units, aggregated across venues.
[].net_volumenumber | nullbase asset quantity (BTC for BTCUSDT)buy_volume - sell_volume over the row, base asset units. Positive = net buying.
[].buy_sell_coverage_rationumber | nullfraction (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_ratenumber | nulltrades per secondAverage number of trades per second over the bucket. null when trade_count is.
[].is_volume_estimatedboolean | nulltrue 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_closedbooleantrue = 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.
Try it

GET https://api.bytnode.com/v1/trades-kline/spot/history?symbol=BTCUSDT&timeframe=1h&limit=3

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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.

ParameterTypeDefaultDescription
timeframe requiredstring—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 requiredstring—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.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,avg_trade_size. Unknown field: 422 unknown_field with a suggestion.
7 fields of the response
Field of dataTypeUnitDescription
timedate-timeISO 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_sizenumber | nullbase asset quantity (BTC for BTCUSDT)Average trade size, base asset units (NOT dollars: multiply by the price for a notional).
volumenumber | nullbase 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_countinteger | nullcountNumber 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_estimatedboolean | nulltrue 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_countinteger | nullcountNumber 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_closedbooleantrue = 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.
Try it

GET https://api.bytnode.com/v1/trades/avg-size?timeframe=1h&symbol=BTCUSDT

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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.

ParameterTypeDefaultDescription
timeframe requiredstring—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 requiredstring—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.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,avg_trade_size. Unknown field: 422 unknown_field with a suggestion.
7 fields of the response
Field of dataTypeUnitDescription
timedate-timeISO 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_sizenumber | nullbase asset quantity (BTC for BTCUSDT)Average trade size, base asset units (NOT dollars: multiply by the price for a notional).
volumenumber | nullbase 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_countinteger | nullcountNumber 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_estimatedboolean | nulltrue 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_countinteger | nullcountNumber 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_closedbooleantrue = 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.
Try it

GET https://api.bytnode.com/v1/trades/avg-size/futures?timeframe=1h&symbol=BTCUSDT

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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.

ParameterTypeDefaultDescription
since_msinteger—Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range.
until_msinteger—Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next.
limitinteger · 1–1000100Number 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 requiredstring—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 requiredstring—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.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,avg_trade_size. Unknown field: 422 unknown_field with a suggestion.
before_msinteger—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).
orderstringdescReading 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 fields of the response
Field of dataTypeUnitDescription
[].timedate-timeISO 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_sizenumber | nullbase asset quantity (BTC for BTCUSDT)Average trade size, base asset units (NOT dollars: multiply by the price for a notional).
[].volumenumber | nullbase 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_countinteger | nullcountNumber 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_estimatedboolean | nulltrue 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_countinteger | nullcountNumber 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_closedbooleantrue = 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.
Try it

GET https://api.bytnode.com/v1/trades/avg-size/futures/history?limit=3&timeframe=1h&symbol=BTCUSDT

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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).

ParameterTypeDefaultDescription
since_msinteger—Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range.
until_msinteger—Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next.
limitinteger · 1–1000100Number 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 requiredstring—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 requiredstring—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.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,avg_trade_size. Unknown field: 422 unknown_field with a suggestion.
before_msinteger—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).
orderstringdescReading 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 fields of the response
Field of dataTypeUnitDescription
[].timedate-timeISO 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_sizenumber | nullbase asset quantity (BTC for BTCUSDT)Average trade size, base asset units (NOT dollars: multiply by the price for a notional).
[].volumenumber | nullbase 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_countinteger | nullcountNumber 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_estimatedboolean | nulltrue 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_countinteger | nullcountNumber 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_closedbooleantrue = 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.
Try it

GET https://api.bytnode.com/v1/trades/avg-size/history?limit=3&timeframe=1h&symbol=BTCUSDT

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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.

ParameterTypeDefaultDescription
timeframe requiredstring—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 requiredstring—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.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,avg_trade_size. Unknown field: 422 unknown_field with a suggestion.
7 fields of the response
Field of dataTypeUnitDescription
timedate-timeISO 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_sizenumber | nullbase asset quantity (BTC for BTCUSDT)Average trade size, base asset units (NOT dollars: multiply by the price for a notional).
volumenumber | nullbase 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_countinteger | nullcountNumber 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_estimatedboolean | nulltrue 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_countinteger | nullcountNumber 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_closedbooleantrue = 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.
Try it

GET https://api.bytnode.com/v1/trades/avg-size/spot?timeframe=1h&symbol=BTCUSDT

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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.

ParameterTypeDefaultDescription
since_msinteger—Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range.
until_msinteger—Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next.
limitinteger · 1–1000100Number 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 requiredstring—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 requiredstring—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.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,avg_trade_size. Unknown field: 422 unknown_field with a suggestion.
before_msinteger—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).
orderstringdescReading 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 fields of the response
Field of dataTypeUnitDescription
[].timedate-timeISO 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_sizenumber | nullbase asset quantity (BTC for BTCUSDT)Average trade size, base asset units (NOT dollars: multiply by the price for a notional).
[].volumenumber | nullbase 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_countinteger | nullcountNumber 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_estimatedboolean | nulltrue 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_countinteger | nullcountNumber 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_closedbooleantrue = 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.
Try it

GET https://api.bytnode.com/v1/trades/avg-size/spot/history?limit=3&timeframe=1h&symbol=BTCUSDT

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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.

ParameterTypeDefaultDescription
symbol requiredstring—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.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,basis_value. Unknown field: 422 unknown_field with a suggestion.
5 fields of the response
Field of dataTypeUnitDescription
timedate-timeISO 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_valuenumberquote currency (USDT for BTCUSDT)Futures price - spot price, in the quote currency (USDT for BTCUSDT), like the two prices.
basis_pctnumberpercent (58.5 = 58.5 %)(futures - spot) / spot, in percent. Positive = contango.
futures_pricenumberquote currency (USDT for BTCUSDT)Perpetual futures price, open-interest weighted across venues.
spot_pricenumberquote 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.
Try it

GET https://api.bytnode.com/v1/basis?symbol=BTCUSDT

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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).

ParameterTypeDefaultDescription
since_msinteger—Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range.
until_msinteger—Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next.
limitinteger · 1–1000100Number 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 requiredstring—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 requiredstring—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.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,basis_value. Unknown field: 422 unknown_field with a suggestion.
before_msinteger—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).
orderstringdescReading 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 fields of the response
Field of dataTypeUnitDescription
[].timedate-timeISO 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_valuenumberquote currency (USDT for BTCUSDT)Futures price - spot price, in the quote currency (USDT for BTCUSDT), like the two prices.
[].basis_pctnumberpercent (58.5 = 58.5 %)(futures - spot) / spot, in percent. Positive = contango.
[].futures_pricenumberquote currency (USDT for BTCUSDT)Perpetual futures price, open-interest weighted across venues.
[].spot_pricenumberquote 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_countinteger | nullcountNumber 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_closedbooleantrue = 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.
Try it

GET https://api.bytnode.com/v1/basis/history?limit=3&timeframe=1h&symbol=BTCUSDT

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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.

ParameterTypeDefaultDescription
symbol requiredstring—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.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,window_start_at. Unknown field: 422 unknown_field with a suggestion.
6 fields of the response
Field of dataTypeUnitDescription
timedate-timeISO 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_atdate-timeISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z)Start of the 24-hour window summed (inclusive).
window_sinteger | nullsecondsLength of the window, in seconds (86400 = 24 hours).
rolling_24h_rate_pctnumberpercent (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_pctnumber | nullpercent (58.5 = 58.5 %)Annualised rate in percent.
sample_countinteger | nullcountNumber of 8-hour funding windows summed.
Try it

GET https://api.bytnode.com/v1/funding/cumulative?symbol=BTCUSDT

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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).

ParameterTypeDefaultDescription
since_msinteger—Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range.
until_msinteger—Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next.
limitinteger · 1–1000100Number 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 requiredstring—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.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,window_start_at. Unknown field: 422 unknown_field with a suggestion.
before_msinteger—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).
orderstringdescReading 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 fields of the response
Field of dataTypeUnitDescription
[].timedate-timeISO 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_atdate-timeISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z)Start of the 24-hour window summed (inclusive).
[].window_sinteger | nullsecondsLength of the window, in seconds (86400 = 24 hours).
[].rolling_24h_rate_pctnumberpercent (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_pctnumber | nullpercent (58.5 = 58.5 %)Annualised rate in percent.
[].sample_countinteger | nullcountNumber of 8-hour funding windows summed.
[].is_closedbooleantrue = 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.
Try it

GET https://api.bytnode.com/v1/funding/cumulative/history?limit=3&symbol=BTCUSDT

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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.

ParameterTypeDefaultDescription
symbol requiredstring—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.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,estimated_rate_pct. Unknown field: 422 unknown_field with a suggestion.
4 fields of the response
Field of dataTypeUnitDescription
timedate-timeISO 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_pctnumberpercent (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_pctnumber | nullpercent (58.5 = 58.5 %)Annualised rate in percent.
is_pastbooleantrue if the forecast settlement instant is already past (the next forecast is not published yet).
Try it

GET https://api.bytnode.com/v1/funding/next?symbol=BTCUSDT

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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.

ParameterTypeDefaultDescription
livebooleanfalse1 or true to return the CURRENT, still-open period computed on the fly (is_closed: false). Default: the last closed period only.
symbol requiredstring—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.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,period_end_at. Unknown field: 422 unknown_field with a suggestion.
6 fields of the response
Field of dataTypeUnitDescription
timedate-timeISO 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_atdate-timeISO 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_atdate-time | nullISO 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_pctnumberpercent (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_pctnumber | nullpercent (58.5 = 58.5 %)Annualised rate in percent.
is_closedbooleantrue = 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.
Try it

GET https://api.bytnode.com/v1/funding/rate?symbol=BTCUSDT

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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).

ParameterTypeDefaultDescription
since_msinteger—Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range.
until_msinteger—Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next.
limitinteger · 1–1000100Number 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 requiredstring—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.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,period_end_at. Unknown field: 422 unknown_field with a suggestion.
before_msinteger—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).
orderstringdescReading 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 fields of the response
Field of dataTypeUnitDescription
[].timedate-timeISO 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_atdate-timeISO 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_atdate-time | nullISO 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_pctnumberpercent (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_pctnumber | nullpercent (58.5 = 58.5 %)Annualised rate in percent.
[].is_closedbooleantrue = 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.
Try it

GET https://api.bytnode.com/v1/funding/rate/history?limit=3&symbol=BTCUSDT

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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.

ParameterTypeDefaultDescription
symbol requiredstring—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.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,oi. Unknown field: 422 unknown_field with a suggestion.
2 fields of the response
Field of dataTypeUnitDescription
timedate-timeISO 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).
oinumberbase 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.
Try it

GET https://api.bytnode.com/v1/oi?symbol=BTCUSDT

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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.

ParameterTypeDefaultDescription
symbol requiredstring—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.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,oi. Unknown field: 422 unknown_field with a suggestion.
7 fields of the response
Field of dataTypeUnitDescription
timedate-timeISO 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.
oinumberbase 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_oinumberbase asset quantity (BTC for BTCUSDT)Total open interest at the start of the window (window_start_at).
oi_changenumberbase asset quantity (BTC for BTCUSDT)oi - previous_oi, base asset units.
oi_change_pctnumberpercent (58.5 = 58.5 %)Relative open interest change, percent.
window_start_atdate-timeISO 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_sinteger | nullsecondsLength of that rolling window, in whole seconds: it runs from window_start_at to time (excluded).
Try it

GET https://api.bytnode.com/v1/oi/change?symbol=BTCUSDT

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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).

ParameterTypeDefaultDescription
since_msinteger—Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range.
until_msinteger—Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next.
limitinteger · 1–1000100Number 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 requiredstring—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 requiredstring—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.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,oi. Unknown field: 422 unknown_field with a suggestion.
before_msinteger—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).
orderstringdescReading 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 fields of the response
Field of dataTypeUnitDescription
[].timedate-timeISO 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).
[].oinumberbase 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_oinumberbase asset quantity (BTC for BTCUSDT)Total open interest at the start of the window (window_start_at).
[].oi_changenumberbase asset quantity (BTC for BTCUSDT)oi - previous_oi, base asset units.
[].oi_change_pctnumberpercent (58.5 = 58.5 %)Relative open interest change, percent.
[].sample_countinteger | nullcountNumber 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_closedbooleantrue = 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.
Try it

GET https://api.bytnode.com/v1/oi/change/history?limit=3&timeframe=1h&symbol=BTCUSDT

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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).

ParameterTypeDefaultDescription
since_msinteger—Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range.
until_msinteger—Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next.
limitinteger · 1–1000100Number 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 requiredstring—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 requiredstring—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.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,oi. Unknown field: 422 unknown_field with a suggestion.
before_msinteger—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).
orderstringdescReading 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 fields of the response
Field of dataTypeUnitDescription
[].timedate-timeISO 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.
[].oinumberbase 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_countinteger | nullcountNumber 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_closedbooleantrue = 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.
Try it

GET https://api.bytnode.com/v1/oi/history?limit=3&timeframe=1h&symbol=BTCUSDT

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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.

ParameterTypeDefaultDescription
timeframe requiredstring—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 requiredstring—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.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,big_count. Unknown field: 422 unknown_field with a suggestion.
9 fields of the response
Field of dataTypeUnitDescription
timedate-timeISO 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_countintegercountLiquidations of 100,000 USD or more.
big_usdnumberUSDNotional of liquidations of 100,000 USD or more.
small_countintegercountLiquidations below 100,000 USD.
small_usdnumberUSDNotional of liquidations below 100,000 USD.
big_small_rationumber | nullbig / smallbig_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.
venuesstring[]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_countinteger | nullcountNumber 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_closedbooleantrue = 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.
Try it

GET https://api.bytnode.com/v1/liquidations/big-small-ratio?timeframe=1h&symbol=BTCUSDT

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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).

ParameterTypeDefaultDescription
since_msinteger—Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range.
until_msinteger—Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next.
limitinteger · 1–1000100Number 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 requiredstring—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 requiredstring—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.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,big_count. Unknown field: 422 unknown_field with a suggestion.
before_msinteger—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).
orderstringdescReading 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 fields of the response
Field of dataTypeUnitDescription
[].timedate-timeISO 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_countintegercountLiquidations of 100,000 USD or more.
[].big_usdnumberUSDNotional of liquidations of 100,000 USD or more.
[].small_countintegercountLiquidations below 100,000 USD.
[].small_usdnumberUSDNotional of liquidations below 100,000 USD.
[].big_small_rationumber | nullbig / smallbig_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.
[].venuesstring[]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_countinteger | nullcountMinutes of the bucket that had at least one liquidation.
[].is_closedbooleantrue = 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.
Try it

GET https://api.bytnode.com/v1/liquidations/big-small-ratio/history?limit=3&timeframe=1h&symbol=BTCUSDT

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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.

ParameterTypeDefaultDescription
symbol requiredstring—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.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,long_usd. Unknown field: 422 unknown_field with a suggestion.
7 fields of the response
Field of dataTypeUnitDescription
timedate-timeISO 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_usdnumberUSDLong positions liquidated, USD.
short_usdnumberUSDShort positions liquidated, USD.
total_usdnumberUSDTotal, USD.
venuesany[]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_atdate-timeISO 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_sinteger | nullsecondsLength of that rolling window, in whole seconds: it runs from window_start_at to time (excluded).
Try it

GET https://api.bytnode.com/v1/liquidations/cumulative?symbol=BTCUSDT

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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).

ParameterTypeDefaultDescription
since_msinteger—Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range.
until_msinteger—Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next.
limitinteger · 1–1000100Number 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 requiredstring—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 requiredstring—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.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,long_usd. Unknown field: 422 unknown_field with a suggestion.
before_msinteger—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).
orderstringdescReading 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 fields of the response
Field of dataTypeUnitDescription
[].timedate-timeISO 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_usdnumberUSDLong positions liquidated, USD.
[].short_usdnumberUSDShort positions liquidated, USD.
[].total_usdnumberUSDTotal, USD.
[].sample_countinteger | nullcountNumber 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.
[].venuesstring[]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_closedbooleantrue = 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.
Try it

GET https://api.bytnode.com/v1/liquidations/cumulative/history?limit=3&timeframe=1h&symbol=BTCUSDT

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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.

ParameterTypeDefaultDescription
limitinteger · 1–10000100Number 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_usdnumber—Optional minimum notional in USD: only liquidations of at least this size are returned. limit always counts events.
symbol requiredstring—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.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,side. Unknown field: 422 unknown_field with a suggestion.
6 fields of the response
Field of dataTypeUnitDescription
[].timedate-timeISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z)Instant of the liquidation, as stated by the venue (milliseconds).
[].sidestringlong (a long position was liquidated: forced sell) or short (forced buy).
[].pricenumberquote currency (USDT for BTCUSDT)Price.
[].quantitynumberbase asset quantity (BTC for BTCUSDT)Quantity traded or liquidated, in base asset units.
[].value_usdnumberUSDNotional value: price × quantity, in the pair's quote currency (USDT for BTCUSDT), taken as USD.
[].venuestring | nullVenue where the liquidation happened (liquidations name their venues).
Try it

GET https://api.bytnode.com/v1/liquidations/events?limit=3&symbol=BTCUSDT

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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.

ParameterTypeDefaultDescription
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,value. Unknown field: 422 unknown_field with a suggestion.
7 fields of the response
Field of dataTypeUnitDescription
timedate-timeISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z)Point-in-time value: the instant of the measurement (when the source was read).
valueintegerscore from 0 to 100Altcoin Season Index (CoinMarketCap): how many of the top altcoins outperformed BTC over the last 90 days. High = altcoin season, low = bitcoin season.
year_lowintegerscore from 0 to 100Lowest value of the index over the last year.
year_highintegerscore from 0 to 100Highest value of the index over the last year.
year_low_atdate-timeISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z)Day of that lowest value, at midnight UTC.
year_high_atdate-timeISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z)Day of that highest value, at midnight UTC.
altcoin_market_cap_usdnumberUSDTotal market capitalisation of the altcoins (excluding BTC).
Try it

GET https://api.bytnode.com/v1/altcoin-season

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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).

ParameterTypeDefaultDescription
since_msinteger—Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range.
until_msinteger—Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next.
limitinteger · 1–1000100Number 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.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,value. Unknown field: 422 unknown_field with a suggestion.
before_msinteger—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).
orderstringdescReading 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 fields of the response
Field of dataTypeUnitDescription
[].timedate-timeISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z)The day the value refers to, at midnight UTC.
[].valueintegerscore from 0 to 100Altcoin 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_usdnumberUSDTotal market capitalisation of the altcoins (excluding BTC).
[].is_closedbooleantrue = 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.
Try it

GET https://api.bytnode.com/v1/altcoin-season/history?limit=3

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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).

ParameterTypeDefaultDescription
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,value. Unknown field: 422 unknown_field with a suggestion.
3 fields of the response
Field of dataTypeUnitDescription
timedate-timeISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z)The day the value refers to, at midnight UTC.
valueintegerscore from 0 to 100Crypto Fear & Greed Index (alternative.me). 0 = extreme fear, 100 = extreme greed.
labelstringLabel of the value, from alternative.me's scale: extreme_fear, fear, neutral, greed or extreme_greed (snake_case, like every label of the API).
Try it

GET https://api.bytnode.com/v1/fear-greed

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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.

ParameterTypeDefaultDescription
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,value. Unknown field: 422 unknown_field with a suggestion.
3 fields of the response
Field of dataTypeUnitDescription
timedate-timeISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z)Point-in-time value: the instant of the measurement (when the source was read).
valueintegerscore from 0 to 100CMC Crypto Fear & Greed Index (CoinMarketCap), a different index from /v1/fear-greed (alternative.me). 0 = extreme fear, 100 = extreme greed.
labelstringLabel of the value, from CoinMarketCap's scale: extreme_fear, fear, neutral, greed or extreme_greed (snake_case, like every label of the API).
Try it

GET https://api.bytnode.com/v1/fear-greed/cmc

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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).

ParameterTypeDefaultDescription
since_msinteger—Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range.
until_msinteger—Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next.
limitinteger · 1–1000100Number 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.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,value. Unknown field: 422 unknown_field with a suggestion.
before_msinteger—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).
orderstringdescReading 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 fields of the response
Field of dataTypeUnitDescription
[].timedate-timeISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z)The day the value refers to, at midnight UTC.
[].valueintegerscore from 0 to 100CMC Crypto Fear & Greed Index (CoinMarketCap), a different index from /v1/fear-greed (alternative.me). 0 = extreme fear, 100 = extreme greed.
[].labelstringLabel of the value, from CoinMarketCap's scale: extreme_fear, fear, neutral, greed or extreme_greed (snake_case, like every label of the API).
[].is_closedbooleantrue = 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.
Try it

GET https://api.bytnode.com/v1/fear-greed/cmc/history?limit=3

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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).

ParameterTypeDefaultDescription
since_msinteger—Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range.
until_msinteger—Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next.
limitinteger · 1–1000100Number 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.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,value. Unknown field: 422 unknown_field with a suggestion.
before_msinteger—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).
orderstringdescReading 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 fields of the response
Field of dataTypeUnitDescription
[].timedate-timeISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z)The day the value refers to, at midnight UTC.
[].valueintegerscore from 0 to 100Crypto Fear & Greed Index (alternative.me). 0 = extreme fear, 100 = extreme greed.
[].labelstringLabel 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_closedbooleantrue = 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.
Try it

GET https://api.bytnode.com/v1/fear-greed/history?limit=3

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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.

ParameterTypeDefaultDescription
fieldsstring—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 fields of the response
Field of dataTypeUnitDescription
timedate-timeISO 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_usdnumberUSDTotal crypto market capitalisation.
volume_total_usdnumberUSDTotal traded volume, USD.
btc_dominance_pctnumberpercent (58.5 = 58.5 %)Bitcoin share of the total market cap.
eth_dominance_pctnumberpercent (58.5 = 58.5 %)Ether share of the total market cap.
others_dominance_pctnumberpercent (58.5 = 58.5 %)Share of every other asset.
active_cryptocurrency_countintegercountNumber of tracked crypto assets.
Try it

GET https://api.bytnode.com/v1/global

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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).

ParameterTypeDefaultDescription
since_msinteger—Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range.
until_msinteger—Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next.
limitinteger · 1–1000100Number 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.
timeframestring—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.
fieldsstring—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_msinteger—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).
orderstringdescReading 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 fields of the response
Field of dataTypeUnitDescription
[].timedate-timeISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z)The instant the source states for each measurement.
[].market_cap_total_usdnumberUSDTotal crypto market capitalisation.
[].volume_total_usdnumberUSDTotal traded volume, USD.
[].btc_dominance_pctnumberpercent (58.5 = 58.5 %)Bitcoin share of the total market cap.
[].eth_dominance_pctnumberpercent (58.5 = 58.5 %)Ether share of the total market cap.
[].others_dominance_pctnumberpercent (58.5 = 58.5 %)Share of every other asset.
[].active_cryptocurrency_countintegercountNumber of tracked crypto assets.
[].is_closedbooleantrue = 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.
Try it

GET https://api.bytnode.com/v1/global/history?limit=3

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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.

ParameterTypeDefaultDescription
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,value. Unknown field: 422 unknown_field with a suggestion.
7 fields of the response
Field of dataTypeUnitDescription
timedate-timeISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z)Point-in-time value: the instant of the measurement (when the source was read).
valuenumberindex pointsCoinMarketCap 100 Index: the 100 largest crypto assets, weighted by market capitalisation.
constituentsobject[]The assets of the index, with their weight.
constituents[].namestringAsset name (Bitcoin).
constituents[].assetstringAsset symbol (BTC).
constituents[].weight_pctnumberpercent (58.5 = 58.5 %)Weight of the asset in the index (67.9 = 67.9 %).
change_24h_pctnumberpercent (58.5 = 58.5 %)Change of the index over the last 24 hours.
Try it

GET https://api.bytnode.com/v1/indices/cmc100

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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).

ParameterTypeDefaultDescription
since_msinteger—Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range.
until_msinteger—Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next.
limitinteger · 1–1000100Number 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.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,value. Unknown field: 422 unknown_field with a suggestion.
before_msinteger—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).
orderstringdescReading 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 fields of the response
Field of dataTypeUnitDescription
[].timedate-timeISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z)The day the value refers to, at midnight UTC.
[].valuenumberindex pointsCoinMarketCap 100 Index: the 100 largest crypto assets, weighted by market capitalisation.
[].is_closedbooleantrue = 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.
Try it

GET https://api.bytnode.com/v1/indices/cmc100/history?limit=3

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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.

ParameterTypeDefaultDescription
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,value. Unknown field: 422 unknown_field with a suggestion.
7 fields of the response
Field of dataTypeUnitDescription
timedate-timeISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z)Point-in-time value: the instant of the measurement (when the source was read).
valuenumberindex pointsCoinMarketCap 20 Index: the 20 largest crypto assets, weighted by market capitalisation.
constituentsobject[]The assets of the index, with their weight.
constituents[].namestringAsset name (Bitcoin).
constituents[].assetstringAsset symbol (BTC).
constituents[].weight_pctnumberpercent (58.5 = 58.5 %)Weight of the asset in the index (70.9 = 70.9 %).
change_24h_pctnumberpercent (58.5 = 58.5 %)Change of the index over the last 24 hours.
Try it

GET https://api.bytnode.com/v1/indices/cmc20

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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).

ParameterTypeDefaultDescription
since_msinteger—Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range.
until_msinteger—Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next.
limitinteger · 1–1000100Number 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.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,value. Unknown field: 422 unknown_field with a suggestion.
before_msinteger—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).
orderstringdescReading 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 fields of the response
Field of dataTypeUnitDescription
[].timedate-timeISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z)The day the value refers to, at midnight UTC.
[].valuenumberindex pointsCoinMarketCap 20 Index: the 20 largest crypto assets, weighted by market capitalisation.
[].is_closedbooleantrue = 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.
Try it

GET https://api.bytnode.com/v1/indices/cmc20/history?limit=3

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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).

ParameterTypeDefaultDescription
symbol requiredstring—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.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,circulating_supply. Unknown field: 422 unknown_field with a suggestion.
8 fields of the response
Field of dataTypeUnitDescription
timedate-timeISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z)Point-in-time value: the instant of the measurement (when the source was read).
circulating_supplynumber | nullcoinsCoins in circulation.
total_supplynumber | nullcoinsTotal coins issued (circulating + locked), net of burns.
max_supplynumber | nullcoinsHard cap on supply. null = no cap.
price_usdnumberUSDPrice 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_atdate-time | nullISO 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_usdnumber | nullUSDcirculating_supply × current price, in USD, derived at request time.
fdv_usdnumber | nullUSDFully diluted valuation: max_supply (or total_supply if uncapped) × price. null for stablecoins.
Try it

GET https://api.bytnode.com/v1/tokenomics?symbol=BTCUSDT

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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).

ParameterTypeDefaultDescription
since_msinteger—Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range.
until_msinteger—Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next.
limitinteger · 1–1000100Number 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 requiredstring—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.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,price_usd. Unknown field: 422 unknown_field with a suggestion.
before_msinteger—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).
orderstringdescReading 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 fields of the response
Field of dataTypeUnitDescription
[].timedate-timeISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z)The day the value refers to, at midnight UTC.
[].price_usdnumberUSDDaily closing price used for the derived values.
[].circulating_supplynumber | nullcoinsCoins in circulation.
[].total_supplynumber | nullcoinsTotal coins issued (circulating + locked), net of burns.
[].max_supplynumber | nullcoinsHard cap on supply. null = no cap.
[].market_cap_usdnumber | nullUSDcirculating_supply × current price, in USD, derived at request time.
[].fdv_usdnumber | nullUSDFully diluted valuation: max_supply (or total_supply if uncapped) × price. null for stablecoins.
[].is_closedbooleantrue = 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.
Try it

GET https://api.bytnode.com/v1/tokenomics/history?limit=3&symbol=BTCUSDT

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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.

ParameterTypeDefaultDescription
series requiredstring—FRED series id (e.g. DGS10). Required. The latest value of every series: GET /v1/macro/series.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,category. Unknown field: 422 unknown_field with a suggestion.
6 fields of the response
Field of dataTypeUnitDescription
timedate-timeISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z)The day of the observation, at midnight UTC.
categorystringSeries category.
namestringHuman-readable name of the series.
frequencystringPublication frequency of the source (daily, weekly, monthly).
unitsstringUnit of value as published by the source.
valuenumbersee `units`Latest value of the series, in the unit given by units.
Try it

GET https://api.bytnode.com/v1/macro?series=DGS10

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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.

ParameterTypeDefaultDescription
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,oldest_input_date. Unknown field: 422 unknown_field with a suggestion.
40 fields of the response
Field of dataTypeUnitDescription
timedate-timeISO 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_datedatecalendar 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.
methodstringHow the value is computed.
correlationsobjectPearson correlation from -1 to 1, per macro series and window, with sample_count = number of common days.
correlations.dxyobjectPearson correlation of daily returns against BTC over the last dxy, from -1 to 1.
correlations.dxy.30dobjectPearson correlation of daily returns against BTC over the last 30d, from -1 to 1.
correlations.dxy.30d.timedate-timeISO 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.correlationnumberfrom -1 to 1Pearson correlation of daily returns.
correlations.dxy.30d.sample_countinteger | nullcountNumber of days used.
correlations.dxy.90dobjectPearson correlation of daily returns against BTC over the last 90d, from -1 to 1.
correlations.dxy.90d.timedate-timeISO 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.correlationnumberfrom -1 to 1Pearson correlation of daily returns.
correlations.dxy.90d.sample_countinteger | nullcountNumber of days used.
correlations.sp500objectPearson correlation of daily returns against BTC over the last sp500, from -1 to 1.
correlations.sp500.30dobjectPearson correlation of daily returns against BTC over the last 30d, from -1 to 1.
correlations.sp500.30d.timedate-timeISO 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.correlationnumberfrom -1 to 1Pearson correlation of daily returns.
correlations.sp500.30d.sample_countinteger | nullcountNumber of days used.
correlations.sp500.90dobjectPearson correlation of daily returns against BTC over the last 90d, from -1 to 1.
correlations.sp500.90d.timedate-timeISO 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.correlationnumberfrom -1 to 1Pearson correlation of daily returns.
correlations.sp500.90d.sample_countinteger | nullcountNumber of days used.
correlations.goldobjectPearson correlation of daily returns against BTC over the last gold, from -1 to 1.
correlations.gold.30dobjectPearson correlation of daily returns against BTC over the last 30d, from -1 to 1.
correlations.gold.30d.timedate-timeISO 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.correlationnumberfrom -1 to 1Pearson correlation of daily returns.
correlations.gold.30d.sample_countinteger | nullcountNumber of days used.
correlations.gold.90dobjectPearson correlation of daily returns against BTC over the last 90d, from -1 to 1.
correlations.gold.90d.timedate-timeISO 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.correlationnumberfrom -1 to 1Pearson correlation of daily returns.
correlations.gold.90d.sample_countinteger | nullcountNumber of days used.
correlations.vixobjectPearson correlation of daily returns against BTC over the last vix, from -1 to 1.
correlations.vix.30dobjectPearson correlation of daily returns against BTC over the last 30d, from -1 to 1.
correlations.vix.30d.timedate-timeISO 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.correlationnumberfrom -1 to 1Pearson correlation of daily returns.
correlations.vix.30d.sample_countinteger | nullcountNumber of days used.
correlations.vix.90dobjectPearson correlation of daily returns against BTC over the last 90d, from -1 to 1.
correlations.vix.90d.timedate-timeISO 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.correlationnumberfrom -1 to 1Pearson correlation of daily returns.
correlations.vix.90d.sample_countinteger | nullcountNumber of days used.
Try it

GET https://api.bytnode.com/v1/macro/correlations

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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).

ParameterTypeDefaultDescription
since_msinteger—Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range.
until_msinteger—Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next.
limitinteger · 1–1000100Number 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 requiredstring—FRED series id, e.g. DGS10, CPIAUCSL, WALCL. The list: GET /v1/macro/series.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,value. Unknown field: 422 unknown_field with a suggestion.
before_msinteger—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).
orderstringdescReading 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 fields of the response
Field of dataTypeUnitDescription
[].timedate-timeISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z)The day of the observation, at midnight UTC.
[].valuenumbersee the series `units`Value of the series on the day of time.
[].is_closedbooleantrue = 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.
Try it

GET https://api.bytnode.com/v1/macro/history?limit=3&series=DGS10

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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).

ParameterTypeDefaultDescription
since_msinteger—Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range.
until_msinteger—Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next.
limitinteger · 1–1000100Number 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 requiredstring—The series returned by GET /v1/macro/intraday/series (e.g. PAXGUSDT), in any case. The instrument_code column is NOT accepted.
timeframe requiredstring—Candle size, required. Each series serves only the timeframes listed in its catalogue entry; others return 422 timeframe_not_served.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,open. Unknown field: 422 unknown_field with a suggestion.
before_msinteger—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).
orderstringdescReading 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 fields of the response
Field of dataTypeUnitDescription
[].timedate-timeISO 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.
[].opennumberseries unitOpen.
[].highnumberseries unitHigh.
[].lownumberseries unitLow.
[].closenumberseries unitClose.
[].volumenumber | nullsee `volume_kind`Volume reported by the source for this instrument (not the whole market).
[].is_closedbooleantrue = 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.
Try it

GET https://api.bytnode.com/v1/macro/intraday/history?limit=3&series=PAXGUSDT&timeframe=1h

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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.

ParameterTypeDefaultDescription
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=series,source. Unknown field: 422 unknown_field with a suggestion.
16 fields of the response
Field of dataTypeUnitDescription
[].seriesstringSeries identifier (the value of the series parameter).
[].sourcestringUpstream source.
[].instrument_codestringCode of the instrument at the source (informative; use series in requests).
[].categorystringSeries category.
[].namestringHuman-readable name of the series.
[].unitsstringUnit of value as published by the source.
[].volume_kindstringWhat volume measures for this instrument (broker = the source's own flow, not the whole market).
[].timeframesstring[]Timeframes natively collected for the series.
[].history_start_datedatecalendar date (YYYY-MM-DD)First day of available history.
[].last_candle_atobjectLast candle available, per timeframe.
[].last_candle_at.1mdate-timeStart of the latest 1m candle served for this series (ISO 8601 UTC).
[].last_candle_at.5mdate-timeStart of the latest 5m candle served for this series (ISO 8601 UTC).
[].last_candle_at.15mdate-timeStart of the latest 15m candle served for this series (ISO 8601 UTC).
[].last_candle_at.1hdate-timeStart of the latest 1h candle served for this series (ISO 8601 UTC).
[].last_candle_at.4hdate-timeStart of the latest 4h candle served for this series (ISO 8601 UTC).
[].last_candle_at.1ddate-timeStart of the latest 1d candle served for this series (ISO 8601 UTC).
Try it

GET https://api.bytnode.com/v1/macro/intraday/series

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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.

ParameterTypeDefaultDescription
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,oldest_input_date. Unknown field: 422 unknown_field with a suggestion.
17 fields of the response
Field of dataTypeUnitDescription
timedate-timeISO 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_datedatecalendar 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.
scalestringReading scale of the score.
30dobjectMomentum score over the last 30d, from -100 to +100.
30d.scorenumberscore from -100 to +100Macro momentum for crypto: positive = macro tailwind (weaker dollar, growing liquidity).
30d.componentsobject[]The inputs of the score and their contributions.
30d.components[].timedate-timeISO 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[].metricstringInput name.
30d.components[].change_pctnumberpercent (58.5 = 58.5 %)Relative change of the input over the window, percent.
30d.components[].contributionnumberdimensionless scoreContribution of the input to the score.
90dobjectMomentum score over the last 90d, from -100 to +100.
90d.scorenumberscore from -100 to +100Macro momentum for crypto: positive = macro tailwind (weaker dollar, growing liquidity).
90d.componentsobject[]The inputs of the score and their contributions.
90d.components[].timedate-timeISO 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[].metricstringInput name.
90d.components[].change_pctnumberpercent (58.5 = 58.5 %)Relative change of the input over the window, percent.
90d.components[].contributionnumberdimensionless scoreContribution of the input to the score.
Try it

GET https://api.bytnode.com/v1/macro/momentum

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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).

ParameterTypeDefaultDescription
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,net_liquidity_usd. Unknown field: 422 unknown_field with a suggestion.
7 fields of the response
Field of dataTypeUnitDescription
timedate-timeISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z)The day the value refers to, at midnight UTC.
net_liquidity_usdnumber | nullUSDFed balance sheet (WALCL) - Treasury General Account (TGA) - overnight reverse repo (ON RRP), in USD.
walcl_usdnumber | nullUSDFed total assets (WALCL), as known on that day.
tga_usdnumber | nullUSDTreasury General Account (WTREGEN), as known on that day.
rrp_usdnumberUSDOvernight reverse repo (RRPONTSYD) of that day.
walcl_datedatecalendar date (YYYY-MM-DD)Observation day of the WALCL value used (weekly series).
tga_datedatecalendar date (YYYY-MM-DD)Observation day of the TGA value used (weekly series).
Try it

GET https://api.bytnode.com/v1/macro/net-liquidity

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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).

ParameterTypeDefaultDescription
since_msinteger—Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range.
until_msinteger—Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next.
limitinteger · 1–1000100Number 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.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,net_liquidity_usd. Unknown field: 422 unknown_field with a suggestion.
before_msinteger—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).
orderstringdescReading 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 fields of the response
Field of dataTypeUnitDescription
[].timedate-timeISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z)The day the value refers to, at midnight UTC.
[].net_liquidity_usdnumber | nullUSDFed balance sheet (WALCL) - Treasury General Account (TGA) - overnight reverse repo (ON RRP), in USD.
[].walcl_usdnumber | nullUSDFed total assets (WALCL), as known on that day.
[].tga_usdnumber | nullUSDTreasury General Account (WTREGEN), as known on that day.
[].rrp_usdnumberUSDOvernight reverse repo (RRPONTSYD) of that day.
[].walcl_datedate | nullcalendar date (YYYY-MM-DD)Observation day of the WALCL value used (weekly series).
[].tga_datedate | nullcalendar date (YYYY-MM-DD)Observation day of the TGA value used (weekly series).
[].is_closedbooleantrue = 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.
Try it

GET https://api.bytnode.com/v1/macro/net-liquidity/history?limit=3

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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.

ParameterTypeDefaultDescription
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,oldest_input_date. Unknown field: 422 unknown_field with a suggestion.
37 fields of the response
Field of dataTypeUnitDescription
timedate-timeISO 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_datedatecalendar 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.
scorenumberscore from 0 to 100Share of risk-on signals × 100.
labelstringrisk_on (score above 50), risk_off (below 50) or neutral (exactly 50).
risk_on_signal_countintegercountSignals currently risk-on.
available_signal_countintegercountSignals that could be evaluated (data available).
signal_countintegercountSignals in the model.
signalsobjectEach signal: its condition and whether it is risk-on now (is_risk_on).
signals.vixobjectThe vix signal: its reading, and whether it counts as risk-on.
signals.vix.timedate-timeISO 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.conditionstringRule of the signal.
signals.vix.is_risk_onbooleanWhether the signal is risk-on now.
signals.dxyobjectThe dxy signal: its reading, and whether it counts as risk-on.
signals.dxy.timedate-timeISO 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.conditionstringRule of the signal.
signals.dxy.is_risk_onbooleanWhether the signal is risk-on now.
signals.yield_curveobjectThe yield_curve signal: its reading, and whether it counts as risk-on.
signals.yield_curve.timedate-timeISO 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.conditionstringRule of the signal.
signals.yield_curve.is_risk_onbooleanWhether the signal is risk-on now.
signals.sp500objectThe sp500 signal: its reading, and whether it counts as risk-on.
signals.sp500.timedate-timeISO 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.conditionstringRule of the signal.
signals.sp500.is_risk_onbooleanWhether the signal is risk-on now.
signals.goldobjectThe gold signal: its reading, and whether it counts as risk-on.
signals.gold.timedate-timeISO 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.conditionstringRule of the signal.
signals.gold.is_risk_onbooleanWhether the signal is risk-on now.
contextobjectThe raw inputs used by the signals.
context.vixnumberindex pointsCBOE Volatility Index.
context.dxynumberindex pointsUS Dollar Index.
context.dxy_7d_agonumberindex pointsUS Dollar Index seven days earlier.
context.yield_curve_10y2y_ppnumberpercentage points10-year minus 2-year US Treasury yield.
context.sp500numberindex pointsS&P 500.
context.sp500_sma_50dnumberindex points50-day simple moving average of the S&P 500.
context.gold_usdnumberUSD per troy ounceGold price.
context.gold_7d_ago_usdnumberUSD per troy ounceGold price seven days earlier.
Try it

GET https://api.bytnode.com/v1/macro/risk

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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.

ParameterTypeDefaultDescription
categorystring—Filter by category, e.g. rates, inflation, liquidity, commodities.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,series. Unknown field: 422 unknown_field with a suggestion.
7 fields of the response
Field of dataTypeUnitDescription
[].timedate-timeISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z)The day of the latest observation of the series, at midnight UTC.
[].seriesstringSeries identifier (the value of the series parameter).
[].categorystringSeries category.
[].namestringHuman-readable name of the series.
[].frequencystringPublication frequency of the source (daily, weekly, monthly).
[].unitsstringUnit of value as published by the source.
[].valuenumbersee `units`Latest value of the series, in the unit given by units.
Try it

GET https://api.bytnode.com/v1/macro/series

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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.

ParameterTypeDefaultDescription
asset requiredstring—Asset, e.g. BTC or ETH (no quote currency), in any case (eth works; the envelope gives the canonical form). Unknown: 422 invalid_asset.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,ticker. Unknown field: 422 unknown_field with a suggestion.
11 fields of the response
Field of dataTypeUnitDescription
[].timedate-timeISO 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.
[].tickerstringETF ticker.
[].issuerstringETF issuer.
[].shares_outstandingnumbersharesETF shares outstanding.
[].nav_per_share_usdnumberUSDNet asset value per share.
[].net_assets_usdnumberUSDNet assets (AUM).
[].formstringSEC form type of the filing (10-Q, 10-K...).
[].filed_datedatecalendar date (YYYY-MM-DD)Filing date at the SEC.
[].filing_urlstringLink to the filing on SEC EDGAR.
[].holdingsnumber | nullunits of the asset (BTC for asset=BTC, ETH for asset=ETH)Crypto held by the fund, in units of the asset.
[].is_holdings_estimatedbooleantrue if the holdings are derived from net assets / price rather than read in the filing.
Try it

GET https://api.bytnode.com/v1/etf/fundamentals?asset=BTC

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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).

ParameterTypeDefaultDescription
tickerstring—ETF ticker (e.g. IBIT, FBTC). Omit for every issuer.
since_msinteger—Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range.
until_msinteger—Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next.
limitinteger · 1–1000100Number 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 requiredstring—Asset, e.g. BTC or ETH (no quote currency), in any case (eth works; the envelope gives the canonical form). Unknown: 422 invalid_asset.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,ticker. Unknown field: 422 unknown_field with a suggestion.
before_msinteger—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).
orderstringdescReading 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 fields of the response
Field of dataTypeUnitDescription
[].timedate-timeISO 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.
[].tickerstringETF ticker.
[].issuerstringETF issuer.
[].shares_outstandingnumbersharesETF shares outstanding.
[].nav_per_share_usdnumberUSDNet asset value per share.
[].net_assets_usdnumberUSDNet assets (AUM).
[].formstringSEC form type of the filing (10-Q, 10-K...).
[].filed_datedatecalendar date (YYYY-MM-DD)Filing date at the SEC.
[].filing_urlstringLink to the filing on SEC EDGAR.
[].holdingsnumber | nullunits of the asset (BTC for asset=BTC, ETH for asset=ETH)Crypto held by the fund, in units of the asset.
[].is_holdings_estimatedboolean | nulltrue if the holdings are derived from net assets / price rather than read in the filing.
[].is_closedbooleantrue = 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.
Try it

GET https://api.bytnode.com/v1/etf/fundamentals/history?limit=3&asset=BTC

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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.

ParameterTypeDefaultDescription
asset requiredstring—Asset, e.g. BTC or ETH (no quote currency), in any case (eth works; the envelope gives the canonical form). Unknown: 422 invalid_asset.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,expiry_at. Unknown field: 422 unknown_field with a suggestion.
11 fields of the response
Field of dataTypeUnitDescription
[].timedate-timeISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z)Point-in-time value: the instant of the options snapshot (all venues read together).
[].expiry_atdate-timeISO 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_snumbersecondsTime left before expiry, in seconds.
[].oi_call_usdnumber | nullUSDCall open interest, USD.
[].oi_put_usdnumber | nullUSDPut open interest, USD.
[].put_call_rationumberputs / callsPut/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_usdnumberUSDStrike at which option holders lose the most at expiry (max pain).
[].top_call_strike_usdnumberUSDStrike with the largest call open interest.
[].top_put_strike_usdnumberUSDStrike with the largest put open interest.
[].iv_atm_pctnumberpercent (58.5 = 58.5 %)At-the-money implied volatility of THIS expiry, annualised, in percent (55.2 = 55.2 %).
[].put_call_labelstringbullish (put_call_ratio < 0.7), neutral, or bearish (put_call_ratio > 1).
Try it

GET https://api.bytnode.com/v1/options/expiry?asset=BTC

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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.

ParameterTypeDefaultDescription
asset requiredstring—Asset, e.g. BTC or ETH (no quote currency), in any case (eth works; the envelope gives the canonical form). Unknown: 422 invalid_asset.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,delta. Unknown field: 422 unknown_field with a suggestion.
7 fields of the response
Field of dataTypeUnitDescription
timedate-timeISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z)Point-in-time value: the instant of the options snapshot (all venues read together).
deltanumberdeltaAggregated delta of open options, OI-weighted (per unit of underlying).
gammanumberdelta per USDChange of delta for a 1 USD move of the underlying, OI-weighted.
thetanumberUSD per dayTime decay per day, OI-weighted.
veganumberUSD per volatility pointValue change for +1 point of implied volatility, OI-weighted.
coverageobjectoi_coverage_ratio: share of the open interest covered by the venues that answered (1.0 = all).
coverage.oi_coverage_rationumberfraction (0.585 = 58.5 %)Share of the open interest covered by the contributing venues.
Try it

GET https://api.bytnode.com/v1/options/greeks?asset=BTC

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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.

ParameterTypeDefaultDescription
asset requiredstring—Asset, e.g. BTC or ETH (no quote currency), in any case (eth works; the envelope gives the canonical form). Unknown: 422 invalid_asset.
fieldsstring—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 fields of the response
Field of dataTypeUnitDescription
timedate-timeISO 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_pctnumberpercent (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.
Try it

GET https://api.bytnode.com/v1/options/iv?asset=BTC

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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.

ParameterTypeDefaultDescription
timeframe requiredstring—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 requiredstring—Asset, e.g. BTC or ETH (no quote currency), in any case (eth works; the envelope gives the canonical form). Unknown: 422 invalid_asset.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,open_pct. Unknown field: 422 unknown_field with a suggestion.
6 fields of the response
Field of dataTypeUnitDescription
timedate-timeISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z)Start of the latest CLOSED bucket; the candle summarises its options snapshots.
open_pctnumberpercent (58.5 = 58.5 %)30-day ATM IV at the start of the bucket.
high_pctnumberpercent (58.5 = 58.5 %)Highest 30-day ATM IV.
low_pctnumberpercent (58.5 = 58.5 %)Lowest 30-day ATM IV.
close_pctnumberpercent (58.5 = 58.5 %)30-day ATM IV at the end of the bucket.
is_closedbooleantrue = 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.
Try it

GET https://api.bytnode.com/v1/options/iv/klines?timeframe=1h&asset=BTC

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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).

ParameterTypeDefaultDescription
timeframe requiredstring—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_msinteger—Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range.
until_msinteger—Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next.
limitinteger · 1–1000100Number 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 requiredstring—Asset, e.g. BTC or ETH (no quote currency), in any case (eth works; the envelope gives the canonical form). Unknown: 422 invalid_asset.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,open_pct. Unknown field: 422 unknown_field with a suggestion.
before_msinteger—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).
orderstringdescReading 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 fields of the response
Field of dataTypeUnitDescription
[].timedate-timeISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z)Start of the bucket; the value is the LAST options snapshot of the bucket.
[].open_pctnumberpercent (58.5 = 58.5 %)30-day ATM IV at the start of the bucket.
[].high_pctnumberpercent (58.5 = 58.5 %)Highest 30-day ATM IV.
[].low_pctnumberpercent (58.5 = 58.5 %)Lowest 30-day ATM IV.
[].close_pctnumberpercent (58.5 = 58.5 %)30-day ATM IV at the end of the bucket.
[].is_closedbooleantrue = 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.
Try it

GET https://api.bytnode.com/v1/options/iv/klines/history?timeframe=1h&limit=3&asset=BTC

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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.

ParameterTypeDefaultDescription
asset requiredstring—Asset, e.g. BTC or ETH (no quote currency), in any case (eth works; the envelope gives the canonical form). Unknown: 422 invalid_asset.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,expiry_at. Unknown field: 422 unknown_field with a suggestion.
7 fields of the response
Field of dataTypeUnitDescription
[].timedate-timeISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z)Point-in-time value: the instant of the options snapshot (all venues read together).
[].expiry_atdate-timeISO 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_snumbersecondsTime left before expiry, in seconds.
[].max_pain_strike_usdnumberUSDStrike at which option holders lose the most at expiry (max pain).
[].put_call_rationumberputs / callsPut/call open interest ratio (a quotient, not a share: 1.2 = 1.2 puts per call). Below 1 = more calls than puts.
[].oi_call_usdnumber | nullUSDCall open interest, USD.
[].oi_put_usdnumber | nullUSDPut open interest, USD.
Try it

GET https://api.bytnode.com/v1/options/max-pain?asset=BTC

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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).

ParameterTypeDefaultDescription
expiry requiredstring—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_msinteger—Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range.
until_msinteger—Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next.
limitinteger · 1–1000100Number 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 requiredstring—Asset, e.g. BTC or ETH (no quote currency), in any case (eth works; the envelope gives the canonical form). Unknown: 422 invalid_asset.
fieldsstring—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_msinteger—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).
orderstringdescReading 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 fields of the response
Field of dataTypeUnitDescription
[].timedate-timeISO 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_usdnumberUSDStrike at which option holders lose the most at expiry (max pain).
[].put_call_rationumberputs / callsPut/call open interest ratio (a quotient, not a share: 1.2 = 1.2 puts per call). Below 1 = more calls than puts.
[].is_closedbooleantrue = 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.
Try it

GET https://api.bytnode.com/v1/options/max-pain/history?expiry=2026-11-09&limit=3&asset=BTC

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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.

ParameterTypeDefaultDescription
asset requiredstring—Asset, e.g. BTC or ETH (no quote currency), in any case (eth works; the envelope gives the canonical form). Unknown: 422 invalid_asset.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,oi_total_usd. Unknown field: 422 unknown_field with a suggestion.
8 fields of the response
Field of dataTypeUnitDescription
timedate-timeISO 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_usdnumberUSDTotal open interest, USD.
oi_call_usdnumber | nullUSDCall open interest, USD.
oi_put_usdnumber | nullUSDPut open interest, USD.
oi_callnumberbase asset quantity (BTC for BTCUSDT)Call open interest, in coins (base asset).
oi_putnumberbase asset quantity (BTC for BTCUSDT)Put open interest, in coins (base asset).
coverageobjectoi_coverage_ratio: share of the open interest covered by the venues that answered (1.0 = all).
coverage.oi_coverage_rationumberfraction (0.585 = 58.5 %)Share of the open interest covered by the contributing venues.
Try it

GET https://api.bytnode.com/v1/options/oi?asset=BTC

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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.

ParameterTypeDefaultDescription
timeframe requiredstring—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 requiredstring—Asset, e.g. BTC or ETH (no quote currency), in any case (eth works; the envelope gives the canonical form). Unknown: 422 invalid_asset.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,window_start_at. Unknown field: 422 unknown_field with a suggestion.
6 fields of the response
Field of dataTypeUnitDescription
timedate-timeISO 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_atdate-timeISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z)Instant of the reference snapshot: the latest one at least timeframe before time.
window_sinteger | nullsecondsActual distance between the two snapshots, in whole seconds (timeframe or a little more: snapshots arrive every minute).
oi_change_call_usdnumber | nullUSDChange of call open interest from window_start_at to time, USD.
oi_change_put_usdnumber | nullUSDChange of put open interest from window_start_at to time, USD.
oi_change_total_usdnumber | nullUSDChange of total open interest from window_start_at to time, USD.
Try it

GET https://api.bytnode.com/v1/options/oi/change?timeframe=1h&asset=BTC

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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).

ParameterTypeDefaultDescription
timeframe requiredstring—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_msinteger—Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range.
until_msinteger—Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next.
limitinteger · 1–1000100Number 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 requiredstring—Asset, e.g. BTC or ETH (no quote currency), in any case (eth works; the envelope gives the canonical form). Unknown: 422 invalid_asset.
fieldsstring—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_msinteger—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).
orderstringdescReading 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 fields of the response
Field of dataTypeUnitDescription
[].timedate-timeISO 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_usdnumber | nullUSDChange of call open interest from window_start_at to time, USD.
[].oi_change_put_usdnumber | nullUSDChange of put open interest from window_start_at to time, USD.
[].oi_change_total_usdnumber | nullUSDChange of total open interest from window_start_at to time, USD.
[].is_closedbooleantrue = 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.
Try it

GET https://api.bytnode.com/v1/options/oi/change/history?timeframe=1h&limit=3&asset=BTC

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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.

ParameterTypeDefaultDescription
expirystring—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 requiredstring—Asset, e.g. BTC or ETH (no quote currency), in any case (eth works; the envelope gives the canonical form). Unknown: 422 invalid_asset.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,expiry_at. Unknown field: 422 unknown_field with a suggestion.
5 fields of the response
Field of dataTypeUnitDescription
[].timedate-timeISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z)Point-in-time value: the instant of the options snapshot (all venues read together).
[].expiry_atdate-timeISO 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_usdnumberUSDStrike price.
[].oi_call_usdnumber | nullUSDCall open interest at this strike, USD. null = no call listed.
[].oi_put_usdnumber | nullUSDPut open interest at this strike, USD. null = no put listed.
Try it

GET https://api.bytnode.com/v1/options/oi/distribution?asset=BTC

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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).

ParameterTypeDefaultDescription
timeframe requiredstring—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_msinteger—Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range.
until_msinteger—Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next.
limitinteger · 1–1000100Number 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 requiredstring—Asset, e.g. BTC or ETH (no quote currency), in any case (eth works; the envelope gives the canonical form). Unknown: 422 invalid_asset.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,oi_total_usd. Unknown field: 422 unknown_field with a suggestion.
before_msinteger—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).
orderstringdescReading 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 fields of the response
Field of dataTypeUnitDescription
[].timedate-timeISO 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_usdnumberUSDTotal open interest, USD.
[].oi_call_usdnumber | nullUSDCall open interest, USD.
[].oi_put_usdnumber | nullUSDPut open interest, USD.
[].oi_callnumberbase asset quantity (BTC for BTCUSDT)Call open interest, in coins (base asset).
[].oi_putnumberbase asset quantity (BTC for BTCUSDT)Put open interest, in coins (base asset).
[].is_closedbooleantrue = 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.
Try it

GET https://api.bytnode.com/v1/options/oi/history?timeframe=1h&limit=3&asset=BTC

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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).

ParameterTypeDefaultDescription
asset requiredstring—Asset, e.g. BTC or ETH (no quote currency), in any case (eth works; the envelope gives the canonical form). Unknown: 422 invalid_asset.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,put_call_ratio. Unknown field: 422 unknown_field with a suggestion.
3 fields of the response
Field of dataTypeUnitDescription
timedate-timeISO 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_rationumberputs / callsPut/call open interest ratio (a quotient, not a share: 1.2 = 1.2 puts per call). Below 1 = more calls than puts.
put_call_labelstringbullish (put_call_ratio < 0.7), neutral, or bearish (put_call_ratio > 1).
Try it

GET https://api.bytnode.com/v1/options/put-call-ratio?asset=BTC

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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).

ParameterTypeDefaultDescription
timeframe requiredstring—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_msinteger—Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range.
until_msinteger—Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next.
limitinteger · 1–1000100Number 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 requiredstring—Asset, e.g. BTC or ETH (no quote currency), in any case (eth works; the envelope gives the canonical form). Unknown: 422 invalid_asset.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,put_call_ratio. Unknown field: 422 unknown_field with a suggestion.
before_msinteger—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).
orderstringdescReading 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 fields of the response
Field of dataTypeUnitDescription
[].timedate-timeISO 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_rationumberputs / callsPut/call open interest ratio (a quotient, not a share: 1.2 = 1.2 puts per call). Below 1 = more calls than puts.
[].put_call_labelstringbullish (put_call_ratio < 0.7), neutral, or bearish (put_call_ratio > 1).
[].is_closedbooleantrue = 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.
Try it

GET https://api.bytnode.com/v1/options/put-call-ratio/history?timeframe=1h&limit=3&asset=BTC

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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.

ParameterTypeDefaultDescription
asset requiredstring—Asset, e.g. BTC or ETH (no quote currency), in any case (eth works; the envelope gives the canonical form). Unknown: 422 invalid_asset.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,underlying_price_usd. Unknown field: 422 unknown_field with a suggestion.
19 fields of the response
Field of dataTypeUnitDescription
timedate-timeISO 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_usdnumberUSDIndex (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_usdnumberUSDTotal open interest, USD.
oi_call_usdnumber | nullUSDCall open interest, USD.
oi_put_usdnumber | nullUSDPut open interest, USD.
volume_total_usdnumberUSDTotal traded volume, USD.
volume_call_usdnumberUSDCall volume, USD.
volume_put_usdnumberUSDPut volume, USD.
put_call_rationumberputs / callsPut/call open interest ratio (a quotient, not a share: 1.2 = 1.2 puts per call). Below 1 = more calls than puts.
put_call_labelstringbullish (put_call_ratio < 0.7), neutral, or bearish (put_call_ratio > 1).
iv_atm_30d_pctnumberpercent (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_expiryobjectThe next expiry: its instant, the time left, max pain, put/call ratio, ATM IV.
nearest_expiry.expiry_atdate-timeISO 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_snumbersecondsTime left before expiry, in seconds.
nearest_expiry.max_pain_strike_usdnumberUSDStrike at which option holders lose the most at expiry (max pain).
nearest_expiry.put_call_rationumberputs / callsPut/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_pctnumberpercent (58.5 = 58.5 %)At-the-money implied volatility of THIS expiry, annualised, in percent (55.2 = 55.2 %).
coverageobjectoi_coverage_ratio: share of the open interest covered by the venues that answered (1.0 = all).
coverage.oi_coverage_rationumberfraction (0.585 = 58.5 %)Share of the open interest covered by the contributing venues.
Try it

GET https://api.bytnode.com/v1/options/summary?asset=BTC

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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.

ParameterTypeDefaultDescription
asset requiredstring—Asset, e.g. BTC or ETH (no quote currency), in any case (eth works; the envelope gives the canonical form). Unknown: 422 invalid_asset.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,volume_total_usd. Unknown field: 422 unknown_field with a suggestion.
6 fields of the response
Field of dataTypeUnitDescription
timedate-timeISO 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_usdnumberUSDTotal traded volume, USD.
volume_call_usdnumberUSDCall volume, USD.
volume_put_usdnumberUSDPut volume, USD.
coverageobjectoi_coverage_ratio: share of the open interest covered by the venues that answered (1.0 = all).
coverage.oi_coverage_rationumberfraction (0.585 = 58.5 %)Share of the open interest covered by the contributing venues.
Try it

GET https://api.bytnode.com/v1/options/volume?asset=BTC

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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).

ParameterTypeDefaultDescription
timeframe requiredstring—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_msinteger—Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range.
until_msinteger—Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next.
limitinteger · 1–1000100Number 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 requiredstring—Asset, e.g. BTC or ETH (no quote currency), in any case (eth works; the envelope gives the canonical form). Unknown: 422 invalid_asset.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,volume_total_usd. Unknown field: 422 unknown_field with a suggestion.
before_msinteger—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).
orderstringdescReading 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 fields of the response
Field of dataTypeUnitDescription
[].timedate-timeISO 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_usdnumberUSDTotal traded volume, USD.
[].volume_call_usdnumberUSDCall volume, USD.
[].volume_put_usdnumberUSDPut volume, USD.
[].is_closedbooleantrue = 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.
Try it

GET https://api.bytnode.com/v1/options/volume/history?timeframe=1h&limit=3&asset=BTC

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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).

ParameterTypeDefaultDescription
fieldsstring—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 fields of the response
Field of dataTypeUnitDescription
timedate-timeISO 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_vbintegersatoshis per virtual byte (sat/vB)Fee rate for the next block.
half_hour_fee_sat_vbintegersatoshis per virtual byte (sat/vB)Fee rate for confirmation within ~30 minutes.
hour_fee_sat_vbintegersatoshis per virtual byte (sat/vB)Fee rate for confirmation within ~1 hour.
economy_fee_sat_vbintegersatoshis per virtual byte (sat/vB)Fee rate for a low-priority confirmation.
minimum_fee_sat_vbintegersatoshis per virtual byte (sat/vB)Minimum relay fee rate.
fastest_fee_precise_sat_vbnumbersatoshis per virtual byte (sat/vB)fastest_fee_sat_vb, unrounded.
half_hour_fee_precise_sat_vbnumbersatoshis per virtual byte (sat/vB)half_hour_fee_sat_vb, unrounded.
hour_fee_precise_sat_vbnumbersatoshis per virtual byte (sat/vB)hour_fee_sat_vb, unrounded.
economy_fee_precise_sat_vbnumbersatoshis per virtual byte (sat/vB)economy_fee_sat_vb, unrounded.
minimum_fee_precise_sat_vbnumbersatoshis per virtual byte (sat/vB)minimum_fee_sat_vb, unrounded.
fee_pressureobjectfastest_economy_ratio = fastest / economy fee rate, and its label: normal (<= 2), elevated (> 2), congested (> 5).
fee_pressure.fastest_economy_rationumberfastest / economyFastest fee rate divided by the economy fee rate (a quotient).
fee_pressure.labelstringFee pressure: normal (ratio <= 2), elevated (> 2) or congested (> 5).
Try it

GET https://api.bytnode.com/v1/btc/fees

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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).

ParameterTypeDefaultDescription
since_msinteger—Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range.
until_msinteger—Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next.
limitinteger · 1–1000100Number 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.
timeframestring—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.
fieldsstring—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_msinteger—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).
orderstringdescReading 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 fields of the response
Field of dataTypeUnitDescription
[].timedate-timeISO 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_vbintegersatoshis per virtual byte (sat/vB)Fee rate for the next block.
[].half_hour_fee_sat_vbintegersatoshis per virtual byte (sat/vB)Fee rate for confirmation within ~30 minutes.
[].hour_fee_sat_vbintegersatoshis per virtual byte (sat/vB)Fee rate for confirmation within ~1 hour.
[].economy_fee_sat_vbintegersatoshis per virtual byte (sat/vB)Fee rate for a low-priority confirmation.
[].minimum_fee_sat_vbintegersatoshis per virtual byte (sat/vB)Minimum relay fee rate.
[].is_closedbooleantrue = 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.
Try it

GET https://api.bytnode.com/v1/btc/fees/history?limit=3

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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.

ParameterTypeDefaultDescription
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,tx_count. Unknown field: 422 unknown_field with a suggestion.
10 fields of the response
Field of dataTypeUnitDescription
timedate-timeISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z)Point-in-time value: the instant of the measurement (when the source was read).
tx_countintegercountUnconfirmed transactions in the mempool.
vsizeintegervirtual bytesTotal virtual size of the mempool.
total_fee_satsintegersatoshisTotal fees waiting in the mempool.
fee_histogramnumber[][][fee_rate, vsize] pairs: how much virtual size (virtual bytes) waits at each fee rate (sat/vB).
trendobjectMempool size change over 1 h, 4 h and 24 h, and its label (filling, draining, stable).
trend.vsize_change_1hintegervirtual bytesMempool size change over 1 hour.
trend.vsize_change_4hintegervirtual bytesMempool size change over 4 hours.
trend.vsize_change_24hintegervirtual bytesMempool size change over 24 hours.
trend.labelstringfilling (vsize grew over 1 h), draining (shrank) or stable.
Try it

GET https://api.bytnode.com/v1/btc/mempool

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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).

ParameterTypeDefaultDescription
since_msinteger—Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range.
until_msinteger—Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next.
limitinteger · 1–1000100Number 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.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,tx_count. Unknown field: 422 unknown_field with a suggestion.
before_msinteger—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).
orderstringdescReading 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 fields of the response
Field of dataTypeUnitDescription
[].timedate-timeISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z)Point-in-time value: the instant of the measurement (when the source was read).
[].tx_countintegercountUnconfirmed transactions in the mempool.
[].vsizeintegervirtual bytesTotal virtual size of the mempool.
[].total_fee_satsintegersatoshisTotal fees waiting in the mempool.
[].is_closedbooleantrue = 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.
Try it

GET https://api.bytnode.com/v1/btc/mempool/history?limit=3

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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).

ParameterTypeDefaultDescription
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time. Unknown field: 422 unknown_field with a suggestion.
19 fields of the response
Field of dataTypeUnitDescription
timedate-timeISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z)Point-in-time value: the instant of the measurement (when the source was read).
concentrationobjectMining pool concentration over the last period.
concentration.total_block_countintegercountBlocks in the period.
concentration.top1_share_pctnumberpercent (58.5 = 58.5 %)Share of blocks mined by the largest pool.
concentration.top3_share_pctnumberpercent (58.5 = 58.5 %)Share of blocks mined by the three largest pools.
concentration.pool_countintegercountNumber of pools that mined at least one block.
concentration.labelstringCentralisation risk from the top-3 pool share: healthy (<= 40 %), moderate (> 40 %), high_risk (> 50 %).
latest_rewardobjectAverage block reward (subsidy + fees) of the latest blocks, in satoshis and USD.
latest_reward.timedate-timeISO 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_heightintegerblock heightHeight 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_satsintegersatoshisAverage block reward.
latest_reward.avg_reward_usdnumberUSDAverage block reward in USD.
latest_reward.btc_price_usdnumberUSDBTC 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).
poolsobject[]Pools ranked by blocks mined: name, slug, block_count, rank, share_pct.
pools[].namestringHuman-readable name.
pools[].slugstringStable identifier.
pools[].block_countintegercountBlocks mined over the period.
pools[].rankintegerrank (1 = first)Rank.
pools[].share_pctnumberpercent (58.5 = 58.5 %)Share of blocks.
Try it

GET https://api.bytnode.com/v1/btc/mining

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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).

ParameterTypeDefaultDescription
datasetstringconcentrationWhich mining series to return: concentration (pool shares), rewards (block rewards), difficulty or fee_rates.
since_msinteger—Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range.
until_msinteger—Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next.
limitinteger · 1–1000100Number 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.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,total_block_count. Unknown field: 422 unknown_field with a suggestion.
before_msinteger—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).
orderstringdescReading 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 fields of the response
Field of dataTypeUnitDescription
[].timedate-timeISO 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_countintegercountBlocks in the period.
[].top1_share_pctnumberpercent (58.5 = 58.5 %)Share of blocks mined by the largest pool.
[].top3_share_pctnumberpercent (58.5 = 58.5 %)Share of blocks mined by the three largest pools.
[].pool_countintegercountNumber of pools that mined at least one block.
[].labelstringCentralisation risk from the top-3 pool share: healthy (<= 40 %), moderate (> 40 %), high_risk (> 50 %).
[].is_closedbooleantrue = 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_heightinteger | nullblock heightHeight 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_satsinteger | nullsatoshisAverage block reward.
[].avg_reward_usdnumber | nullUSDAverage block reward in USD.
[].btc_price_usdnumber | nullUSDBTC 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).
[].difficultynumber | nulldifficulty unitsNetwork mining difficulty (on a difficulty-adjustment row, the difficulty after it).
[].previous_difficultynumber | nulldifficulty unitsDifficulty before the adjustment.
[].difficulty_change_pctnumber | nullpercent (58.5 = 58.5 %)Expected difficulty change at the next adjustment (/v1/btc/mining/history?dataset=difficulty: the change applied at that adjustment).
[].adjustment_multipliernumber | nulldimensionless ratiodifficulty / previous_difficulty (1.05 = a 5 % rise).
[].fee_rate_p0_sat_vbinteger | nullsatoshis per virtual byte (sat/vB)Lowest fee rate paid in the blocks (0th percentile).
[].fee_rate_p10_sat_vbinteger | nullsatoshis per virtual byte (sat/vB)10th percentile of the fee rates paid in the blocks.
[].fee_rate_p25_sat_vbinteger | nullsatoshis per virtual byte (sat/vB)25th percentile of the fee rates paid in the blocks.
[].fee_rate_p50_sat_vbinteger | nullsatoshis per virtual byte (sat/vB)Median fee rate paid in the blocks.
[].fee_rate_p75_sat_vbinteger | nullsatoshis per virtual byte (sat/vB)75th percentile of the fee rates paid in the blocks.
[].fee_rate_p90_sat_vbinteger | nullsatoshis per virtual byte (sat/vB)90th percentile of the fee rates paid in the blocks.
[].fee_rate_p100_sat_vbinteger | nullsatoshis per virtual byte (sat/vB)Highest fee rate paid in the blocks.
Try it

GET https://api.bytnode.com/v1/btc/mining/history?dataset=concentration&limit=3

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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.

ParameterTypeDefaultDescription
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,difficulty. Unknown field: 422 unknown_field with a suggestion.
14 fields of the response
Field of dataTypeUnitDescription
timedate-timeISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z)Point-in-time value: the instant of the measurement (when the source was read).
difficultynumber | nulldifficulty unitsNetwork mining difficulty (on a difficulty-adjustment row, the difficulty after it).
block_heightintegerblock heightHeight 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_pctnumberpercent (58.5 = 58.5 %)Progress through the current 2016-block difficulty period.
difficulty_change_pctnumberpercent (58.5 = 58.5 %)Expected difficulty change at the next adjustment (/v1/btc/mining/history?dataset=difficulty: the change applied at that adjustment).
block_timeobjectAverage block time over 24 h (avg_24h_s), its deviation from the 600 s target, and a label.
block_time.avg_24h_snumbersecondsAverage block time over 24 hours.
block_time.deviation_snumbersecondsavg_24h_s - 600.
block_time.labelstring24 h block time versus the 600 s target: slow (> +30 s), fast (< -30 s) or on_target.
next_adjustmentobjectNext difficulty adjustment: progress, expected change, date, remaining blocks and time.
next_adjustment.estimated_retarget_atdate-timeISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z)Estimated instant of the next adjustment.
next_adjustment.remaining_block_countintegercountBlocks left before the adjustment.
next_adjustment.next_retarget_block_heightintegerblock heightHeight of the block of the next adjustment.
next_adjustment.remaining_snumbersecondsEstimated time left before the adjustment, seconds.
Try it

GET https://api.bytnode.com/v1/btc/network

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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).

ParameterTypeDefaultDescription
since_msinteger—Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range.
until_msinteger—Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next.
limitinteger · 1–1000100Number 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.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,difficulty. Unknown field: 422 unknown_field with a suggestion.
before_msinteger—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).
orderstringdescReading 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 fields of the response
Field of dataTypeUnitDescription
[].timedate-timeISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z)Point-in-time value: the instant of the measurement (when the source was read).
[].difficultynumber | nulldifficulty unitsNetwork mining difficulty (on a difficulty-adjustment row, the difficulty after it).
[].block_heightintegerblock heightHeight 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_pctnumberpercent (58.5 = 58.5 %)Progress through the current 2016-block difficulty period.
[].difficulty_change_pctnumberpercent (58.5 = 58.5 %)Expected difficulty change at the next adjustment (/v1/btc/mining/history?dataset=difficulty: the change applied at that adjustment).
[].is_closedbooleantrue = 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.
Try it

GET https://api.bytnode.com/v1/btc/network/history?limit=3

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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.

ParameterTypeDefaultDescription
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,tvl_usd. Unknown field: 422 unknown_field with a suggestion.
8 fields of the response
Field of dataTypeUnitDescription
timedate-timeISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z)Point-in-time value: the instant of the measurement (when the source was read).
tvl_usdnumberUSDTotal value locked in Ethereum DeFi.
dex_volume_24h_usdnumber | nullUSDDEX volume over 24 h.
dex_volume_7d_usdnumber | nullUSDDEX volume over 7 days.
eth_market_cap_usdnumberUSDETH market capitalisation.
defi_health_rationumberfraction (0.585 = 58.5 %)tvl_usd / eth_market_cap_usd.
defi_health_change_30d_pctnumber | nullpercent (58.5 = 58.5 %)Relative change of defi_health_ratio (TVL / ETH market cap) over 30 days, percent.
labelstring30-day trend of defi_health_ratio (TVL / ETH market cap): growing, declining or stable.
Try it

GET https://api.bytnode.com/v1/eth/defi

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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).

ParameterTypeDefaultDescription
since_msinteger—Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range.
until_msinteger—Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next.
limitinteger · 1–1000100Number 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.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,tvl_usd. Unknown field: 422 unknown_field with a suggestion.
before_msinteger—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).
orderstringdescReading 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 fields of the response
Field of dataTypeUnitDescription
[].timedate-timeISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z)The day, at midnight UTC; the value is the LAST measurement of that day.
[].tvl_usdnumberUSDTotal value locked in Ethereum DeFi.
[].dex_volume_24h_usdnumber | nullUSDDEX volume over 24 h.
[].dex_volume_7d_usdnumber | nullUSDDEX volume over 7 days.
[].eth_market_cap_usdnumberUSDETH market capitalisation.
[].defi_health_rationumberfraction (0.585 = 58.5 %)tvl_usd / eth_market_cap_usd.
[].defi_health_change_30d_pctnumber | nullpercent (58.5 = 58.5 %)Relative change of defi_health_ratio (TVL / ETH market cap) over 30 days, percent.
[].labelstring | null30-day trend of defi_health_ratio (TVL / ETH market cap): growing, declining or stable.
[].is_closedbooleantrue = 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.
Try it

GET https://api.bytnode.com/v1/eth/defi/history?limit=3

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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.

ParameterTypeDefaultDescription
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,burn_24h. Unknown field: 422 unknown_field with a suggestion.
5 fields of the response
Field of dataTypeUnitDescription
timedate-timeISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z)Point-in-time value: the instant of the measurement (when the source was read).
burn_24hnumber | nullETHETH burnt over the last 24 h.
net_issuance_24hnumber | nullETHNew ETH issued minus ETH burnt over 24 h. Negative = deflationary.
net_issuance_annualized_pctnumber | nullpercent (58.5 = 58.5 %)Net issuance annualised, as a percent of supply. Negative = the supply shrinks.
labelstringdeflationary (24 h net issuance < 0) or inflationary.
Try it

GET https://api.bytnode.com/v1/eth/deflation

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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).

ParameterTypeDefaultDescription
since_msinteger—Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range.
until_msinteger—Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next.
limitinteger · 1–1000100Number 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.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,burn_24h. Unknown field: 422 unknown_field with a suggestion.
before_msinteger—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).
orderstringdescReading 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 fields of the response
Field of dataTypeUnitDescription
[].timedate-timeISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z)The day, at midnight UTC; the value is the LAST measurement of that day.
[].burn_24hnumber | nullETHETH burnt over the last 24 h.
[].net_issuance_24hnumber | nullETHNew ETH issued minus ETH burnt over 24 h. Negative = deflationary.
[].net_issuance_annualized_pctnumber | nullpercent (58.5 = 58.5 %)Net issuance annualised, as a percent of supply. Negative = the supply shrinks.
[].labelstring | nulldeflationary (24 h net issuance < 0) or inflationary.
[].is_closedbooleantrue = 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.
Try it

GET https://api.bytnode.com/v1/eth/deflation/history?limit=3

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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.

ParameterTypeDefaultDescription
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,base_fee_gwei. Unknown field: 422 unknown_field with a suggestion.
4 fields of the response
Field of dataTypeUnitDescription
timedate-timeISO 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_gweinumbergweiEIP-1559 base fee (burnt).
gas_used_rationumberfraction (0.585 = 58.5 %)Block gas used / gas target over recent blocks.
labelstringCongestion: low (gas_used_ratio < 0.5), normal, or high (> 0.8).
Try it

GET https://api.bytnode.com/v1/eth/gas

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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.

ParameterTypeDefaultDescription
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,base_fee_gwei. Unknown field: 422 unknown_field with a suggestion.
7 fields of the response
Field of dataTypeUnitDescription
timedate-timeISO 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_gweinumbergweiEIP-1559 base fee (burnt).
gas_used_rationumberfraction (0.585 = 58.5 %)Block gas used / gas target over recent blocks.
gas_sma_7d_gweinumbergwei7-day simple moving average of the base fee.
gas_sma_30d_gweinumbergwei30-day simple moving average of the base fee.
sma_7d_vs_30d_pctnumberpercent (58.5 = 58.5 %)(7-day simple moving average - 30-day simple moving average) / 30-day average, percent.
labelstringhigh_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.
Try it

GET https://api.bytnode.com/v1/eth/gas-momentum

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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).

ParameterTypeDefaultDescription
since_msinteger—Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range.
until_msinteger—Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next.
limitinteger · 1–1000100Number 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.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,base_fee_gwei. Unknown field: 422 unknown_field with a suggestion.
before_msinteger—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).
orderstringdescReading 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 fields of the response
Field of dataTypeUnitDescription
[].timedate-timeISO 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_gweinumbergweiEIP-1559 base fee (burnt).
[].gas_used_rationumberfraction (0.585 = 58.5 %)Block gas used / gas target over recent blocks.
[].gas_sma_7d_gweinumbergwei7-day simple moving average of the base fee.
[].gas_sma_30d_gweinumbergwei30-day simple moving average of the base fee.
[].sma_7d_vs_30d_pctnumberpercent (58.5 = 58.5 %)(7-day simple moving average - 30-day simple moving average) / 30-day average, percent.
[].labelstringhigh_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_closedbooleantrue = 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.
Try it

GET https://api.bytnode.com/v1/eth/gas-momentum/history?limit=3

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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).

ParameterTypeDefaultDescription
since_msinteger—Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range.
until_msinteger—Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next.
limitinteger · 1–1000100Number 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.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,base_fee_gwei. Unknown field: 422 unknown_field with a suggestion.
before_msinteger—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).
orderstringdescReading 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 fields of the response
Field of dataTypeUnitDescription
[].timedate-timeISO 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_gweinumbergweiEIP-1559 base fee (burnt).
[].gas_used_rationumberfraction (0.585 = 58.5 %)Block gas used / gas target over recent blocks.
[].labelstringCongestion: low (gas_used_ratio < 0.5), normal, or high (> 0.8).
[].is_closedbooleantrue = 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.
Try it

GET https://api.bytnode.com/v1/eth/gas/history?limit=3

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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.

ParameterTypeDefaultDescription
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,eth_price_usd. Unknown field: 422 unknown_field with a suggestion.
6 fields of the response
Field of dataTypeUnitDescription
timedate-timeISO 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_usdnumberUSDETH price.
btc_price_usdnumberUSDBTC 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_btcnumberBTCETH price in BTC (ETH price / BTC price).
change_7d_pctnumber | nullpercent (58.5 = 58.5 %)Relative change of the value over 7 days, percent.
labelstring7-day momentum of ETH/BTC: eth_outperform (> 0), btc_outperform (< 0) or neutral.
Try it

GET https://api.bytnode.com/v1/eth/price-btc

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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).

ParameterTypeDefaultDescription
since_msinteger—Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range.
until_msinteger—Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next.
limitinteger · 1–1000100Number 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.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,eth_price_usd. Unknown field: 422 unknown_field with a suggestion.
before_msinteger—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).
orderstringdescReading 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 fields of the response
Field of dataTypeUnitDescription
[].timedate-timeISO 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_usdnumberUSDETH price.
[].btc_price_usdnumberUSDBTC 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_btcnumberBTCETH price in BTC (ETH price / BTC price).
[].change_7d_pctnumber | nullpercent (58.5 = 58.5 %)Relative change of the value over 7 days, percent.
[].labelstring | null7-day momentum of ETH/BTC: eth_outperform (> 0), btc_outperform (< 0) or neutral.
[].is_closedbooleantrue = 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.
Try it

GET https://api.bytnode.com/v1/eth/price-btc/history?limit=3

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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.

ParameterTypeDefaultDescription
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,staking_ratio. Unknown field: 422 unknown_field with a suggestion.
5 fields of the response
Field of dataTypeUnitDescription
timedate-timeISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z)Point-in-time value: the instant of the measurement (when the source was read).
staking_rationumber | nullfraction (0.585 = 58.5 %)Share of the ETH supply staked.
net_issuance_annualized_pctnumber | nullpercent (58.5 = 58.5 %)Net issuance annualised, as a percent of supply. Negative = the supply shrinks.
squeeze_indexnumber | nullscore from 0 to 100Supply squeeze index: combines the staked share and net issuance. Higher = less liquid ETH available.
labelstringlow (< 33), moderate (>= 33), high (>= 66).
Try it

GET https://api.bytnode.com/v1/eth/squeeze

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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).

ParameterTypeDefaultDescription
since_msinteger—Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range.
until_msinteger—Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next.
limitinteger · 1–1000100Number 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.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,staking_ratio. Unknown field: 422 unknown_field with a suggestion.
before_msinteger—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).
orderstringdescReading 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 fields of the response
Field of dataTypeUnitDescription
[].timedate-timeISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z)The day, at midnight UTC; the value is the LAST measurement of that day.
[].staking_rationumber | nullfraction (0.585 = 58.5 %)Share of the ETH supply staked.
[].net_issuance_annualized_pctnumber | nullpercent (58.5 = 58.5 %)Net issuance annualised, as a percent of supply. Negative = the supply shrinks.
[].squeeze_indexnumber | nullscore from 0 to 100Supply squeeze index: combines the staked share and net issuance. Higher = less liquid ETH available.
[].labelstring | nulllow (< 33), moderate (>= 33), high (>= 66).
[].is_closedbooleantrue = 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.
Try it

GET https://api.bytnode.com/v1/eth/squeeze/history?limit=3

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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).

ParameterTypeDefaultDescription
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,staking_ratio. Unknown field: 422 unknown_field with a suggestion.
5 fields of the response
Field of dataTypeUnitDescription
timedate-timeISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z)Point-in-time value: the instant of the measurement (when the source was read).
staking_rationumber | nullfraction (0.585 = 58.5 %)Share of the ETH supply staked.
total_stakednumber | nullETHETH staked (beacon chain).
total_supplynumber | nullcoinsTotal coins issued (circulating + locked), net of burns.
apr_pctnumber | nullpercent (58.5 = 58.5 %)Annualised rate in percent.
Try it

GET https://api.bytnode.com/v1/eth/staking

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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).

ParameterTypeDefaultDescription
since_msinteger—Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range.
until_msinteger—Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next.
limitinteger · 1–1000100Number 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.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,staking_ratio. Unknown field: 422 unknown_field with a suggestion.
before_msinteger—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).
orderstringdescReading 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 fields of the response
Field of dataTypeUnitDescription
[].timedate-timeISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z)The day, at midnight UTC; the value is the LAST measurement of that day.
[].staking_rationumber | nullfraction (0.585 = 58.5 %)Share of the ETH supply staked.
[].total_stakednumber | nullETHETH staked (beacon chain).
[].total_supplynumber | nullcoinsTotal coins issued (circulating + locked), net of burns.
[].apr_pctnumber | nullpercent (58.5 = 58.5 %)Annualised rate in percent.
[].is_closedbooleantrue = 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.
Try it

GET https://api.bytnode.com/v1/eth/staking/history?limit=3

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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.

ParameterTypeDefaultDescription
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,execution_issuance_cumulative. Unknown field: 422 unknown_field with a suggestion.
9 fields of the response
Field of dataTypeUnitDescription
timedate-timeISO 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_cumulativenumber | nullETHCumulative 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_cumulativenumber | nullETHCumulative consensus-layer issuance (staking rewards) since the Beacon Chain launch. NOT the ETH staked: see total_staked on /v1/eth/staking.
burnt_fees_cumulativenumber | nullETHETH burnt since EIP-1559 (cumulative).
withdrawn_cumulativenumber | nullETHETH withdrawn from staking (cumulative).
total_supplynumber | nullcoinsTotal coins issued (circulating + locked), net of burns.
burn_24hnumber | nullETHETH burnt over the last 24 h.
net_issuance_24hnumber | nullETHNew ETH issued minus ETH burnt over 24 h. Negative = deflationary.
labelstringdeflationary (24 h net issuance < 0), inflationary (> 0) or neutral.
Try it

GET https://api.bytnode.com/v1/eth/supply

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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).

ParameterTypeDefaultDescription
since_msinteger—Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range.
until_msinteger—Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next.
limitinteger · 1–1000100Number 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.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,execution_issuance_cumulative. Unknown field: 422 unknown_field with a suggestion.
before_msinteger—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).
orderstringdescReading 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 fields of the response
Field of dataTypeUnitDescription
[].timedate-timeISO 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_cumulativenumber | nullETHCumulative 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_cumulativenumber | nullETHCumulative consensus-layer issuance (staking rewards) since the Beacon Chain launch. NOT the ETH staked: see total_staked on /v1/eth/staking.
[].burnt_fees_cumulativenumber | nullETHETH burnt since EIP-1559 (cumulative).
[].withdrawn_cumulativenumber | nullETHETH withdrawn from staking (cumulative).
[].total_supplynumber | nullcoinsTotal coins issued (circulating + locked), net of burns.
[].burn_24hnumber | nullETHETH burnt over the last 24 h.
[].net_issuance_24hnumber | nullETHNew ETH issued minus ETH burnt over 24 h. Negative = deflationary.
[].labelstring | nulldeflationary (24 h net issuance < 0), inflationary (> 0) or neutral.
[].is_closedbooleantrue = 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.
Try it

GET https://api.bytnode.com/v1/eth/supply/history?limit=3

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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.

ParameterTypeDefaultDescription
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,active_addresses. Unknown field: 422 unknown_field with a suggestion.
6 fields of the response
Field of dataTypeUnitDescription
timedate-timeISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z)The day the value refers to, at midnight UTC.
active_addressesnumbercountAddresses active on the day.
active_addresses_sma_7dnumbercount7-day simple moving average of active_addresses.
active_addresses_sma_30dnumbercount30-day simple moving average of active_addresses.
sma_7d_vs_30d_pctnumberpercent (58.5 = 58.5 %)(7-day simple moving average - 30-day simple moving average) / 30-day average, percent.
labelstring7-day vs 30-day average: accelerating (> +5 %), decelerating (< -5 %) or stable.
Try it

GET https://api.bytnode.com/v1/btc/active-addresses

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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).

ParameterTypeDefaultDescription
since_msinteger—Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range.
until_msinteger—Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next.
limitinteger · 1–1000100Number 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.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,active_addresses. Unknown field: 422 unknown_field with a suggestion.
before_msinteger—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).
orderstringdescReading 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 fields of the response
Field of dataTypeUnitDescription
[].timedate-timeISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z)The day the value refers to, at midnight UTC.
[].active_addressesnumbercountAddresses active on the day.
[].active_addresses_sma_7dnumbercount7-day simple moving average of active_addresses.
[].active_addresses_sma_30dnumbercount30-day simple moving average of active_addresses.
[].sma_7d_vs_30d_pctnumberpercent (58.5 = 58.5 %)(7-day simple moving average - 30-day simple moving average) / 30-day average, percent.
[].labelstring7-day vs 30-day average: accelerating (> +5 %), decelerating (< -5 %) or stable.
[].is_closedbooleantrue = 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.
Try it

GET https://api.bytnode.com/v1/btc/active-addresses/history?limit=3

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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.

ParameterTypeDefaultDescription
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,mvrv. Unknown field: 422 unknown_field with a suggestion.
4 fields of the response
Field of dataTypeUnitDescription
timedate-timeISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z)The day the value refers to, at midnight UTC.
mvrvnumberdimensionless ratioMarket value / realised value.
labelstringundervalued (<= 1), fair (> 1), elevated (> 2.5), overvalued (> 3.5).
change_30d_pctnumber | nullpercent (58.5 = 58.5 %)Relative change of the value over 30 days, percent.
Try it

GET https://api.bytnode.com/v1/btc/mvrv

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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).

ParameterTypeDefaultDescription
since_msinteger—Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range.
until_msinteger—Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next.
limitinteger · 1–1000100Number 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.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,mvrv. Unknown field: 422 unknown_field with a suggestion.
before_msinteger—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).
orderstringdescReading 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 fields of the response
Field of dataTypeUnitDescription
[].timedate-timeISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z)The day the value refers to, at midnight UTC.
[].mvrvnumberdimensionless ratioMarket value / realised value.
[].labelstringundervalued (<= 1), fair (> 1), elevated (> 2.5), overvalued (> 3.5).
[].change_30d_pctnumber | nullpercent (58.5 = 58.5 %)Relative change of the value over 30 days, percent.
[].is_closedbooleantrue = 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.
Try it

GET https://api.bytnode.com/v1/btc/mvrv/history?limit=3

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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.

ParameterTypeDefaultDescription
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,nvt. Unknown field: 422 unknown_field with a suggestion.
4 fields of the response
Field of dataTypeUnitDescription
timedate-timeISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z)The day the value refers to, at midnight UTC.
nvtnumberdimensionless ratioMarket cap / on-chain transaction volume of the day (NVT ratio), change returned to the sender excluded.
nvt_signalnumber | nulldimensionless ratioNVT 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.
labelstring | nullZone 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.
Try it

GET https://api.bytnode.com/v1/btc/nvt

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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).

ParameterTypeDefaultDescription
since_msinteger—Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range.
until_msinteger—Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next.
limitinteger · 1–1000100Number 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.
fieldsstring—Comma-separated projection of data (dot notation for nested keys): fields=time,nvt. Unknown field: 422 unknown_field with a suggestion.
before_msinteger—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).
orderstringdescReading 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 fields of the response
Field of dataTypeUnitDescription
[].timedate-timeISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z)The day the value refers to, at midnight UTC.
[].nvtnumberdimensionless ratioMarket cap / on-chain transaction volume of the day (NVT ratio), change returned to the sender excluded.
[].nvt_signalnumber | nulldimensionless ratioNVT 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.
[].labelstring | nullZone 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_closedbooleantrue = 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.
Try it

GET https://api.bytnode.com/v1/btc/nvt/history?limit=3

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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.

ParameterTypeDefaultDescription
fieldsstring—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 fields of the response
Field of dataTypeUnitDescription
timedate-timeISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z)The day the value refers to, at midnight UTC.
revenue_per_difficulty_usdnumberUSD per unit of difficultyMiners' 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_usdnumberUSD per unit of difficulty30-day simple moving average of revenue_per_difficulty_usd.
labelstringhealthy (at or above its 30-day average), stress (below it), capitulation (below 70 % of it — historically near BTC bottoms).
Try it

GET https://api.bytnode.com/v1/btc/revenue-per-difficulty

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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).

ParameterTypeDefaultDescription
since_msinteger—Lower time bound, INCLUSIVE, in epoch MILLISECONDS (13 digits). A value in seconds returns 422 invalid_time_range.
until_msinteger—Upper time bound, INCLUSIVE to the millisecond, in epoch milliseconds. To page, prefer before_ms (exclusive) or simply follow next.
limitinteger · 1–1000100Number 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.
fieldsstring—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_msinteger—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).
orderstringdescReading 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 fields of the response
Field of dataTypeUnitDescription
[].timedate-timeISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z)The day the value refers to, at midnight UTC.
[].revenue_per_difficulty_usdnumberUSD per unit of difficultyMiners' 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_usdnumberUSD per unit of difficulty30-day simple moving average of revenue_per_difficulty_usd.
[].labelstringhealthy (at or above its 30-day average), stress (below it), capitulation (below 70 % of it — historically near BTC bottoms).
[].is_closedbooleantrue = 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.
Try it

GET https://api.bytnode.com/v1/btc/revenue-per-difficulty/history?limit=3

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
curl
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 field of the response
Field of dataTypeUnitDescription
indicatorsobjectOne result per indicator of the request, keyed by the id you gave it.
Try it

POST https://api.bytnode.com/v1/indicators

The key stays in this browser tab: it is sent to api.bytnode.com only, never to this site.

Example: request and real response
{
  "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
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
          }
        ]
      }
    }
  }
}