Volume 24h—Positions ouvertes—Liquidations 24h$1.36BLong/Short 24h—Dominance BTC—Dominance ETH—
App
Langue ▾
€ EUR ▾
/api/sd/liquidations
GETDisponible

Synthèse des liquidations d'une crypto

Couche de données interne : synthèse des liquidations d'une crypto

GET/api/sd/liquidations

Requête

Paramètres de requête

NomTypeRequisPar défautValeurs autoriséesDescription
coinstringRequis——Symbole de la crypto ; 400 s'il est absent. Alias : `base`. Exemple: BTC

Exemple de requête

curl -s "https://www.coinboss.com/api/sd/liquidations?coin=BTC"

Champs de la réponse

Le tableau des champs est généré à partir de réponses réelles : il liste donc exactement ce que renvoie l'endpoint. Les chemins utilisent a[] pour les éléments d'un tableau et {*} pour les objets indexés par un nom dynamique, comme une crypto ou une plateforme.

ChampTypeUnitéDescription
successboolean—true lorsque la requête a abouti. En cas d'échec, le corps est `{ success: false, code, error, request_id }`.
coinstring—Symbole de la crypto, en majuscules (par exemple BTC).
nownumbermsHeure du serveur au moment où la réponse a été construite.
windowsobject—Totaux pour chaque fenêtre (clés telles que `1h`, `4h`, `12h`, `24h`). clés dynamiques: 1h,4h,12h,24h
windows.{*}object—Valeurs par fenêtre.
windows.{*}.long_usdnumberUSDPositions longues liquidées ; null lorsqu'aucune source n'a couvert la fenêtre.
windows.{*}.short_usdnumberUSDPositions short liquidées ; null lorsqu'aucune source n'a couvert la fenêtre.
windows.{*}.total_usdnumberUSDLong + short.
windows.{*}.countnumber—Nombre d'ordres de liquidation.
windows.{*}.long_pctnumber%Part des longs dans le total.
windows.{*}.max_orderobject—Plus grosse liquidation individuelle de la fenêtre.
windows.{*}.max_order.exchangestring—Identifiant de la plateforme, en minuscules (par exemple `binance`).
windows.{*}.max_order.symbolstring—Symbole de l'instrument tel que normalisé par CoinBoss (par exemple BTCUSDT).
windows.{*}.max_order.sidestring—Sens de la position liquidée (`long` = un long a été liquidé).
windows.{*}.max_order.pricenumber—Dernier prix dans la devise de cotation (USD ou USDT sauf mention contraire).
windows.{*}.max_order.qtynumber—Taille de l'ordre en contrats ou en cryptos, telle que publiée par la plateforme.
windows.{*}.max_order.contract_multipliernumber—Nombre de cryptos par contrat servant à convertir `qty` en notionnel.
windows.{*}.max_order.value_usdnumberUSDNotionnel de la liquidation : prix × qty × multiplicateur du contrat.
windows.{*}.max_order.timestampnumbermsHorodatage.
by_exchangeobject—Répartition par plateforme pour chaque fenêtre. clés dynamiques: 1h,4h,12h,24h
by_exchange.{*}array—Détail par plateforme.
by_exchange.{*}[]object—Détail par plateforme.
by_exchange.{*}[].exchangestring—Identifiant de la plateforme, en minuscules (par exemple `binance`).
by_exchange.{*}[].long_usdnumberUSDCôté long.
by_exchange.{*}[].short_usdnumberUSDCôté short.
by_exchange.{*}[].total_usdnumberUSDTotal.
by_exchange.{*}[].countnumber—Nombre d'ordres de liquidation.
by_exchange.{*}[].share_pctnumber%Part du total.
last_event_atnumbermsHeure de la liquidation la plus récente pour cette crypto.
last_event_age_snumbersSecondes écoulées depuis cet événement.
sourcesarray—État de chaque flux de liquidations : mode de collecte et date de la dernière livraison.
sources[]object—Sources de données.
sources[].exchangestring—Identifiant de la plateforme, en minuscules (par exemple `binance`).
sources[].viastring—Méthode de collecte (`ws`, `rest`, …).
sources[].statusstring—État du flux, évalué d'après ses propres heures d'événements et ses battements.
sources[].feed_last_event_age_snumber|nullsSecondes écoulées depuis l'événement.
sources[].ws_heartbeat_age_snumber|nullsSecondes écoulées depuis l'événement.
sources[].judged_bystring—Horodatage à partir duquel le statut a été évalué.
sources[].coin_last_event_age_snumber|nullsSecondes écoulées depuis l'événement.
sources[].min_event_usdnumberUSDPlus petite taille d'ordre publiée par le flux ; les liquidations inférieures ne sont pas visibles sur cette plateforme.
sources[].notestring|null—Remarque.
sources[].node_heartbeat_age_snumbersSecondes écoulées depuis l'événement. peut être absent
sources[].pipeline_last_event_age_snumbersSecondes écoulées depuis l'événement. peut être absent
coverageobject—Ce qui est inclus ou non dans les chiffres ci-dessus. Comparez ces éléments avant de comparer les totaux avec une autre source.
coverage.collected_exchangesarray—Plateformes disposant d'un flux public de liquidations que CoinBoss collecte.
coverage.collected_exchanges[]string—Plateformes collectées.
coverage.unavailablearray—Paires plateforme / contrat qui n'ont pas pu être incluses, chacune avec sa raison. Elles ne sont jamais comptées comme 0.
coverage.unavailable[]object—Éléments pour lesquels aucune donnée n'est disponible, avec les raisons. Jamais déclarés comme 0.
coverage.unavailable[].exchangestring—Identifiant de la plateforme, en minuscules (par exemple `binance`).
coverage.unavailable[].reasonstring—Code de raison.
methodobject—Énoncé en texte brut des formules utilisées pour cette réponse.
method.eventstring—Note en texte brut sur ce qu'est un événement de liquidation : un ordre de liquidation poussé par le flux de la plateforme ou renvoyé par son API REST publique.
method.sidestring—Sens de la position liquidée (`long` = un long a été liquidé).
method.value_usdstringUSDNotionnel de la liquidation : prix × qty × multiplicateur du contrat.
method.dedupestring—Note en texte brut sur la déduplication : les événements sont uniques par plateforme, symbole, sens, prix, valeur et horodatage, auxquels s'ajoute l'identifiant d'ordre de la plateforme lorsqu'il est fourni.
method.null_rulestring—Note en texte brut précisant qu'une fenêtre sans aucun événement collecté renvoie null plutôt que 0, et où sont listées les plateformes sans flux public.
method.binance_notestring—Mise en garde en texte brut : Binance pousse au plus une liquidation par symbole et par seconde, les totaux Binance constituent donc une borne inférieure.
method.min_event_usdstringUSDPlus petit ordre publié par le flux.

