Jours de plus fortes liquidations (Top 10)

Top 10 des totaux journaliers de liquidation : base historique de tiers et jours enregistrés par CoinBoss

GET/api/liquidation-events

The list merges two kinds of rows, told apart by `source`. `historical_baseline` rows come from third-party public historical records; they are kept as recorded and are never recalculated. `coinboss` rows are UTC daily totals of liquidation orders CoinBoss collected from exchange feeds; a day is added only when its total is greater than the 10th place of the list at that time.

Requête

Cet endpoint n'accepte aucun paramètre.

Exemple de requête

curl -s "https://www.coinboss.com/api/liquidation-events"

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.

Champ	Type	Unité	Description
success	boolean	—	true lorsque la requête a abouti. En cas d'échec, le corps est `{ success: false, code, error, request_id }`.
count	number	—	Nombre de lignes.
data	array	—	Charge utile.
data[]	object	—	Charge utile.
data[].rank_no	number	—	Position in the list, 1 = largest `total_usd`. The list holds 10 rows.
data[].event_date	string	—	Calendar day of the event, formatted `YYYY-MM-DD`. For `coinboss` rows it is a UTC day.
data[].amount_usd	number	USD	Same value as `total_usd`; kept for existing clients.
data[].total_usd	number	USD	Total notional liquidated on that day; the list is sorted by this field. `coinboss` rows: `long_usd` + `short_usd`. Baseline rows: the figure as recorded.
data[].amount_display	string	—	`total_usd` pre-formatted for display, e.g. `$3.26B`. Baseline rows carry the text as recorded.
data[].long_usd	number	USD	Longs liquidés.
data[].short_usd	number	USD	Shorts liquidés.
data[].liquidated_traders	string\|null	—	Number of traders liquidated that day, as display text copied from the third-party record; its definition is not stated by that record. null for `coinboss` rows: CoinBoss cannot count people and reports `liquidation_count` and `account_count` instead.
data[].btc_amplitude	string(decimal)\|null	—	BTC intraday price range of that day in percent, as display text copied from the third-party record; its price source and formula are not stated by that record, so it is not comparable with `btc_range_pct`. null for `coinboss` rows.
data[].event_zh	string\|null	—	Note attached to the third-party record, in Chinese; null when the record has none and for all `coinboss` rows. CoinBoss does not assign causes.
data[].source	string	—	Origin of the row: `historical_baseline` (third-party public historical record, kept as recorded) or `coinboss` (daily total from CoinBoss collectors).
data[].basis	string	—	How the figure was obtained: `third_party_public_history` or `coinboss_utc_daily_total`.
data[].updated_at	number\|null	ms	When CoinBoss added the row to the list; null for baseline rows.
data[].liquidation_count	number\|null	—	Number of liquidation events (liquidation orders or liquidation fills) CoinBoss collected on that UTC day, after de-duplication. It counts events, not people or accounts. null for baseline rows.
data[].liquidation_count_meta	object	—	How `liquidation_count` was obtained: quality, source, time window and coverage.
data[].liquidation_count_meta.kind	string	—	What the number counts: `liquidation_events`.
data[].liquidation_count_meta.quality	string	—	Availability of the value: `OK`, `PARTIAL` (covers only part of the market, see `coverage`) or `UNAVAILABLE` (the value is null).
data[].liquidation_count_meta.reason	string\|null	—	Why the value is unavailable, for example `baseline_row_third_party_record`, `breakdown_not_recorded` or `no_account_identifier`; null when a value is present.
data[].liquidation_count_meta.source	string\|null	—	Origin of the value: `coinboss_collectors`; null when the value is unavailable.
data[].liquidation_count_meta.source_at	number\|null	ms	When CoinBoss recorded (froze) the count; null when the value is unavailable.
data[].liquidation_count_meta.window	object	—	Time window the value covers.
data[].liquidation_count_meta.window.from	string	—	Start of the window (inclusive), ISO 8601.
data[].liquidation_count_meta.window.to	string	—	End of the window (exclusive), ISO 8601.
data[].liquidation_count_meta.window.timezone	string	—	Time zone of the window; always `UTC`.
data[].liquidation_count_meta.coverage	object\|null	—	Which exchanges and records the value covers; null when the value is unavailable.
data[].account_count	number\|null	—	Number of distinct liquidated accounts on that UTC day, counted only on exchanges whose data carries an account identifier (currently Hyperliquid wallet addresses). It is not a market-wide figure unless `account_count_meta.coverage.market_wide` is `true`, and one person can hold several accounts. null for baseline rows and when no exchange exposes an identifier.
data[].account_count_meta	object	—	How `account_count` was obtained: quality, source, time window and coverage.
data[].account_count_meta.kind	string	—	What the number counts: `unique_accounts`.
data[].account_count_meta.quality	string	—	Availability of the value: `OK`, `PARTIAL` (covers only part of the market, see `coverage`) or `UNAVAILABLE` (the value is null).
data[].account_count_meta.reason	string\|null	—	Why the value is unavailable, for example `baseline_row_third_party_record`, `breakdown_not_recorded` or `no_account_identifier`; null when a value is present.
data[].account_count_meta.source	string\|null	—	Origin of the value: `coinboss_collectors`; null when the value is unavailable.
data[].account_count_meta.source_at	number\|null	ms	When CoinBoss recorded (froze) the count; null when the value is unavailable.
data[].account_count_meta.window	object	—	Time window the value covers.
data[].account_count_meta.window.from	string	—	Start of the window (inclusive), ISO 8601.
data[].account_count_meta.window.to	string	—	End of the window (exclusive), ISO 8601.
data[].account_count_meta.window.timezone	string	—	Time zone of the window; always `UTC`.
data[].account_count_meta.coverage	object\|null	—	Which exchanges and records the value covers; null when the value is unavailable.
data[].btc_high	number	USD	BTC spot high of that UTC day: median of the daily highs on Binance (BTC/USDT), Coinbase (BTC/USD) and Kraken (BTC/USD). null unless all three venues have a final daily candle.
data[].btc_low	number	USD	BTC spot low of that UTC day: median of the daily lows on Binance (BTC/USDT), Coinbase (BTC/USD) and Kraken (BTC/USD). null unless all three venues have a final daily candle.
data[].btc_range	number	USD	Absolute BTC price range of that UTC day: `btc_high` − `btc_low`.
data[].btc_range_pct	number	%	BTC price range of that UTC day relative to the low: (`btc_high` − `btc_low`) / `btc_low` × 100.
data[].btc_range_meta	object	—	How the BTC high, low and range were obtained: quality, source, time window and the prices of each venue.
data[].btc_range_meta.quality	string	—	Availability of the BTC fields: `OK` or `UNAVAILABLE` (the four BTC fields are null).
data[].btc_range_meta.reason	null	—	Why the BTC fields are unavailable: `incomplete_venues`, `daily_candle_not_final`, `utc_day_not_closed` or `price_source_error`; null when values are present.
data[].btc_range_meta.source	string	—	Origin of the prices: `coinboss_spot_composite`, built from the spot daily candles CoinBoss collects from the three venues.
data[].btc_range_meta.method	string	—	Calculation method: median of the three venues’ daily highs, and median of their daily lows.
data[].btc_range_meta.price_type	string	—	Kind of price used: `spot`.
data[].btc_range_meta.unit	string	—	Unit of the BTC price fields: `USD`.
data[].btc_range_meta.source_at	number	ms	Close time of the daily candles used (end of the UTC day); null when the BTC fields are unavailable.
data[].btc_range_meta.window	object	—	Time window the value covers.
data[].btc_range_meta.window.from	string	—	Start of the window (inclusive), ISO 8601.
data[].btc_range_meta.window.to	string	—	End of the window (exclusive), ISO 8601.
data[].btc_range_meta.window.timezone	string	—	Time zone of the window; always `UTC`.
data[].btc_range_meta.coverage	object	—	The venues the calculation requires and the daily high and low of each.
data[].btc_range_meta.coverage.venues_required	number	—	Number of venues the calculation requires (3).
data[].btc_range_meta.coverage.venues_available	number	—	Number of venues that have a daily candle for that day.
data[].btc_range_meta.coverage.venues	array	—	The venues and their prices.
data[].btc_range_meta.coverage.venues[]	object	—	One venue.
data[].btc_range_meta.coverage.venues[].exchange	string	—	Identifiant de la plateforme.
data[].btc_range_meta.coverage.venues[].pair	string	—	Trading pair of the daily candle.
data[].btc_range_meta.coverage.venues[].market	string	—	Market type: `spot`.
data[].btc_range_meta.coverage.venues[].high	number	—	Daily high on this venue, in the quote currency of `pair`; null when the candle is missing.
data[].btc_range_meta.coverage.venues[].low	number	—	Daily low on this venue, in the quote currency of `pair`; null when the candle is missing.
data[].btc_range_meta.coverage.venues[].final	boolean	—	`true` when the daily candle is final, i.e. the venue’s next daily candle has been stored; null when the candle is missing.
data[].btc_range_meta.coverage.high_venue	string	—	Venue whose daily high is the median, i.e. equals `btc_high`.
data[].btc_range_meta.coverage.low_venue	string	—	Venue whose daily low is the median, i.e. equals `btc_low`.
data[].liquidation_count_meta.coverage.exchange_count	number	—	Number of exchanges with at least one liquidation event that day. peut être absent
data[].liquidation_count_meta.coverage.exchanges	array	—	Those exchanges. peut être absent
data[].liquidation_count_meta.coverage.exchanges[]	string	—	Identifiant de la plateforme.
data[].liquidation_count_meta.coverage.dedup_key	string	—	Fields that identify one liquidation event; records with the same key are counted once. peut être absent
data[].liquidation_count_meta.coverage.raw_rows	number	—	Number of collected records before de-duplication. peut être absent
data[].liquidation_count_meta.coverage.duplicates_removed	number	—	Number of duplicate records dropped. peut être absent
data[].liquidation_count_meta.coverage.by_exchange	array	—	Per-exchange split of the count; null when no per-exchange snapshot was recorded. peut être absent
data[].liquidation_count_meta.coverage.by_exchange[]	object	—	One exchange.
data[].liquidation_count_meta.coverage.by_exchange[].exchange	string	—	Identifiant de la plateforme.
data[].liquidation_count_meta.coverage.by_exchange[].liquidation_count	number	—	Liquidation events on this exchange.
data[].liquidation_count_meta.coverage.by_exchange[].total_usd	number	USD	Notional liquidated on this exchange.
data[].account_count_meta.coverage.market_wide	boolean	—	`true` only when every exchange in the day’s total exposes an account identifier for every event. peut être absent
data[].account_count_meta.coverage.exchange_count	number	—	Number of exchanges whose data carries an account identifier. peut être absent
data[].account_count_meta.coverage.exchanges	array	—	Those exchanges. peut être absent
data[].account_count_meta.coverage.exchanges[]	string	—	Identifiant de la plateforme.
data[].account_count_meta.coverage.exchanges_total	number	—	Number of exchanges in the day’s total. peut être absent
data[].account_count_meta.coverage.exchanges_without_account_id	array	—	Exchanges in the day’s total whose data carries no account identifier; their liquidations are not part of `account_count`. peut être absent
data[].account_count_meta.coverage.exchanges_without_account_id[]	string	—	Identifiant de la plateforme.
data[].account_count_meta.coverage.by_exchange	array	—	Per-exchange split of `account_count`. peut être absent
data[].account_count_meta.coverage.by_exchange[]	object	—	One exchange.
data[].account_count_meta.coverage.by_exchange[].exchange	string	—	Identifiant de la plateforme.
data[].account_count_meta.coverage.by_exchange[].account_count	number	—	Distinct liquidated accounts on this exchange.
data[].account_count_meta.coverage.by_exchange[].events	number	—	Liquidation events on this exchange that carry an account identifier.
data[].account_count_meta.coverage.by_exchange[].usd	number	USD	Notional of those events.
data[].account_count_meta.coverage.dedup_key	string	—	Fields that identify one account; the same key is counted once per UTC day. peut être absent
data[].account_count_meta.coverage.events_covered	number	—	Liquidation events that carry an account identifier. peut être absent
data[].account_count_meta.coverage.events_total	number	—	All liquidation events of the day (`liquidation_count`). peut être absent
data[].account_count_meta.coverage.events_share_pct	number	%	`events_covered` / `events_total` × 100. peut être absent
data[].account_count_meta.coverage.usd_covered	number	USD	Notional of the events that carry an account identifier. peut être absent
data[].account_count_meta.coverage.usd_total	number	USD	Total notional of the day (`total_usd`). peut être absent
data[].account_count_meta.coverage.usd_share_pct	number	%	`usd_covered` / `usd_total` × 100. peut être absent
threshold_usd	number	USD	`total_usd` of the 10th row. A new CoinBoss day is added only when its total is greater than this value.
coverage	object	—	Ce qui est inclus et ce qui manque.
coverage.ranking	string	—	Ordering rule of the list.
coverage.baseline	object	—
coverage.baseline.source	string	—	Origin of the baseline rows.
coverage.baseline.rows_in_list	number	—	Number of baseline rows among the 10 rows returned.
coverage.baseline.frozen	boolean	—	Always `true`: baseline rows are never recalculated.
coverage.baseline.checksum_ok	boolean	—	`true` when the stored baseline rows are byte-identical to the locked reference copy.
coverage.baseline.note	string	—	Plain-language description of the baseline rows.
coverage.coinboss	object	—
coverage.coinboss.source	string	—	Origin of the CoinBoss rows.
coverage.coinboss.basis	string	—	Aggregation basis of the CoinBoss rows.
coverage.coinboss.rows_in_list	number	—	Number of CoinBoss rows among the 10 rows returned.
coverage.coinboss.from	string	—	Earliest `event_date` among the CoinBoss rows in the list; null when there are none.
coverage.coinboss.note	string	—	Plain-language description of the CoinBoss rows and the admission rule.
coverage.metrics	object	—	Definitions of the count fields and the BTC fields.
coverage.metrics.people_count	object	—	Status of a liquidated-trader (people) count.
coverage.metrics.people_count.quality	string	—	Always `UNAVAILABLE`: CoinBoss does not publish a people count.
coverage.metrics.people_count.note	string	—	Plain-language explanation of why a people count is not available.
coverage.metrics.liquidation_count	object	—	Definition of `data[].liquidation_count`.
coverage.metrics.liquidation_count.kind	string	—	What the number counts: `liquidation_events`.
coverage.metrics.liquidation_count.rows	string	—	Rows that carry the field: `coinboss` or `all`.
coverage.metrics.liquidation_count.definition	string	—	Plain-language definition.
coverage.metrics.liquidation_count.dedup_key	string	—	Fields that identify one liquidation event; records with the same key are counted once.
coverage.metrics.liquidation_count.limits	string	—	Known limits of the figure.
coverage.metrics.account_count	object	—	Definition of `data[].account_count`.
coverage.metrics.account_count.kind	string	—	What the number counts: `unique_accounts`.
coverage.metrics.account_count.rows	string	—	Rows that carry the field: `coinboss` or `all`.
coverage.metrics.account_count.definition	string	—	Plain-language definition.
coverage.metrics.account_count.dedup_key	string	—	Fields that identify one account; the same key is counted once per UTC day.
coverage.metrics.btc_range	object	—	Definition of `data[].btc_high`, `btc_low`, `btc_range` and `btc_range_pct`.
coverage.metrics.btc_range.source	string	—	Origin of the prices: `coinboss_spot_composite`, built from the spot daily candles CoinBoss collects from the three venues.
coverage.metrics.btc_range.method	string	—	Calculation method: median of the three venues’ daily highs, and median of their daily lows.
coverage.metrics.btc_range.price_type	string	—	Kind of price used: `spot`.
coverage.metrics.btc_range.unit	string	—	Unit of the BTC price fields: `USD`.
coverage.metrics.btc_range.window	string	—	Time window of the prices, in words.
coverage.metrics.btc_range.venues	array	—	The three spot venues the calculation requires.
coverage.metrics.btc_range.venues[]	object	—	One venue.
coverage.metrics.btc_range.venues[].exchange	string	—	Identifiant de la plateforme.
coverage.metrics.btc_range.venues[].pair	string	—	Trading pair of the daily candle.
coverage.metrics.btc_range.venues[].market	string	—	Market type: `spot`.
coverage.metrics.btc_range.definition	string	—	Plain-language definition.
coverage.metrics.btc_range.limits	string	—	Known limits of the figure.
coverage.metrics.btc_range.rows	string	—	Rows that carry the field: `coinboss` or `all`.

