Snapshot

#Le principe

Chaque paramètre de la requête est un nom de champ, et sa valeur la profondeur demandée (un nombre de lignes, de minutes ou de secondes selon le champ). Les champs qui n’ont qu’une valeur courante se demandent avec =1 (ou =true, qui signifie la même chose). symbol est obligatoire. Le snapshot est inclus à partir de l’offre 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"

Sans aucun champ demandé, la réponse renvoie un data vide et le catalogue de ce que votre offre inclut : available_fields (les champs sans unité de temps), available_multi_tf_fields (demandés sous la forme name@tf), timeframes et max_depth, le plafond de chaque champ. Un client peut construire ses requêtes à partir de là sans lire cette page.

#Les 52 champs

Trente-sept champs se demandent par leur nom nu (la découverte, /v1/snapshot?symbol=BTCUSDT, les liste). Chacun a le nom et le contenu de sa route : un champ dont la route rend un objet revient sous la forme de cet objet, demandé avec =1 (ou =true) — une profondeur supérieure est un 422 qui renvoie à sa route /history ; les champs d’événements (trades individuels, événements de liquidation, bougies à la seconde) sont des listes, jusqu’au plafond de la colonne profondeur.

#Champs multi-unités de temps

Onze champs existent par unité de temps. Ils se demandent avec le suffixe @tf, obligatoire, et la clé revient telle quelle dans data (data["cvd@1h"]). klines prend aussi 1w (timeframes_by_field dans le catalogue). Un champ @tf est toujours une LISTE, même en profondeur 1 ; un champ sans unité de temps est l’OBJET de sa route (profondeur 1 seulement), sauf les champs d’événements (trades, liquidations, secondes), qui sont des listes.

1m5m15m30m1h4h1d

Demander un champ multi-unités de temps sans son suffixe renvoie 422, et l’inverse aussi : un champ à forme unique suffixé @1h est refusé.

#Les clés additionnelles

{
  "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"]
}

#Erreurs

La fenêtre d’historique de l’offre s’applique aux champs datés comme aux routes REST : klines@1h=1000 demande mille bougies horaires, ce que Traders (une semaine en 1h) refuse avec un 403 history_depth explicite plutôt que de renvoyer 168 bougies sous le nom de mille.

{
  "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"
    }
  }
}