API WebSocket v1 - Exemple de flux de données de marché

Dernière mise à jour : 31 mars 2025

Les flux de données de marché de l'API WebSocket v1 sont une série de flux publics (non authentifiés) qui fournissent un flux en temps réel des données de trading disponibles (ticker, heure et ventes, carnet d'ordres, etc.) pour nos marchés.

En tant que flux de données de marché en direct, toute modification des données de marché (telle que les mises à jour des meilleurs prix ou volumes d'achat/vente, par exemple) entraînerait l'envoi d'un message de mise à jour via un ou plusieurs des flux de données de marché.

Comment s'abonner à un flux de données de marché

Une fois qu'une connexion à l'API WebSocket v1 a été établie (en utilisant l'URL publique wss://ws.kraken.com/), les flux de données de marché peuvent être souscrits en envoyant un message d'abonnement comme suit :

  • {"event":"subscribe", "subscription":{"name":"ticker"}, "pair":["BTC/USD"]}

Dès réception d'une demande d'abonnement valide, les flux de données de marché enverraient un message de confirmation d'abonnement :

  • {"channelID":324,"channelName":"ticker","event":"subscriptionStatus","pair":"XBT/USD","status":"subscribed","subscription":{"name":"ticker"}}

suivi d'un instantané initial des données de marché (selon le flux en question), puis du flux en direct des données de marché en temps réel.

Exemple de flux en direct à partir d'un flux de données de marché

Voici un exemple du flux ticker, illustrant le type de messages reçus pour diverses modifications des données de marché (telles qu'une transaction entraînant une modification du volume d'achat/vente optimal) :

[324,{"a":["42243.20000",3,"3.04172624"],"b":["42243.10000",0,"0.28500000"],"c":["42243.20000","0.00073657"],"v":["634.15053067","2117.90194729"],"p":["41908.86644","41673.47236"],"t":[7214,21130],"l":["40772.20000","40772.20000"],"h":["42474.30000","42571.50000"],"o":["41016.00000","41896.10000"]},"ticker","XBT/USD"]
{"event":"heartbeat"}
{"event":"heartbeat"}
{"event":"heartbeat"}
{"event":"heartbeat"}
[324,{"a":["42243.20000",0,"0.01460168"],"b":["42243.10000",3,"3.82293519"],"c":["42243.20000","0.01398000"],"v":["634.16451067","2117.88824812"],"p":["41908.87381","41673.47318"],"t":[7215,21126],"l":["40772.20000","40772.20000"],"h":["42474.30000","42571.50000"],"o":["41016.00000","41898.80000"]},"ticker","XBT/USD"]
{"event":"heartbeat"}
{"event":"heartbeat"}
{"event":"heartbeat"}
{"event":"heartbeat"}
{"event":"heartbeat"}
[324,{"a":["42255.00000",0,"0.08406816"],"b":["42243.10000",6,"6.33160603"],"c":["42255.00000","0.01593184"],"v":["634.19504419","2117.90471127"],"p":["41908.89020","41673.47996"],"t":[7217,21123],"l":["40772.20000","40772.20000"],"h":["42474.30000","42571.50000"],"o":["41016.00000","41908.00000"]},"ticker","XBT/USD"]
{"event":"heartbeat"}
{"event":"heartbeat"}
{"event":"heartbeat"}
{"event":"heartbeat"}
{"event":"heartbeat"}
[324,{"a":["42254.80000",0,"0.53200000"],"b":["42251.60000",0,"0.10000000"],"c":["42254.80000","0.05800000"],"v":["634.25304419","2117.94005439"],"p":["41908.92184","41673.49337"],"t":[7218,21122],"l":["40772.20000","40772.20000"],"h":["42474.30000","42571.50000"],"o":["41016.00000","41922.40000"]},"ticker","XBT/USD"]
{"event":"heartbeat"}
{"event":"heartbeat"}
{"event":"heartbeat"}
[324,{"a":["42248.60000",2,"2.84602281"],"b":["42247.00000",0,"0.12500000"],"c":["42248.60000","0.04168347"],"v":["634.29472766","2117.98132192"],"p":["41908.94416","41673.50464"],"t":[7219,21122],"l":["40772.20000","40772.20000"],"h":["42474.30000","42571.50000"],"o":["41016.00000","41922.40000"]},"ticker","XBT/USD"]
[324,{"a":["42248.60000",2,"2.83204281"],"b":["42246.90000",0,"0.10000000"],"c":["42248.60000","0.01398000"],"v":["634.30870766","2117.99530192"],"p":["41908.95164","41673.50844"],"t":[7220,21123],"l":["40772.20000","40772.20000"],"h":["42474.30000","42571.50000"],"o":["41016.00000","41922.40000"]},"ticker","XBT/USD"]
{"event":"heartbeat"}
{"event":"heartbeat"}

Notez que les messages heartbeat sont envoyés à une fréquence d'une fois par seconde lorsqu'aucune donnée de ticker (ou autre donnée de marché) n'est disponible.

Les détails des champs/valeurs individuels dans les messages JSON pour le flux ticker (et tous les autres flux de données de marché) sont disponibles dans notre documentation de l'API WebSocket v1.

Besoin d’aide supplémentaire ?