WSDisponible
Flux des liquidations et des prix
Une seule connexion WebSocket pousse les ordres de liquidation et les mises à jour de prix. Il n'y a pas de message d'abonnement : le serveur envoie une trame `history` et une trame `price_snapshot` à la connexion, puis des trames `liquidation` et `price` au fil des événements.
WS
wss://www.coinboss.com/wsRequête
Il n'y a pas de message d'abonnement : le serveur commence à pousser les données dès l'ouverture de la connexion. Reconnectez-vous après un délai lorsque le socket se ferme et comblez le trou via HTTP.
Exemple de requête
# WebSocket needs a WS client; with websocat:
websocat "wss://www.coinboss.com/ws"Champs de la réponse
| Type de trame | Envoi | Structure |
|---|---|---|
| history | une fois, à la connexion | { "type": "history", "data": [ <liquidation>, ... ] } |
| price_snapshot | une fois, à la connexion | { "type": "price_snapshot", "data": { "<SYMBOL>": <price>, ... }, "ts": <ms> } |
| liquidation | à chaque ordre de liquidation | { "type": "liquidation", "data": <liquidation> } |
| price | à chaque variation de prix | { "type": "price", "symbol": "BTCUSDT", "price": <number>, "ts": <ms> } |
Exemple de réponse
Aucun exemple n'est conservé, car la dernière réponse réussie était trop volumineuse pour être affichée. Appelez l'endpoint dans le Playground.
Détails
- Authentification
- Aucune. Endpoint public.
- Limite de requêtes
- 1200 requêtes par minute et par IP
- Cache serveur
- Non mis en cache
- Fréquence de mise à jour
- Poussé en temps réel. Les trames `liquidation` suivent les flux de liquidations des plateformes ; les trames `price` suivent les mises à jour des tickers futures.
- Fenêtre
- `history` contient les ordres de liquidation les plus récents au moment de la connexion ; tout le reste est en direct.
- Sources de données
- Flux de liquidations des plateformes collectés par CoinBoss ; flux de tickers futures.
- Horodatages
- Millisecondes depuis l'epoch Unix (UTC) dans `ts` / `timestamp`.
- Format de réponse
- json-frames
- Stabilité
- Stable
Statut en direct
DisponibleVérifié : 2026-11-13 03:59:35 UTCHTTP 1014 msSchéma non vérifié
Disponibilité, 30 derniers jours
100 % des 408 contrôles réussis
Erreurs
Les appels en échec ont la même structure sur tous les endpoints. La liste complète figure sur la page des erreurs. Erreurs et limites de requêtes →
| Code | HTTP | Signification | Que faire |
|---|---|---|---|
| INVALID_PARAM | 400 | Un paramètre requis est manquant ou une valeur n'est pas acceptée. `param` indique le nom du paramètre lorsqu'il est connu. | Ne réessayez pas à l'identique ; corrigez la requête. |
| UNAUTHORIZED | 401 | L'en-tête `CB-API-KEY` a été envoyé, mais la clé est inconnue ou révoquée. Les données publiques ne nécessitent aucune clé — supprimez l'en-tête ou utilisez une clé valide. | Ne réessayez pas à l'identique. |
| FORBIDDEN | 403 | La route ne fait pas partie de l'API publique (interne ou réservée aux comptes). | Ne réessayez pas. |
| NOT_FOUND | 404 | Route inconnue, ou la crypto / la plateforme / le fonds demandé n'existe pas. | Ne réessayez pas ; vérifiez le chemin et les identifiants dans le catalogue. |
| RATE_LIMITED | 429 | Plus de requêtes que la limite par minute. `Retry-After` indique le nombre de secondes à attendre. | Attendez la durée indiquée par `Retry-After`, puis réessayez avec backoff. |
| INTERNAL | 500 | Erreur serveur inattendue. Le message est volontairement générique ; citez `request_id` lorsque vous la signalez. | Réessayez une fois après quelques secondes ; si l'erreur persiste, signalez-la avec l'ID de requête. |
| UPSTREAM_FAILED | 503 | La source de données derrière cet endpoint n'a pas répondu à temps. Aucun chiffre périmé ni de substitution n'est renvoyé à sa place. | Réessayez avec backoff ; consultez la page de statut. |
| UNAVAILABLE | 501 / 503 | Le jeu de données n'est temporairement pas prêt (préchauffage du cache) ou l'endpoint n'a pas encore de source publique licite. | Réessayez plus tard ; le catalogue signale les endpoints indisponibles par conception. |
| REQUEST_FAILED | 200 | Certains endpoints plus anciens répondent HTTP 200 avec `success: false`. Vérifiez toujours `success`, et pas seulement le statut HTTP. | Dépend du message ; à traiter comme une requête en échec. |
Essayer
WS
/wsDisponibleIl s'agit d'un flux WebSocket. Connectez-vous pour voir arriver les messages réels ; la connexion se ferme automatiquement après 25 messages.
URL de la requête
wss://www.coinboss.com/wsChoisissez un endpoint et cliquez sur « Envoyer la requête ». La réponse, les en-têtes et le temps de réponse s'afficheront ici.