Généré à partir de 4 réponses réelles (2026-11-11 23:00 UTC).

Exemple de réponse

/api/sd/liquidations?coin=BTC · Réponse réelle (capture : 2026-11-13 03:57:52 UTC). Les tableaux et dictionnaires longs sont abrégés pour l'affichage : sources comptait 11 éléments; windows comptait 4 éléments; by_exchange comptait 4 éléments; by_exchange.{*} comptait 10 éléments; coverage.unavailable comptait 10 éléments; coverage.collected_exchanges comptait 11 éléments.

  • {
    • "success": true,
    • "coin": "BTC",
    • "now": 1794542272606,
    • "windows": {
      • "1h": { … 6 },
      • "4h": { … 6 }
      },
    • "by_exchange": {
      • "1h": [ … 2 ],
      • "4h": [ … 2 ]
      },
    • "last_event_at": 1794542269523,
    • "last_event_age_s": 3,
    • "sources": [
      • { … 9 },
      • { … 9 }
      ],
    • "coverage": {
      • "collected_exchanges": [ … 8 ],
      • "unavailable": [ … 2 ]
      },
    • "method": {
      • "event": "one row per liquidation order pushed by the exchange (WS) or returned by its public REST; REST used to fill WS gaps (OKX/Gate/HTX)",
      • "side": "LONG = a long position was liquidated (forced sell); SHORT = a short position was liquidated (forced buy)",
      • "value_usd": "linear: filled qty × price; inverse: contracts × contract face value (USD)",
      • "dedupe": "unique (exchange, symbol, side, price, value_usd, timestamp) + exchange order id hash where provided",
      • "null_rule": "a window with no collected event returns null (shown as —), never 0; exchanges without a public feed are listed in coverage.unavailable",
      • "binance_note": "Binance WS pushes at most one liquidation per symbol per second (latest only) → Binance totals are a lower bound",
      • "min_event_usd": "collectors keep events above a per-exchange floor (sources[].min_event_usd: OKX/Bitget/HTX/Bitfinex/Deribit ≥ $100; Gate/Hyperliquid/Lighter ≥ $1; Binance/Bybit…"
      }
    }

