청산 규모가 가장 큰 날(Top 10)

일일 청산 총액 상위 10: 제3자 과거 기준 데이터와 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.

요청

이 엔드포인트에는 파라미터가 없습니다.

요청 예시

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

응답 필드

필드 표는 실제 응답에서 생성되므로 엔드포인트가 반환하는 내용을 그대로 보여 줍니다. 경로에서 a[]는 배열 항목을, {*}는 코인이나 거래소처럼 동적 이름을 키로 갖는 객체를 뜻합니다.

필드	타입	단위	설명
success	boolean	—	요청이 성공하면 true입니다. 실패하면 본문은 `{ success: false, code, error, request_id }`입니다.
count	number	—	행 수.
data	array	—	페이로드.
data[]	object	—	페이로드.
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	롱 청산액.
data[].short_usd	number	USD	숏 청산액.
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	—	거래소 ID.
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. 없을 수 있음
data[].liquidation_count_meta.coverage.exchanges	array	—	Those exchanges. 없을 수 있음
data[].liquidation_count_meta.coverage.exchanges[]	string	—	거래소 ID.
data[].liquidation_count_meta.coverage.dedup_key	string	—	Fields that identify one liquidation event; records with the same key are counted once. 없을 수 있음
data[].liquidation_count_meta.coverage.raw_rows	number	—	Number of collected records before de-duplication. 없을 수 있음
data[].liquidation_count_meta.coverage.duplicates_removed	number	—	Number of duplicate records dropped. 없을 수 있음
data[].liquidation_count_meta.coverage.by_exchange	array	—	Per-exchange split of the count; null when no per-exchange snapshot was recorded. 없을 수 있음
data[].liquidation_count_meta.coverage.by_exchange[]	object	—	One exchange.
data[].liquidation_count_meta.coverage.by_exchange[].exchange	string	—	거래소 ID.
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. 없을 수 있음
data[].account_count_meta.coverage.exchange_count	number	—	Number of exchanges whose data carries an account identifier. 없을 수 있음
data[].account_count_meta.coverage.exchanges	array	—	Those exchanges. 없을 수 있음
data[].account_count_meta.coverage.exchanges[]	string	—	거래소 ID.
data[].account_count_meta.coverage.exchanges_total	number	—	Number of exchanges in the day’s total. 없을 수 있음
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`. 없을 수 있음
data[].account_count_meta.coverage.exchanges_without_account_id[]	string	—	거래소 ID.
data[].account_count_meta.coverage.by_exchange	array	—	Per-exchange split of `account_count`. 없을 수 있음
data[].account_count_meta.coverage.by_exchange[]	object	—	One exchange.
data[].account_count_meta.coverage.by_exchange[].exchange	string	—	거래소 ID.
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. 없을 수 있음
data[].account_count_meta.coverage.events_covered	number	—	Liquidation events that carry an account identifier. 없을 수 있음
data[].account_count_meta.coverage.events_total	number	—	All liquidation events of the day (`liquidation_count`). 없을 수 있음
data[].account_count_meta.coverage.events_share_pct	number	%	`events_covered` / `events_total` × 100. 없을 수 있음
data[].account_count_meta.coverage.usd_covered	number	USD	Notional of the events that carry an account identifier. 없을 수 있음
data[].account_count_meta.coverage.usd_total	number	USD	Total notional of the day (`total_usd`). 없을 수 있음
data[].account_count_meta.coverage.usd_share_pct	number	%	`usd_covered` / `usd_total` × 100. 없을 수 있음
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	—	포함된 항목과 누락된 항목.
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	—	거래소 ID.
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`.

2026-11-12 10:27 UTC에 실제 응답 1건으로 생성.

응답 예시

/api/liquidation-events · 2026-11-13 03:57:53 UTC에 수집한 실제 응답. 긴 배열과 맵은 표시를 위해 줄였습니다: data: 원래 항목 10개; coverage.metrics.btc_range.venues: 원래 항목 3개; data[].btc_range_meta.coverage.venues: 원래 항목 3개.

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

상세 정보

인증: 없음. 공개 엔드포인트.
요청 한도: IP당 분당 1200회
서버 캐시: 5m
엣지 마이크로 캐시: 10s
갱신 주기: 매일 02:30 UTC
구간: All time for baseline rows; CoinBoss rows start on 2026-08-19 and run to yesterday (UTC).
데이터 소스: 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).
거래소 커버리지: 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.
정렬: total_usd desc (rank_no asc)
단위: 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
산출 방식: 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.
타임스탬프: 필드 설명에 별도 언급이 없는 한 Unix epoch 밀리초(UTC)
응답 형식: json
안정성: 안정

실시간 상태