Généré à partir de 1 réponses réelles (2026-11-12 10:27 UTC).

Exemple de réponse

/api/liquidation-events · Réponse réelle (capture : 2026-11-13 03:57:53 UTC). Les tableaux et dictionnaires longs sont abrégés pour l'affichage : data comptait 10 éléments; coverage.metrics.btc_range.venues comptait 3 éléments; data[].btc_range_meta.coverage.venues comptait 3 éléments.

{
- "success": true,
- "count": 10,
- "data": [
  - { … 22 },
  - { … 22 }
  ],
- "threshold_usd": 2768000000,
- "coverage": {
  - "ranking": "top10_by_total_usd_desc",
  - "baseline": { … 5 },
  - "coinboss": { … 5 },
  - "metrics": { … 4 }
  }
}

Détails

Authentification: Aucune. Endpoint public.
Limite de requêtes: 1200 requêtes par minute et par IP
Cache serveur: 5m
Micro-cache en périphérie: 10s
Fréquence de mise à jour: tous les jours à 02:30 UTC
Fenêtre: All time for baseline rows; CoinBoss rows start on 2026-08-19 and run to yesterday (UTC).
Sources de données: Baseline rows: third-party public historical records (static, not refreshed). CoinBoss rows: CoinBoss's own liquidation records collected from exchange feeds, de-duplicated and summed per UTC day. BTC prices (all rows): spot daily candles (UTC) that CoinBoss collects from Binance (BTC/USDT), Coinbase (BTC/USD) and Kraken (BTC/USD).
Couverture des plateformes: 10 rows. Baseline rows carry the third-party figures as recorded (`liquidated_traders`, `btc_amplitude`, `event_zh`). CoinBoss does not publish a liquidated-trader (people) count: exchange feeds do not identify people. `liquidation_count` and `account_count` exist for CoinBoss rows only, and `account_count` covers only exchanges whose data carries an account identifier (currently Hyperliquid). `btc_high`, `btc_low`, `btc_range` and `btc_range_pct` are computed for every row and are null unless all three spot venues have a final daily candle.
Tri: total_usd desc (rank_no asc)
Unités: total_usd / amount_usd / long_usd / short_usd / threshold_usd / btc_high / btc_low / btc_range in USD; btc_range_pct in percent; liquidation_count in events; account_count in accounts; event_date as calendar date; amount_display, liquidated_traders, btc_amplitude are display strings
Méthode: CoinBoss rows: SUM(value_usd) of collected liquidation orders per UTC day after de-duplication. A new day is admitted when its total_usd is greater than the total_usd of rank 10. All rows are then sorted by total_usd and the first 10 are returned. Baseline rows are not recomputed. BTC: btc_high / btc_low = median of the daily high / low of the three spot venues; btc_range = btc_high − btc_low; btc_range_pct = (btc_high − btc_low) / btc_low × 100.
Horodatages: Millisecondes depuis l'epoch Unix (UTC), sauf indication contraire dans la description du champ
Format de réponse: json
Stabilité: Stable

