Tage mit den größten Liquidationen (Top 10)

Top 10 der Tagessummen der Liquidationen: historische Basis Dritter plus von CoinBoss erfasste Tage

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.

Anfrage

Dieser Endpunkt hat keine Parameter.

Beispielanfrage

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

Antwortfelder

Die Feldtabelle wird aus echten Antworten erzeugt und führt daher genau das auf, was der Endpunkt zurückgibt. In Pfaden steht a[] für Array-Elemente und {*} für Objekte, deren Schlüssel ein dynamischer Name ist, etwa ein Coin oder eine Börse.

Feld	Typ	Einheit	Beschreibung
success	boolean	—	true, wenn die Anfrage erfolgreich war. Im Fehlerfall lautet der Body `{ success: false, code, error, request_id }`.
count	number	—	Anzahl der Zeilen.
data	array	—	Nutzdaten.
data[]	object	—	Nutzdaten.
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	Liquidierte Long-Positionen.
data[].short_usd	number	USD	Liquidierte Short-Positionen.
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	—	Börsenkennung.
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. kann fehlen
data[].liquidation_count_meta.coverage.exchanges	array	—	Those exchanges. kann fehlen
data[].liquidation_count_meta.coverage.exchanges[]	string	—	Börsenkennung.
data[].liquidation_count_meta.coverage.dedup_key	string	—	Fields that identify one liquidation event; records with the same key are counted once. kann fehlen
data[].liquidation_count_meta.coverage.raw_rows	number	—	Number of collected records before de-duplication. kann fehlen
data[].liquidation_count_meta.coverage.duplicates_removed	number	—	Number of duplicate records dropped. kann fehlen
data[].liquidation_count_meta.coverage.by_exchange	array	—	Per-exchange split of the count; null when no per-exchange snapshot was recorded. kann fehlen
data[].liquidation_count_meta.coverage.by_exchange[]	object	—	One exchange.
data[].liquidation_count_meta.coverage.by_exchange[].exchange	string	—	Börsenkennung.
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. kann fehlen
data[].account_count_meta.coverage.exchange_count	number	—	Number of exchanges whose data carries an account identifier. kann fehlen
data[].account_count_meta.coverage.exchanges	array	—	Those exchanges. kann fehlen
data[].account_count_meta.coverage.exchanges[]	string	—	Börsenkennung.
data[].account_count_meta.coverage.exchanges_total	number	—	Number of exchanges in the day’s total. kann fehlen
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`. kann fehlen
data[].account_count_meta.coverage.exchanges_without_account_id[]	string	—	Börsenkennung.
data[].account_count_meta.coverage.by_exchange	array	—	Per-exchange split of `account_count`. kann fehlen
data[].account_count_meta.coverage.by_exchange[]	object	—	One exchange.
data[].account_count_meta.coverage.by_exchange[].exchange	string	—	Börsenkennung.
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. kann fehlen
data[].account_count_meta.coverage.events_covered	number	—	Liquidation events that carry an account identifier. kann fehlen
data[].account_count_meta.coverage.events_total	number	—	All liquidation events of the day (`liquidation_count`). kann fehlen
data[].account_count_meta.coverage.events_share_pct	number	%	`events_covered` / `events_total` × 100. kann fehlen
data[].account_count_meta.coverage.usd_covered	number	USD	Notional of the events that carry an account identifier. kann fehlen
data[].account_count_meta.coverage.usd_total	number	USD	Total notional of the day (`total_usd`). kann fehlen
data[].account_count_meta.coverage.usd_share_pct	number	%	`usd_covered` / `usd_total` × 100. kann fehlen
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	—	Was enthalten ist und was fehlt.
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	—	Börsenkennung.
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`.

Erzeugt 2026-11-12 10:27 UTC aus 1 echten Antworten.

Beispielantwort

/api/liquidation-events · Echte Antwort, erfasst 2026-11-13 03:57:53 UTC. Lange Arrays und Maps sind für die Anzeige gekürzt: data hatte 10 Elemente; coverage.metrics.btc_range.venues hatte 3 Elemente; data[].btc_range_meta.coverage.venues hatte 3 Elemente.

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

Details

Authentifizierung: Keine. Öffentlicher Endpunkt.
Rate-Limit: 1200 Anfragen pro Minute und IP
Server-Cache: 5m
Edge-Micro-Cache: 10s
Aktualisierungsintervall: täglich um 02:30 UTC
Zeitfenster: All time for baseline rows; CoinBoss rows start on 2026-08-19 and run to yesterday (UTC).
Datenquellen: 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).
Börsenabdeckung: 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.
Sortierung: total_usd desc (rank_no asc)
Einheiten: 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
Methode: 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.
Zeitstempel: Unix-Epoche in Millisekunden (UTC), sofern die Feldbeschreibung nichts anderes angibt
Antwortformat: json
Stabilität: Stabil

Live-Status

VerfügbarGeprüft 2026-11-13 03:57:53 UTCHTTP 2001 msSchema stimmt überein