사용 가능2026-11-13 03:57:53 UTC 점검HTTP 2001 ms스키마 일치

최근 30일 가용성

점검 410회 중 100% 통과

오류

실패한 호출은 모든 엔드포인트에서 동일한 구조로 반환됩니다. 전체 목록은 오류 페이지에 있습니다. 오류 및 요청 한도 →

코드	HTTP	의미	대응 방법
INVALID_PARAM	400	필수 파라미터가 누락되었거나 허용되지 않는 값입니다. 문제가 된 파라미터를 알 수 있으면 `param`에 그 이름이 들어갑니다.	그대로 재시도하지 말고 요청을 수정하십시오.
UNAUTHORIZED	401	`CB-API-KEY` 헤더를 보냈지만 알 수 없거나 폐기된 키입니다. 공개 데이터에는 키가 필요 없으므로 헤더를 빼거나 유효한 키를 사용하십시오.	그대로 재시도하지 마십시오.
FORBIDDEN	403	해당 경로는 공개 API에 포함되지 않습니다(내부용 또는 계정 전용).	재시도하지 마십시오.
NOT_FOUND	404	알 수 없는 경로이거나, 요청한 코인 / 거래소 / 펀드가 존재하지 않습니다.	재시도하지 말고 경로와 식별자를 카탈로그와 대조해 확인하십시오.
RATE_LIMITED	429	요청 수가 분당 한도를 초과했습니다. `Retry-After`가 대기해야 할 초를 알려 줍니다.	`Retry-After`만큼 기다린 뒤 백오프를 적용해 재시도하십시오.
INTERNAL	500	예기치 않은 서버 오류입니다. 메시지는 의도적으로 일반적인 내용만 담습니다. 신고할 때 `request_id`를 인용하십시오.	몇 초 뒤 한 번 재시도하고, 계속되면 요청 ID와 함께 신고하십시오.
UPSTREAM_FAILED	503	이 엔드포인트의 데이터 소스가 제시간에 응답하지 않았습니다. 그 대신 만료된 수치나 대체 수치를 반환하는 일은 없습니다.	백오프를 적용해 재시도하고 상태 페이지를 확인하십시오.
UNAVAILABLE	501 / 503	데이터셋이 일시적으로 준비되지 않았거나(캐시 워밍 중) 엔드포인트에 아직 합법적인 공개 소스가 없습니다.	나중에 재시도하십시오. 설계상 사용 불가인 엔드포인트는 카탈로그에 표시되어 있습니다.
REQUEST_FAILED	200	일부 이전 엔드포인트는 HTTP 200에 `success: false`로 응답합니다. HTTP 상태만 보지 말고 항상 `success`를 확인하십시오.	메시지에 따라 다릅니다. 실패한 요청으로 처리하십시오.

직접 실행

GET/api/liquidation-events사용 가능

파라미터

파라미터 없음.

요청 URLhttps://www.coinboss.com/api/liquidation-events

엔드포인트를 선택하고 “요청 보내기”를 누르십시오. 응답, 헤더, 소요 시간이 여기에 표시됩니다.

단일 코인의 청산 요약 /api/sd/liquidations
청산 규모가 가장 큰 날(Top 10) /api/liquidation-events
원본 청산 체결 내역(24h) /api/liquidations
청산 기록이 있는 전체 코인 /api/liquidations/all-coins
단일 계약 심볼의 24h 청산 시계열 /api/liquidations/chart
단일 코인의 거래소별 청산 비중 /api/liquidations/coin-exchanges
단일 코인의 최대 청산 주문 /api/liquidations/coin-largest
구간 내 청산이 발생한 코인 /api/liquidations/coin-list
단일 코인의 구간별 청산 합계 /api/liquidations/coin-overview
단일 코인의 가격선과 청산 막대 오버레이 /api/liquidations/coin-price-liq
단일 코인의 청산 통계 /api/liquidations/coin-stats
단일 코인의 청산 시계열 /api/liquidations/coin-total-chart
코인별로 집계한 청산 순위 /api/liquidations/coins
코인별 청산 표 /api/liquidations/coins-table
단일 거래소의 청산 상세 /api/liquidations/exchange-detail
거래소별 청산 명목가치와 점유율 /api/liquidations/exchanges
시장 전체 청산 피드 /api/liquidations/feed
시장 전체 최대 청산 주문 /api/liquidations/largest
시장 전체 청산 합계(1h / 4h / 12h / 24h) /api/liquidations/overview
거래소·계약·방향별 24h 청산 통계 /api/liquidations/stats
시장 전체 청산 시계열 /api/liquidations/total-chart
코인별 청산 순위 /api/market/liq-rank
대규모 청산 실시간 스트림 /api/market/liq-stream