Premiers pas

Démarrage rapide

Trois minutes, une clé et une requête. Cette page va de la création du compte à la lecture de la première réponse, puis montre comment récupérer plusieurs familles de données en un seul appel.

#Obtenir une clé

Créez un compte : votre première clé est générée automatiquement et vous attend dans la console. L’offre gratuite ouvre quatre familles de données (prix et volume, dérivés, indicateurs, macro) sans carte : de quoi savoir en une soirée si les données vous conviennent.

La clé est affichée masquée dans la console : affichez-la ou copiez-la quand vous en avez besoin, puis gardez-la dans un gestionnaire de secrets ou une variable d’environnement. Si elle est compromise, un renouvellement la remplace.

#Le premier appel

Le taux de funding composite de Bitcoin, agrégé sur toutes les places qui le publient et ramené à une base de huit heures.

export BYTNODE_KEY="your_key"

curl -H "X-API-KEY: $BYTNODE_KEY" \
  "https://api.bytnode.com/v1/funding/rate?symbol=BTCUSDT"

Seules deux choses sont obligatoires : l’en-tête X-API-KEY et le paramètre symbol. Il n’y a pas de symbole par défaut. Une requête sans symbole est refusée plutôt que servie avec Bitcoin, qui n’est pas forcément ce que vous vouliez.

#Lire la réponse

Réponse
{
  "status": "ok",
  "timestamp": 1775648290510,
  "data_type": "funding_rate_8h",
  "data": {
    "bucket": "2026-08-29T08:00:00+00:00",
    "rate": 0.000082,
    "apr": 0.08979,
    "exchange_count": 7
  }
}

Les quatre clés de l’enveloppe

  • status : ok ou error.
  • timestamp : l’instant où la réponse a été produite, en millisecondes. Ce n’est pas l’horodatage de la donnée : la donnée porte son propre timestamp ou son bucket.
  • data_type : le nom du type renvoyé. Il permet d’aiguiller une réponse sans dépendre du chemin appelé.
  • data : la charge utile, qui est un objet, une liste, ou null quand rien n’est disponible.

Ce que dit cette réponse en particulier

  • bucket ouvre la fenêtre de huit heures sur laquelle le taux a été calculé, alignée sur 00:00, 08:00 et 16:00 UTC.
  • apr annualise le taux, ici environ 9 % par an.
  • exchange_count dit sur combien de places le composite a été construit. Ce nombre varie d’une fenêtre à l’autre : c’est une information, pas une constante.

#Plusieurs familles en une requête

Appeler dix endpoints pour remplir un tableau de bord est du gâchis : /v1/snapshot fait le travail en un aller-retour. Chaque paramètre est un nom de champ, sa valeur est la profondeur demandée : un nombre de lignes ou de minutes selon le champ, true pour les champs qui n’ont qu’une valeur courante.

curl
Vingt-quatre bougies horaires, le funding, une heure de delta d’intérêt ouvert, deux heures de liquidations, le CVD horaire et l’indice de sentiment.
curl -H "X-API-KEY: $BYTNODE_KEY" \
  "https://api.bytnode.com/v1/snapshot?symbol=BTCUSDT\
&klines_1h=24\
&funding_rate_8h=true\
&oi_delta=60\
&liq_cumulative=120\
&cvd@1h=24\
&fear_greed=true"

Les champs multi-unités de temps se demandent avec le suffixe @tf (cvd@1h), et la clé revient inchangée dans la réponse. Le détail des soixante et un champs, ainsi que les clés unavailable et coverage qui accompagnent la réponse, est sur la page Snapshot.

#Et ensuite

AuthentificationOù placer la clé sur chacun des trois canaux, et comment la renouveler sans interruption.ConventionsSymboles, unités de temps, agrégation, bougies closes : les règles qui valent partout.Catalogue des endpointsTout ce qui peut être appelé, sur une seule page.Flux WebSocketPasser de l’interrogation périodique à l’écoute continue, sur quatre canaux.