Verfügbarkeit, letzte 30 Tage

100 % von 410 Prüfungen bestanden

Fehler

Fehlgeschlagene Aufrufe haben auf jedem Endpunkt denselben Aufbau. Die vollständige Liste steht auf der Fehlerseite. Fehler und Rate-Limits →

Code	HTTP	Bedeutung	Empfohlene Reaktion
INVALID_PARAM	400	Ein erforderlicher Parameter fehlt oder ein Wert wird nicht akzeptiert. `param` nennt den Parameter, sofern er bekannt ist.	Nicht unverändert wiederholen; die Anfrage korrigieren.
UNAUTHORIZED	401	Der Header `CB-API-KEY` wurde gesendet, der Schlüssel ist jedoch unbekannt oder widerrufen. Öffentliche Daten erfordern keinen Schlüssel – lassen Sie den Header weg oder verwenden Sie einen gültigen Schlüssel.	Nicht unverändert wiederholen.
FORBIDDEN	403	Die Route gehört nicht zur öffentlichen API (intern oder nur für Konten).	Nicht wiederholen.
NOT_FOUND	404	Unbekannte Route, oder der angefragte Coin / die Börse / der Fonds existiert nicht.	Nicht wiederholen; Pfad und Kennungen mit dem Katalog abgleichen.
RATE_LIMITED	429	Mehr Anfragen, als das Limit pro Minute zulässt. `Retry-After` gibt die Wartezeit in Sekunden an.	`Retry-After` abwarten, dann mit Backoff wiederholen.
INTERNAL	500	Unerwarteter Serverfehler. Die Meldung ist bewusst allgemein gehalten; geben Sie `request_id` an, wenn Sie den Fehler melden.	Einmal nach einigen Sekunden wiederholen; wenn der Fehler bestehen bleibt, mit der Request-ID melden.
UPSTREAM_FAILED	503	Die Datenquelle hinter diesem Endpunkt hat nicht rechtzeitig geantwortet. Es werden ersatzweise keine veralteten oder stellvertretenden Zahlen zurückgegeben.	Mit Backoff wiederholen; die Statusseite prüfen.
UNAVAILABLE	501 / 503	Der Datensatz ist vorübergehend nicht bereit (Cache wird aufgewärmt), oder der Endpunkt hat noch keine rechtmäßige öffentliche Quelle.	Später wiederholen; der Katalog kennzeichnet Endpunkte, die konzeptbedingt nicht verfügbar sind.
REQUEST_FAILED	200	Einige ältere Endpunkte antworten mit HTTP 200 und `success: false`. Prüfen Sie immer `success`, nicht nur den HTTP-Status.	Hängt von der Meldung ab; als fehlgeschlagene Anfrage behandeln.

Ausprobieren

GET/api/liquidation-eventsVerfügbar

Parameter

Keine Parameter.

Anfrage-URLhttps://www.coinboss.com/api/liquidation-events

Wählen Sie einen Endpunkt und klicken Sie auf „Anfrage senden“. Antwort, Header und Laufzeit erscheinen hier.

Liquidationsübersicht für einen Coin /api/sd/liquidations
Tage mit den größten Liquidationen (Top 10) /api/liquidation-events
Einzelne Liquidationen im Rohformat (24h) /api/liquidations
Alle Coins mit Liquidationsdatensätzen /api/liquidations/all-coins
24h-Liquidationszeitreihe für ein Kontraktsymbol /api/liquidations/chart
Liquidationen eines Coins, aufgeteilt nach Börse /api/liquidations/coin-exchanges
Größte Liquidationsorders für einen Coin /api/liquidations/coin-largest
Coins mit Liquidationen im Zeitfenster /api/liquidations/coin-list
Liquidationssummen eines Coins über mehrere Zeitfenster /api/liquidations/coin-overview
Preislinie mit überlagerten Liquidationsbalken für einen Coin /api/liquidations/coin-price-liq
Liquidationsstatistik für einen Coin /api/liquidations/coin-stats
Liquidationszeitreihe für einen Coin /api/liquidations/coin-total-chart
Liquidations-Rangliste, je Coin aggregiert /api/liquidations/coins
Liquidationstabelle je Coin /api/liquidations/coins-table
Liquidationsdetails für eine Börse /api/liquidations/exchange-detail
Liquidations-Nominalwert und Anteil je Börse /api/liquidations/exchanges
Marktweiter Liquidations-Feed /api/liquidations/feed
Größte Liquidationsorders marktweit /api/liquidations/largest
Marktweite Liquidationssummen (1h / 4h / 12h / 24h) /api/liquidations/overview
24h-Liquidationsstatistik nach Börse, Kontrakt und Seite /api/liquidations/stats
Marktweite Liquidationszeitreihe /api/liquidations/total-chart
Liquidations-Ranking je Coin /api/market/liq-rank
Live-Stream großer Liquidationen /api/market/liq-stream