Échantillons vérifiés

Outre l'exemple ci-dessus, la sonde appelle cet endpoint avec les paramètres suivants et vérifie le schéma à chaque fois.

ParamètresHTTPLatenceRésultat
coin=ETH20059 msRéussi
coin=SOL20030 msRéussi
coin=ARKM20017 msRéussi
—4002 msRéussi renvoie l'erreur attendue

Vérifié : 2026-11-13 03:57:52 UTC

Détails

Authentification
Aucune. Endpoint public.
Limite de requêtes
1200 requêtes par minute et par IP
Cache serveur
15s
Micro-cache en périphérie
10s
Fréquence de mise à jour
temps réel (push WebSocket des plateformes) ; interrogation REST : okx toutes les 15 s, gate toutes les 25 s, htx toutes les 5 min ; lots d'exécutions du nœud hyperliquid ingérés toutes les 5 s
Fenêtre
fenêtres glissantes de 1 h, 4 h, 12 h, 24 h
Sources de données
Ordres de liquidation collectés en interne à partir des flux publics de liquidations de 11 plateformes (p. ex. binance, okx, bybit, gate, bitget, htx) ; les liquidations de Hyperliquid proviennent des exécutions d'un nœud Hyperliquid que nous exploitons nous-mêmes.
Couverture des plateformes
11 plateformes avec des collecteurs actifs (binance USDT-M + COIN-M, okx, bybit linéaire + inverse, gate à règlement en USDT + BTC, bitget, htx, hyperliquid, aster, lighter, bitfinex, deribit) ; actifs crypto uniquement (les contrats sur actions tokenisées / indices / matières premières / devises sont dirigés vers le jeu de données TradFi distinct) ; binance pousse au plus une liquidation par symbole et par seconde, ses totaux constituent donc une borne inférieure ; taille minimale des événements stockés : 100 USD sur okx / bitget / htx / bitfinex / deribit / binance COIN-M, 1 USD sur gate / hyperliquid / lighter, aucune sur binance USDT-M / bybit / aster
Unités
USD notional (price x quantity) per liquidation order; timestamps in Unix ms; side LONG = long position liquidated, SHORT = short position liquidated; max_order price normalized for multiplier contracts
Méthode
per window: long_usd, short_usd, total_usd = SUM(value_usd), count; by_exchange breakdown; largest single order
Horodatages
Millisecondes depuis l'epoch Unix (UTC), sauf indication contraire dans la description du champ
Format de réponse
json
Stabilité
Stable
Disponible depuis
2026-11-11

Statut en direct

DisponibleVérifié : 2026-11-13 03:57:52 UTCHTTP 200853 msSchéma conformePoint de données le plus récent : il y a 3s

Disponibilité, 30 derniers jours

100 % des 410 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 →

CodeHTTPSignificationQue faire
INVALID_PARAM400Un 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.
UNAUTHORIZED401L'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.
FORBIDDEN403La route ne fait pas partie de l'API publique (interne ou réservée aux comptes).Ne réessayez pas.
NOT_FOUND404Route 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_LIMITED429Plus 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.
INTERNAL500Erreur 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_FAILED503La 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.
UNAVAILABLE501 / 503Le 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_FAILED200Certains 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

GET/api/sd/liquidationsDisponible
Paramètres

string — Coin symbol; 400 when missing. Alias: `base`.

URL de la requêtehttps://www.coinboss.com/api/sd/liquidations?coin=BTC
Choisissez 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.