Prise en main

Démarrage rapide

Trois minutes, une clé et une requête. Cette page va de la création du compte à la première réponse lue, puis montre comment récupérer plusieurs familles de données d’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. Le palier gratuit ouvre quatre familles de données — prix et volume, dérivés, indicateurs, macro — sans carte bancaire : de quoi savoir en une soirée si la donnée vous convient.

La clé s’affiche masquée dans la console : révélez-la ou copiez-la quand vous en avez besoin, puis rangez-la dans un gestionnaire de secrets ou une variable d’environnement. Compromise, elle se remplace en une rotation.

#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="votre_cle"

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

Deux choses seulement 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 : celle-ci porte son propre timestamp ou son bucket.
data_type — le nom du type retourné. Il permet de router une réponse sans se fier au chemin appelé.
data — la charge utile : 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 h, 08 h et 16 h UTC.
apr annualise le taux — ici environ 9 % par an.
exchange_count dit sur combien de places le composite a été construit. Ce compte varie d’une fenêtre à l’autre : c’est une information, pas une constante.

#Plusieurs familles en une requête

Interroger dix endpoints pour peupler un tableau de bord est un gaspillage : /v1/snapshot fait le travail en un aller. 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’open interest, 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-timeframe se demandent avec le suffixe @tf — cvd@1h — et la clé revient telle quelle dans la réponse. Le détail des soixante et un champs, ainsi que des clés unavailable et coverage qui accompagnent la réponse, se lit sur la page Snapshot.

#Et ensuite

AuthentificationOù poser la clé sur chacun des trois canaux, et comment la faire tourner sans coupure.ConventionsSymboles, pas de temps, agrégation, bougies fermées : les règles qui valent partout.Catalogue des endpointsTout ce qui est appelable, sur une seule page.Flux WebSocketPasser du sondage périodique à l’écoute continue, en quatre canaux.