Statut en direct

DisponibleVérifié : 2026-11-13 03:57:53 UTCHTTP 2001 msSchéma conforme

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 →

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

GET/api/liquidation-eventsDisponible

Paramètres

Aucun paramètre.

URL de la requêtehttps://www.coinboss.com/api/liquidation-events

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.

Synthèse des liquidations d'une crypto /api/sd/liquidations
Jours de plus fortes liquidations (Top 10) /api/liquidation-events
Ordres de liquidation bruts (24h) /api/liquidations
Toutes les cryptos ayant un historique de liquidations /api/liquidations/all-coins
Série temporelle des liquidations sur 24h pour un symbole de contrat /api/liquidations/chart
Répartition des liquidations d'une crypto par plateforme /api/liquidations/coin-exchanges
Plus gros ordres de liquidation d'une crypto /api/liquidations/coin-largest
Cryptos ayant des liquidations dans la fenêtre /api/liquidations/coin-list
Totaux de liquidations d'une crypto sur plusieurs fenêtres /api/liquidations/coin-overview
Courbe de prix superposée aux barres de liquidations d'une crypto /api/liquidations/coin-price-liq
Statistiques de liquidations d'une crypto /api/liquidations/coin-stats
Série temporelle des liquidations d'une crypto /api/liquidations/coin-total-chart
Classement des liquidations agrégées par crypto /api/liquidations/coins
Tableau des liquidations par crypto /api/liquidations/coins-table
Détail des liquidations d'une plateforme /api/liquidations/exchange-detail
Notionnel liquidé et part par plateforme /api/liquidations/exchanges
Flux des liquidations de tout le marché /api/liquidations/feed
Plus gros ordres de liquidation de tout le marché /api/liquidations/largest
Totaux de liquidations de tout le marché (1h / 4h / 12h / 24h) /api/liquidations/overview
Statistiques de liquidations 24h par plateforme, contrat et sens /api/liquidations/stats
Série temporelle des liquidations de tout le marché /api/liquidations/total-chart
Classement des liquidations par crypto /api/market/liq-rank
Flux en direct des grosses liquidations /api/market/liq-stream