Skip to content

Search API documentation

Metrics, companies & guides

Start here

Quickstart Authentication API plans & access Bitcoin prices & OHLCV data
Try

Bitcoin Liquidations API

Daily long and short Bitcoin futures liquidations by exchange.

Request

GET
curl -H "Authorization: Bearer YOUR_TOKEN" "https://newhedge.io/api/v2/metrics/liquidations/METRIC_NAME"
Parameters & responses
Query params

Authorization: Bearer YOUR_TOKEN (required) — your 24 character API key (also accepted: the X-API-Key header or the api_token query parameter).

resolution (optional) — 1d (default), 1h, coarsest to finest. Finer buckets are served to Advanced and Enterprise accounts, and only for the metrics that ingest them (listed per metric below); 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. On a metric keyed by exchange or tenor they apply to each series, and the keys stay where they are. A response with no time axis, such as 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, 429 when the monthly limit is reached. 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 their error texts and add code, required_plan, current_plan, feature, upgrade_url, limit and resets_at where they apply. The 429 for a used-up monthly allowance carries Retry-After, X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset. 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.

Every 404 and 400 also carries a machine code and, where a list of valid names exists, up to 3 did_you_mean spellings, catalog_url and docs_url. Two different keys in one request are a 400 with code: conflicting_credentials. Only a successful response spends one call from the monthly allowance. A refused or failed call (any 4xx or 5xx, a conflict between credentials, an unknown path) spends nothing, and the request-rate limits are unchanged. The full list of codes is under Errors on the introduction page.

Metrics

One request per metric.

16 metrics
Metric

Kraken Longbitcoin_liquidations_kraken_long

Resolutions: 1d, 1h.

Endpoint
curl -H "Authorization: Bearer YOUR_TOKEN" "https://newhedge.io/api/v2/metrics/liquidations/bitcoin_liquidations_kraken_long"

Replace `YOUR_TOKEN` with your API token.

Example response
200 Fictional example
[
  [1735516800000,42],
  [1735603200000,42],
  [1735689600000,42]
]
Definition & units 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 (1d): Labelled 00:00 UTC of the day it describes.

Timestamp (finer resolutions): A finer resolution is labelled in UTC at the end of the interval it covers, not at its start. Request include=definition for the selected bucket.

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

Resolutions: 1d, 1h.

Endpoint
curl -H "Authorization: Bearer YOUR_TOKEN" "https://newhedge.io/api/v2/metrics/liquidations/bitcoin_liquidations_kraken_short"

Replace `YOUR_TOKEN` with your API token.

Example response
200 Fictional example
[
  [1735516800000,42],
  [1735603200000,42],
  [1735689600000,42]
]
Definition & units 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 (1d): Labelled 00:00 UTC of the day it describes.

Timestamp (finer resolutions): A finer resolution is labelled in UTC at the end of the interval it covers, not at its start. Request include=definition for the selected bucket.

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

Resolutions: 1d, 1h.

Endpoint
curl -H "Authorization: Bearer YOUR_TOKEN" "https://newhedge.io/api/v2/metrics/liquidations/bitcoin_liquidations_huobi_long"

Replace `YOUR_TOKEN` with your API token.

Example response
200 Fictional example
[
  [1735516800000,42],
  [1735603200000,42],
  [1735689600000,42]
]
Definition & units 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 (1d): Labelled 00:00 UTC of the day it describes.

Timestamp (finer resolutions): A finer resolution is labelled in UTC at the end of the interval it covers, not at its start. Request include=definition for the selected bucket.

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

Resolutions: 1d, 1h.

Endpoint
curl -H "Authorization: Bearer YOUR_TOKEN" "https://newhedge.io/api/v2/metrics/liquidations/bitcoin_liquidations_huobi_short"

Replace `YOUR_TOKEN` with your API token.

Example response
200 Fictional example
[
  [1735516800000,42],
  [1735603200000,42],
  [1735689600000,42]
]
Definition & units 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 (1d): Labelled 00:00 UTC of the day it describes.

Timestamp (finer resolutions): A finer resolution is labelled in UTC at the end of the interval it covers, not at its start. Request include=definition for the selected bucket.

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

Resolutions: 1d, 1h.

Endpoint
curl -H "Authorization: Bearer YOUR_TOKEN" "https://newhedge.io/api/v2/metrics/liquidations/bitcoin_liquidations_bitfinex_long"

Replace `YOUR_TOKEN` with your API token.

Example response
200 Fictional example
[
  [1735516800000,42],
  [1735603200000,42],
  [1735689600000,42]
]
Definition & units 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 (1d): Labelled 00:00 UTC of the day it describes.

Timestamp (finer resolutions): A finer resolution is labelled in UTC at the end of the interval it covers, not at its start. Request include=definition for the selected bucket.

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

Resolutions: 1d, 1h.

Endpoint
curl -H "Authorization: Bearer YOUR_TOKEN" "https://newhedge.io/api/v2/metrics/liquidations/bitcoin_liquidations_bitfinex_short"

Replace `YOUR_TOKEN` with your API token.

Example response
200 Fictional example
[
  [1735516800000,42],
  [1735603200000,42],
  [1735689600000,42]
]
Definition & units 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 (1d): Labelled 00:00 UTC of the day it describes.

Timestamp (finer resolutions): A finer resolution is labelled in UTC at the end of the interval it covers, not at its start. Request include=definition for the selected bucket.

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

Resolutions: 1d, 1h.

Endpoint
curl -H "Authorization: Bearer YOUR_TOKEN" "https://newhedge.io/api/v2/metrics/liquidations/bitcoin_liquidations_binance_short"

