Bitcoin Liquidations

Daily long and short Bitcoin futures liquidations by exchange.

How to call

Request format

GET
curl -X GET "https://newhedge.io/api/v2/metrics/liquidations/METRIC_NAME?api_token=YOUR_TOKEN"
Query params

api_token (required) — 24 character token.

resolution (optional) — 1d only for the metrics on this chart. A finer value is refused, never served as 1d: 401 when the token is not entitled to finer buckets, 400 when it is entitled and the metric does not ingest that bucket; see Resolutions.

before (optional) — exclusive cursor, returns observations older than this timestamp_ms. Works on every resolution.

limit (optional) — the most recent N observations, maximum 5000. Finer resolutions page by default (2500); a 1d request returns the whole series unless you send limit or before.

before and limit narrow a time series. A response with no single time axis, such as a hash keyed by venue or a labelled snapshot table, has nothing to cut on. It is returned whole, and both parameters are ignored rather than rejected.

A before that is not a positive epoch-millisecond timestamp is a 400. It is the one paging value we reject rather than ignore, because a page size has a sensible default and a cursor does not.

include (optional) — definition wraps the response as {"definition": …, "data": …} and returns the record shown under each metric; see Definitions. Any other value is a 400.

Path params

:metric_name — one of the metric names listed below.

Responses

200 with JSON payload, 400 for an unknown include value, 401 for missing/invalid token, 404 for missing resources. A 404 for a metric withdrawn on purpose adds withdrawn, withdrawn_on and reason, for example {"error":"Metric not found","withdrawn":true,"withdrawn_on":"2026-09-07","reason":"The venue's public feed reports insurance-fund settlements, not liquidation orders."}; a removed chart can add successor.

Plan and quota refusals keep these statuses and error texts and add code, required_plan, current_plan, feature, upgrade_url, limit and resets_at where they apply. A Pro token whose history window removed points also gets the X-Newhedge-History-Truncated headers, and for a Pro token X-Newhedge-Available-From is the start of the window. See Errors and plan limits.

Metrics

Each metric is fetched independently. Responses are trimmed samples to show structure.

16 metrics
Metric

Kraken Longbitcoin_liquidations_kraken_long

Data used by the Bitcoin Liquidations chart.

Resolutions: 1d only.

Endpoint
https://newhedge.io/api/v2/metrics/liquidations/bitcoin_liquidations_kraken_long?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response
[
  [
    1792972800000,
    4254.696900000001
  ],
  [
    1793059200000,
    0.0
  ],
  [
    1793145600000,
    0.0
  ]
]
Definition

Value: Daily liquidated notional on one venue for one side, in US dollars. The long series is stored POSITIVE and the short series is stored NEGATIVE, so a short liquidation plots below zero. A venue-day is written, including 0, only when collection coverage for that day is at least 95%; otherwise the day is absent, which is neither 0 nor null.

Units: usd

Timestamp: Labelled 00:00 UTC of the day it describes.

Calendar: calendar_daily

Revision policy: window_revised (8-day window). A late fill can revise or add a venue-day for up to 8 days after the day ends.

Universe: Major Bitcoin derivatives venues.

Methodology version: 2026-10-09

Metric

Kraken Shortbitcoin_liquidations_kraken_short

Data used by the Bitcoin Liquidations chart.

Resolutions: 1d only.

Endpoint
https://newhedge.io/api/v2/metrics/liquidations/bitcoin_liquidations_kraken_short?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response
[
  [
    1792972800000,
    -449.7528
  ],
  [
    1793059200000,
    -516309.833
  ],
  [
    1793145600000,
    -693170.1058000001
  ]
]
Definition

Value: Daily liquidated notional on one venue for one side, in US dollars. The long series is stored POSITIVE and the short series is stored NEGATIVE, so a short liquidation plots below zero. A venue-day is written, including 0, only when collection coverage for that day is at least 95%; otherwise the day is absent, which is neither 0 nor null.

Units: usd

Timestamp: Labelled 00:00 UTC of the day it describes.

Calendar: calendar_daily

Revision policy: window_revised (8-day window). A late fill can revise or add a venue-day for up to 8 days after the day ends.

Universe: Major Bitcoin derivatives venues.

Methodology version: 2026-10-09

Metric

HTX Longbitcoin_liquidations_huobi_long

Data used by the Bitcoin Liquidations chart.

Resolutions: 1d only.

Endpoint
https://newhedge.io/api/v2/metrics/liquidations/bitcoin_liquidations_huobi_long?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response
[
  [
    1792972800000,
    421909.8747999998
  ],
  [
    1793059200000,
    21341.0705
  ],
  [
    1793145600000,
    476197.62239999993
  ]
]
Definition

