WebSocket
WebSocket est un protocole de connexion bidirectionnelle persistante sur TCP : le client ouvre la connexion une fois, puis le serveur pousse des messages dès que de nouvelles données apparaissent. Le protocole est défini dans la RFC 6455 (2011) ; les URL commencent par ws:// ou wss://, cette dernière étant chiffrée par TLS.
Comment fonctionne la connexion
La connexion démarre comme une requête HTTP ordinaire avec un en-tête Upgrade: websocket. Le serveur répond 101 Switching Protocols, puis les messages circulent dans les deux sens sur la même connexion TCP, sans nouvelles requêtes. Les trames de contrôle ping et pong vérifient que l’autre côté est toujours là.
Avec une API REST, chaque mise à jour doit être demandée : c’est du polling. Avec WebSocket, le serveur envoie les mises à jour de lui-même, mais il faut garder la connexion ouverte, la rétablir après une coupure et traiter le flux aussi vite qu’il arrive.
WebSocket chez les exchanges
Les exchanges diffusent les transactions et les changements du carnet d’ordres via WebSocket. Sur Binance, le flux btcusdt@trade pousse chaque transaction BTC/USDT et btcusdt@depth@100ms, les changements du carnet toutes les 100 ms (documentation Binance).
// Navigateur : transactions BTC/USDT de Binance, un message par transaction
const ws = new WebSocket(
'wss://stream.binance.com:9443/ws/btcusdt@trade'
);
ws.onmessage = (event) => {
const trade = JSON.parse(event.data);
console.log(trade.p, trade.q); // prix et quantité
};
Le flux de profondeur n’envoie que les changements. Un carnet complet se construit à partir d’un instantané REST (/api/v3/depth) et des événements du flux, rapprochés par l’identifiant de mise à jour ; si un événement est manqué, le carnet est reconstruit depuis zéro. Une connexion Binance dure au maximum 24 heures.
WebSocket et Genesis API
Genesis API n’a pas de WebSocket : les données sont servies en REST et le plan fixe la fraîcheur de la sortie, de 60 secondes en Trial à 5 secondes en Max. Genesis Arbitrage collecte lui-même les flux des exchanges : dans la réponse du carnet d’un marché, le champ source indique si un carnet est arrivé par WebSocket (ws) ou par REST (rest), et age_sec donne son âge en secondes.
| Tâche | Ce qui convient |
|---|---|
| Passer des ordres et réagir en fractions de seconde | Le WebSocket et l’API de trading de l’exchange |
| Garder en mémoire le carnet d’ordres complet d’une paire | Le WebSocket de l’exchange plus un instantané REST |
| Scanner les spreads sur plus de 20 exchanges, alertes, tableaux de bord | Genesis API en REST, interrogée à la fraîcheur du plan |
On ne peut pas trader via Genesis API : les ordres passent par l’API de l’exchange lui-même, à vos propres risques.
Voir aussi : latence, webhook, API de carnet d’ordres, API crypto : types et comment choisir.
Questions et réponses
Genesis API a-t-elle un WebSocket ?
Non. Toutes les requêtes sont des appels HTTP GET vers une API REST avec des réponses JSON, et la fraîcheur des données dépend du plan : 60, 30, 10 ou 5 secondes.