Snapshot

#El principio

Cada parámetro de la petición es un nombre de campo, y su valor la profundidad solicitada (un número de filas, de minutos o de segundos según el campo). Los campos que solo tienen un valor actual se piden con =1 (o =true, que significa lo mismo). symbol es obligatorio. El snapshot está incluido a partir del plan Traders.

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"

Sin ningún campo solicitado, la respuesta devuelve un data vacío y el catálogo de lo que incluye tu plan: available_fields (los campos sin temporalidad), available_multi_tf_fields (que se piden como name@tf), timeframes y max_depth, el límite de cada campo. Un cliente puede construir sus peticiones a partir de él sin leer esta página.

#Los 52 campos

Treinta y siete campos se piden por su nombre a secas (el descubrimiento, /v1/snapshot?symbol=BTCUSDT, los lista). Cada uno tiene el nombre y el contenido de su ruta: un campo cuya ruta devuelve un objeto vuelve como ese objeto, pedido con =1 (o =true) — una profundidad mayor es un 422 que remite a su ruta /history; los campos de eventos (trades individuales, eventos de liquidación, velas por segundo) son listas, hasta el límite de la columna profundidad.

#Campos multitemporalidad

Once campos existen por marco temporal. Se piden con el sufijo @tf, obligatorio, y la clave vuelve tal cual en data (data["cvd@1h"]). klines admite también 1w (timeframes_by_field en el catálogo). Un campo @tf es siempre una LISTA, incluso con profundidad 1; un campo sin marco temporal es el OBJETO de su ruta (solo profundidad 1), salvo los campos de eventos (trades, liquidaciones, segundos), que son listas.

1m5m15m30m1h4h1d

Pedir un campo multitemporalidad sin su sufijo devuelve 422, y lo contrario también: un campo de forma única con el sufijo @1h se rechaza.

#Las claves adicionales

{
  "status": "ok",
  "server_time": "2026-10-13T02:18:41.507Z",
  "data_type": "snapshot",
  "symbol": "USDCUSDT",
  "is_partial": false,
  "data": { "funding_rate": null, "options_summary": null, "basis": null },
  "unavailable": {
    "funding_rate": "not_applicable",
    "options_summary": "not_applicable",
    "basis": "not_applicable"
  }
}

{
  "status": "ok",
  "server_time": "2026-10-13T02:30:56.839Z",
  "data_type": "snapshot",
  "symbol": "BTCUSDT",
  "is_partial": false,
  "data": {
    "funding_rate": {"time": "2026-10-12T16:00:00.000Z", "period_end_at": "2026-10-13T00:00:00.000Z", "settled_at": "2026-10-13T00:00:00.005Z", "rate_pct": 0.0038949161538, "apr_pct": 4.26493318841, "is_closed": true},
    "basis": {"time": "2026-10-13T02:30:14.102Z", "basis_value": -33.9427339947, "basis_pct": -0.0410036905061, "futures_price": 82743.8733191, "spot_price": 82777.8160531}
  },
  "out_of_plan_fields": ["fear_greed", "btc_mvrv"]
}

#Errores

La ventana de historial del plan se aplica a los campos con fecha igual que a las rutas REST: klines@1h=1000 pide mil velas horarias, algo que Traders (una semana en 1h) rechaza con un 403 history_depth explícito en lugar de devolver 168 velas bajo el nombre de mil.

{
  "status": "error",
  "server_time": "2026-09-30T16:07:27.808Z",
  "error": {
    "code": "history_depth",
    "message": "History depth beyond your plan: 1000 hour(s) requested on 1h, your plan allows 7 day(s) (i.e. at most limit=168 on this timeframe, and no since_ms/until_ms bound beyond that window).",
    "param": "limit",
    "details": {
      "window_s": 604800,
      "earliest_ms": 1791273600000,
      "max_limit": 168,
      "timeframe": "1h"
    }
  }
}