Value: Daily liquidated notional on one venue for one side, in US dollars. The long series is stored POSITIVE and the short series is stored NEGATIVE, so a short liquidation plots below zero. A venue-day is written, including 0, only when collection coverage for that day is at least 95%; otherwise the day is absent, which is neither 0 nor null.

Units: usd

Timestamp: Labelled 00:00 UTC of the day it describes.

Calendar: calendar_daily

Revision policy: window_revised (8-day window). A late fill can revise or add a venue-day for up to 8 days after the day ends.

Universe: Major Bitcoin derivatives venues.

Methodology version: 2026-10-09

Metric

HTX Shortbitcoin_liquidations_huobi_short

Data used by the Bitcoin Liquidations chart.

Resolutions: 1d only.

Endpoint
https://newhedge.io/api/v2/metrics/liquidations/bitcoin_liquidations_huobi_short?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response
[
  [
    1792972800000,
    -143386.876
  ],
  [
    1793059200000,
    -1040652.2777
  ],
  [
    1793145600000,
    -181826.82439999992
  ]
]
Definition

Value: Daily liquidated notional on one venue for one side, in US dollars. The long series is stored POSITIVE and the short series is stored NEGATIVE, so a short liquidation plots below zero. A venue-day is written, including 0, only when collection coverage for that day is at least 95%; otherwise the day is absent, which is neither 0 nor null.

Units: usd

Timestamp: Labelled 00:00 UTC of the day it describes.

Calendar: calendar_daily

Revision policy: window_revised (8-day window). A late fill can revise or add a venue-day for up to 8 days after the day ends.

Universe: Major Bitcoin derivatives venues.

Methodology version: 2026-10-09

Metric

Bitfinex Longbitcoin_liquidations_bitfinex_long

Data used by the Bitcoin Liquidations chart.

Resolutions: 1d only.

Endpoint
https://newhedge.io/api/v2/metrics/liquidations/bitcoin_liquidations_bitfinex_long?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response
[
  [
    1792972800000,
    6671.392
  ],
  [
    1793059200000,
    0.0
  ],
  [
    1793145600000,
    0.0
  ]
]
Definition

Value: Daily liquidated notional on one venue for one side, in US dollars. The long series is stored POSITIVE and the short series is stored NEGATIVE, so a short liquidation plots below zero. A venue-day is written, including 0, only when collection coverage for that day is at least 95%; otherwise the day is absent, which is neither 0 nor null.

Units: usd

Timestamp: Labelled 00:00 UTC of the day it describes.

Calendar: calendar_daily

Revision policy: window_revised (8-day window). A late fill can revise or add a venue-day for up to 8 days after the day ends.

Universe: Major Bitcoin derivatives venues.

Methodology version: 2026-10-09

Metric

Bitfinex Shortbitcoin_liquidations_bitfinex_short

Data used by the Bitcoin Liquidations chart.

Resolutions: 1d only.

Endpoint
https://newhedge.io/api/v2/metrics/liquidations/bitcoin_liquidations_bitfinex_short?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response
[
  [
    1792972800000,
    0.0
  ],
  [
    1793059200000,
    -8.125300000000001
  ],
  [
    1793145600000,
    0.0
  ]
]
Definition

Value: Daily liquidated notional on one venue for one side, in US dollars. The long series is stored POSITIVE and the short series is stored NEGATIVE, so a short liquidation plots below zero. A venue-day is written, including 0, only when collection coverage for that day is at least 95%; otherwise the day is absent, which is neither 0 nor null.

Units: usd

Timestamp: Labelled 00:00 UTC of the day it describes.

Calendar: calendar_daily

Revision policy: window_revised (8-day window). A late fill can revise or add a venue-day for up to 8 days after the day ends.

Universe: Major Bitcoin derivatives venues.

Methodology version: 2026-10-09

Metric

Binance Shortbitcoin_liquidations_binance_short

Data used by the Bitcoin Liquidations chart.

Resolutions: 1d only.

Endpoint
https://newhedge.io/api/v2/metrics/liquidations/bitcoin_liquidations_binance_short?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response
[
  [
    1792972800000,
    -9193989.507600008
  ],
  [
    1793059200000,
    -8908271.069499997
  ],
  [
    1793145600000,
    -16062154.82230002
  ]
]
Definition

Value: Daily liquidated notional on one venue for one side, in US dollars. The long series is stored POSITIVE and the short series is stored NEGATIVE, so a short liquidation plots below zero. A venue-day is written, including 0, only when collection coverage for that day is at least 95%; otherwise the day is absent, which is neither 0 nor null.

Units: usd

Timestamp: Labelled 00:00 UTC of the day it describes.

Calendar: calendar_daily

Revision policy: window_revised (8-day window). A late fill can revise or add a venue-day for up to 8 days after the day ends.

Universe: Major Bitcoin derivatives venues.

Methodology version: 2026-10-09

Metric