Replace `YOUR_TOKEN` with your API token.

Example response
200 Fictional example
[
  [1735516800000,42],
  [1735603200000,42],
  [1735689600000,42]
]
Definition & units 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 (1d): Labelled 00:00 UTC of the day it describes.

Timestamp (finer resolutions): A finer resolution is labelled in UTC at the end of the interval it covers, not at its start. Request include=definition for the selected bucket.

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

Resolutions: 1d, 1h.

Endpoint
curl -H "Authorization: Bearer YOUR_TOKEN" "https://newhedge.io/api/v2/metrics/liquidations/bitcoin_liquidations_bybit_short"

Replace `YOUR_TOKEN` with your API token.

Example response
200 Fictional example
[
  [1735516800000,42],
  [1735603200000,42],
  [1735689600000,42]
]
Definition & units 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 (1d): Labelled 00:00 UTC of the day it describes.

Timestamp (finer resolutions): A finer resolution is labelled in UTC at the end of the interval it covers, not at its start. Request include=definition for the selected bucket.

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

Resolutions: 1d, 1h.

Endpoint
curl -H "Authorization: Bearer YOUR_TOKEN" "https://newhedge.io/api/v2/metrics/liquidations/bitcoin_liquidations_okx_short"

Replace `YOUR_TOKEN` with your API token.

Example response
200 Fictional example
[
  [1735516800000,42],
  [1735603200000,42],
  [1735689600000,42]
]
Definition & units 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 (1d): Labelled 00:00 UTC of the day it describes.

Timestamp (finer resolutions): A finer resolution is labelled in UTC at the end of the interval it covers, not at its start. Request include=definition for the selected bucket.

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

Resolutions: 1d, 1h.

Endpoint
curl -H "Authorization: Bearer YOUR_TOKEN" "https://newhedge.io/api/v2/metrics/liquidations/bitcoin_liquidations_binance_long"

Replace `YOUR_TOKEN` with your API token.

Example response
200 Fictional example
[
  [1735516800000,42],
  [1735603200000,42],
  [1735689600000,42]
]
Definition & units 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 (1d): Labelled 00:00 UTC of the day it describes.

Timestamp (finer resolutions): A finer resolution is labelled in UTC at the end of the interval it covers, not at its start. Request include=definition for the selected bucket.

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

Resolutions: 1d, 1h.

Endpoint
curl -H "Authorization: Bearer YOUR_TOKEN" "https://newhedge.io/api/v2/metrics/liquidations/bitcoin_liquidations_bybit_long"

Replace `YOUR_TOKEN` with your API token.

Example response
200 Fictional example
[
  [1735516800000,42],
  [1735603200000,42],
  [1735689600000,42]
]
Definition & units 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 (1d): Labelled 00:00 UTC of the day it describes.

Timestamp (finer resolutions): A finer resolution is labelled in UTC at the end of the interval it covers, not at its start. Request include=definition for the selected bucket.

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

Resolutions: 1d, 1h.

Endpoint
curl -H "Authorization: Bearer YOUR_TOKEN" "https://newhedge.io/api/v2/metrics/liquidations/bitcoin_liquidations_okx_long"

Replace `YOUR_TOKEN` with your API token.

Example response
200 Fictional example
[
  [1735516800000,42],
  [1735603200000,42],
  [1735689600000,42]
]
Definition & units 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 (1d): Labelled 00:00 UTC of the day it describes.

Timestamp (finer resolutions): A finer resolution is labelled in UTC at the end of the interval it covers, not at its start. Request include=definition for the selected bucket.

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

Resolutions: 1d, 1h.

Endpoint
curl -H "Authorization: Bearer YOUR_TOKEN" "https://newhedge.io/api/v2/metrics/liquidations/bitcoin_liquidations_lighter_long"

Replace `YOUR_TOKEN` with your API token.

Example response
200 Fictional example
[
  [1735516800000,42],
  [1735603200000,42],
  [1735689600000,42]
]
Definition & units 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 (1d): Labelled 00:00 UTC of the day it describes.

Timestamp (finer resolutions): A finer resolution is labelled in UTC at the end of the interval it covers, not at its start. Request include=definition for the selected bucket.

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

Resolutions: 1d, 1h.

Endpoint
curl -H "Authorization: Bearer YOUR_TOKEN" "https://newhedge.io/api/v2/metrics/liquidations/bitcoin_liquidations_lighter_short"

Replace `YOUR_TOKEN` with your API token.

Example response
200 Fictional example
[
  [1735516800000,42],
  [1735603200000,42],
  [1735689600000,42]
]
Definition & units 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 (1d): Labelled 00:00 UTC of the day it describes.

Timestamp (finer resolutions): A finer resolution is labelled in UTC at the end of the interval it covers, not at its start. Request include=definition for the selected bucket.

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

Resolutions: 1d only.

Endpoint
curl -H "Authorization: Bearer YOUR_TOKEN" "https://newhedge.io/api/v2/metrics/liquidations/bitcoin_liquidations_gate_long"

Replace `YOUR_TOKEN` with your API token.

Example response
200 Fictional example
[
  [1735516800000,42],
  [1735603200000,42],
  [1735689600000,42]
]
Definition & units 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

Resolutions: 1d only.

Endpoint
curl -H "Authorization: Bearer YOUR_TOKEN" "https://newhedge.io/api/v2/metrics/liquidations/bitcoin_liquidations_gate_short"

Replace `YOUR_TOKEN` with your API token.

Example response
200 Fictional example
[
  [1735516800000,42],
  [1735603200000,42],
  [1735689600000,42]
]
Definition & units 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