Bybit Shortbitcoin_liquidations_bybit_short

Data used by the Bitcoin Liquidations chart.

Resolutions: 1d only.

Endpoint
https://newhedge.io/api/v2/metrics/liquidations/bitcoin_liquidations_bybit_short?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response
[
  [
    1792972800000,
    -1611398.6779
  ],
  [
    1793059200000,
    -3739358.7222
  ],
  [
    1793145600000,
    -3622340.5732999993
  ]
]
Definition

Value: Daily liquidated notional on one venue for one side, in US dollars. The long series is stored POSITIVE and the short series is stored NEGATIVE, so a short liquidation plots below zero. A venue-day is written, including 0, only when collection coverage for that day is at least 95%; otherwise the day is absent, which is neither 0 nor null.

Units: usd

Timestamp: Labelled 00:00 UTC of the day it describes.

Calendar: calendar_daily

Revision policy: window_revised (8-day window). A late fill can revise or add a venue-day for up to 8 days after the day ends.

Universe: Major Bitcoin derivatives venues.

Methodology version: 2026-10-09

Metric

OKX Shortbitcoin_liquidations_okx_short

Data used by the Bitcoin Liquidations chart.

Resolutions: 1d only.

Endpoint
https://newhedge.io/api/v2/metrics/liquidations/bitcoin_liquidations_okx_short?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response
[
  [
    1792972800000,
    -4463231.731160003
  ],
  [
    1793059200000,
    -3888072.468219998
  ],
  [
    1793145600000,
    -6995850.99055001
  ]
]
Definition

Value: Daily liquidated notional on one venue for one side, in US dollars. The long series is stored POSITIVE and the short series is stored NEGATIVE, so a short liquidation plots below zero. A venue-day is written, including 0, only when collection coverage for that day is at least 95%; otherwise the day is absent, which is neither 0 nor null.

Units: usd

Timestamp: Labelled 00:00 UTC of the day it describes.

Calendar: calendar_daily

Revision policy: window_revised (8-day window). A late fill can revise or add a venue-day for up to 8 days after the day ends.

Universe: Major Bitcoin derivatives venues.

Methodology version: 2026-10-09

Metric

Binance Longbitcoin_liquidations_binance_long

Data used by the Bitcoin Liquidations chart.

Resolutions: 1d only.

Endpoint
https://newhedge.io/api/v2/metrics/liquidations/bitcoin_liquidations_binance_long?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response
[
  [
    1792972800000,
    13059527.980600009
  ],
  [
    1793059200000,
    3086267.800400004
  ],
  [
    1793145600000,
    6330116.886700002
  ]
]
Definition

Value: Daily liquidated notional on one venue for one side, in US dollars. The long series is stored POSITIVE and the short series is stored NEGATIVE, so a short liquidation plots below zero. A venue-day is written, including 0, only when collection coverage for that day is at least 95%; otherwise the day is absent, which is neither 0 nor null.

Units: usd

Timestamp: Labelled 00:00 UTC of the day it describes.

Calendar: calendar_daily

Revision policy: window_revised (8-day window). A late fill can revise or add a venue-day for up to 8 days after the day ends.

Universe: Major Bitcoin derivatives venues.

Methodology version: 2026-10-09

Metric

Bybit Longbitcoin_liquidations_bybit_long

Data used by the Bitcoin Liquidations chart.

Resolutions: 1d only.

Endpoint
https://newhedge.io/api/v2/metrics/liquidations/bitcoin_liquidations_bybit_long?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response
[
  [
    1792972800000,
    3543814.270900002
  ],
  [
    1793059200000,
    783731.9397000005
  ],
  [
    1793145600000,
    2104295.800100001
  ]
]
Definition

Value: Daily liquidated notional on one venue for one side, in US dollars. The long series is stored POSITIVE and the short series is stored NEGATIVE, so a short liquidation plots below zero. A venue-day is written, including 0, only when collection coverage for that day is at least 95%; otherwise the day is absent, which is neither 0 nor null.

Units: usd

Timestamp: Labelled 00:00 UTC of the day it describes.

Calendar: calendar_daily

Revision policy: window_revised (8-day window). A late fill can revise or add a venue-day for up to 8 days after the day ends.

Universe: Major Bitcoin derivatives venues.

Methodology version: 2026-10-09

Metric

OKX Longbitcoin_liquidations_okx_long

Data used by the Bitcoin Liquidations chart.

Resolutions: 1d only.

Endpoint
https://newhedge.io/api/v2/metrics/liquidations/bitcoin_liquidations_okx_long?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response
[
  [
    1792972800000,
    6133024.597449996
  ],
  [
    1793059200000,
    1313514.98741
  ],
  [
    1793145600000,
    3327449.846659998
  ]
]
Definition

Value: Daily liquidated notional on one venue for one side, in US dollars. The long series is stored POSITIVE and the short series is stored NEGATIVE, so a short liquidation plots below zero. A venue-day is written, including 0, only when collection coverage for that day is at least 95%; otherwise the day is absent, which is neither 0 nor null.

Units: usd

Timestamp: Labelled 00:00 UTC of the day it describes.

Calendar: calendar_daily

Revision policy: window_revised (8-day window). A late fill can revise or add a venue-day for up to 8 days after the day ends.

Universe: Major Bitcoin derivatives venues.

Methodology version: 2026-10-09

Metric

Lighter Longbitcoin_liquidations_lighter_long

Data used by the Bitcoin Liquidations chart.

Resolutions: 1d only.

Endpoint
https://newhedge.io/api/v2/metrics/liquidations/bitcoin_liquidations_lighter_long?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response
[
  [
    1792972800000,
    126597.230308
  ],
  [
    1793059200000,
    224.544406
  ],
  [
    1793145600000,
    1303.925281
  ]
]
Definition

Value: Daily liquidated notional on one venue for one side, in US dollars. The long series is stored POSITIVE and the short series is stored NEGATIVE, so a short liquidation plots below zero. A venue-day is written, including 0, only when collection coverage for that day is at least 95%; otherwise the day is absent, which is neither 0 nor null.

Units: usd

Timestamp: Labelled 00:00 UTC of the day it describes.

Calendar: calendar_daily

Revision policy: window_revised (8-day window). A late fill can revise or add a venue-day for up to 8 days after the day ends.

Universe: Major Bitcoin derivatives venues.

Methodology version: 2026-10-09

Metric

Lighter Shortbitcoin_liquidations_lighter_short

Data used by the Bitcoin Liquidations chart.

Resolutions: 1d only.

Endpoint
https://newhedge.io/api/v2/metrics/liquidations/bitcoin_liquidations_lighter_short?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response
[
  [
    1792972800000,
    -2378.632769
  ],
  [
    1793059200000,
    -43243.107009
  ],
  [
    1793145600000,
    -351014.1916080001
  ]
]
Definition

Value: Daily liquidated notional on one venue for one side, in US dollars. The long series is stored POSITIVE and the short series is stored NEGATIVE, so a short liquidation plots below zero. A venue-day is written, including 0, only when collection coverage for that day is at least 95%; otherwise the day is absent, which is neither 0 nor null.

Units: usd

Timestamp: Labelled 00:00 UTC of the day it describes.

Calendar: calendar_daily

Revision policy: window_revised (8-day window). A late fill can revise or add a venue-day for up to 8 days after the day ends.

Universe: Major Bitcoin derivatives venues.

Methodology version: 2026-10-09

Metric

Gate Longbitcoin_liquidations_gate_long

Data used by the Bitcoin Liquidations chart.

Resolutions: 1d only.

Endpoint
https://newhedge.io/api/v2/metrics/liquidations/bitcoin_liquidations_gate_long?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response
[
  [
    1792972800000,
    2740622.351535
  ],
  [
    1793059200000,
    1209729.057066
  ],
  [
    1793145600000,
    2024106.214896
  ]
]
Definition

Value: Daily liquidated notional on one venue for one side, in US dollars. The long series is stored POSITIVE and the short series is stored NEGATIVE, so a short liquidation plots below zero. A venue-day is written, including 0, only when collection coverage for that day is at least 95%; otherwise the day is absent, which is neither 0 nor null.

Units: usd

Timestamp: Labelled 00:00 UTC of the day it describes.

Calendar: calendar_daily

Revision policy: window_revised (8-day window). A late fill can revise or add a venue-day for up to 8 days after the day ends.

Universe: Major Bitcoin derivatives venues.

Methodology version: 2026-10-09

Metric

Gate Shortbitcoin_liquidations_gate_short

Data used by the Bitcoin Liquidations chart.

Resolutions: 1d only.

Endpoint
https://newhedge.io/api/v2/metrics/liquidations/bitcoin_liquidations_gate_short?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response
[
  [
    1792972800000,
    -857800.959885
  ],
  [
    1793059200000,
    -4756887.951381
  ],
  [
    1793145600000,
    -4237543.005336
  ]
]
Definition

Value: Daily liquidated notional on one venue for one side, in US dollars. The long series is stored POSITIVE and the short series is stored NEGATIVE, so a short liquidation plots below zero. A venue-day is written, including 0, only when collection coverage for that day is at least 95%; otherwise the day is absent, which is neither 0 nor null.

Units: usd

Timestamp: Labelled 00:00 UTC of the day it describes.

Calendar: calendar_daily

Revision policy: window_revised (8-day window). A late fill can revise or add a venue-day for up to 8 days after the day ends.

Universe: Major Bitcoin derivatives venues.

Methodology version: 2026-10-09