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. Any other value is refused with a 400 that names what is available; 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.

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
[
  [
    1790726400000,
    13943.288
  ],
  [
    1790812800000,
    26927.9789
  ],
  [
    1790899200000,
    136718.1974
  ]
]
Definition (from the chart description)

Value: Kraken Long — Daily long and short Bitcoin futures liquidations by exchange.

Units: usd

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

Calendar: calendar_daily

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
[
  [
    1790726400000,
    -692745.3045000001
  ],
  [
    1790812800000,
    -137548.047
  ],
  [
    1790899200000,
    -486257.7952
  ]
]
Definition (from the chart description)

Value: Kraken Short — Daily long and short Bitcoin futures liquidations by exchange.

Units: usd

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

Calendar: calendar_daily

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
[
  [
    1790726400000,
    84005.587
  ],
  [
    1790812800000,
    574787.6124999999
  ],
  [
    1790899200000,
    1141189.1532
  ]
]
Definition (from the chart description)

Value: HTX Long — Daily long and short Bitcoin futures liquidations by exchange.

Units: usd

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

Calendar: calendar_daily

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
[
  [
    1790726400000,
    -11521394.384700006
  ],
  [
    1790812800000,
    -424528.11750000005
  ],
  [
    1790899200000,
    -2984146.064800002
  ]
]
Definition (from the chart description)

Value: HTX Short — Daily long and short Bitcoin futures liquidations by exchange.

Units: usd

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

Calendar: calendar_daily

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
[
  [
    1790726400000,
    124070.66097658
  ],
  [
    1790812800000,
    0.0
  ],
  [
    1790899200000,
    4515.479094480002
  ]
]
Definition (from the chart description)

Value: Bitfinex Long — Daily long and short Bitcoin futures liquidations by exchange.

Units: usd

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

Calendar: calendar_daily

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
[
  [
    1790726400000,
    0.0
  ],
  [
    1790812800000,
    0.0
  ],
  [
    1790899200000,
    -87964.18662825998
  ]
]
Definition (from the chart description)

Value: Bitfinex Short — Daily long and short Bitcoin futures liquidations by exchange.

Units: usd

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

Calendar: calendar_daily

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
[
  [
    1790726400000,
    -21628412.76328501
  ],
  [
    1790812800000,
    -11829125.5946
  ],
  [
    1790899200000,
    -60558916.14021999
  ]
]
Definition (from the chart description)

Value: Binance Short — Daily long and short Bitcoin futures liquidations by exchange.

Units: usd

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

Calendar: calendar_daily

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
[
  [
    1790726400000,
    -6429750.913399997
  ],
  [
    1790812800000,
    -2703015.0848
  ],
  [
    1790899200000,
    -16483879.30379995
  ]
]
Definition (from the chart description)

Value: Bybit Short — Daily long and short Bitcoin futures liquidations by exchange.

Units: usd

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

Calendar: calendar_daily

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
[
  [
    1790726400000,
    -11208499.47691
  ],
  [
    1790812800000,
    -6448805.788849995
  ],
  [
    1790899200000,
    -21677166.85700001
  ]
]
Definition (from the chart description)

Value: OKX Short — Daily long and short Bitcoin futures liquidations by exchange.

Units: usd

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

Calendar: calendar_daily

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
[
  [
    1790726400000,
    11119310.99928199
  ],
  [
    1790812800000,
    4669971.553600005
  ],
  [
    1790899200000,
    30457220.154324
  ]
]
Definition (from the chart description)

Value: Binance Long — Daily long and short Bitcoin futures liquidations by exchange.

Units: usd

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

Calendar: calendar_daily

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
[
  [
    1790726400000,
    6343102.978500004
  ],
  [
    1790812800000,
    2103746.192000002
  ],
  [
    1790899200000,
    8469067.7793
  ]
]
Definition (from the chart description)

Value: Bybit Long — Daily long and short Bitcoin futures liquidations by exchange.

Units: usd

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

Calendar: calendar_daily

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
[
  [
    1790726400000,
    8970691.012550002
  ],
  [
    1790812800000,
    3405146.6072500013
  ],
  [
    1790899200000,
    18705083.05872
  ]
]
Definition (from the chart description)

Value: OKX Long — Daily long and short Bitcoin futures liquidations by exchange.

Units: usd

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

Calendar: calendar_daily

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
[
  [
    1790726400000,
    252720.061231
  ],
  [
    1790812800000,
    34638.14842900001
  ],
  [
    1790899200000,
    1012653.604786
  ]
]
Definition (from the chart description)

Value: Lighter Long — Daily long and short Bitcoin futures liquidations by exchange.

Units: usd

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

Calendar: calendar_daily

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
[
  [
    1790726400000,
    -759575.4203679999
  ],
  [
    1790812800000,
    -149247.906464
  ],
  [
    1790899200000,
    -771854.4204309997
  ]
]
Definition (from the chart description)

Value: Lighter Short — Daily long and short Bitcoin futures liquidations by exchange.

Units: usd

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

Calendar: calendar_daily

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
[
  [
    1790726400000,
    2293218.04797
  ],
  [
    1790812800000,
    717565.51124
  ],
  [
    1790899200000,
    6236657.214
  ]
]
Definition (from the chart description)

Value: Gate Long — Daily long and short Bitcoin futures liquidations by exchange.

Units: usd

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

Calendar: calendar_daily

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
[
  [
    1790726400000,
    -4630935.15069
  ],
  [
    1790812800000,
    -1322115.21808
  ],
  [
    1790899200000,
    -9786824.577
  ]
]
Definition (from the chart description)

Value: Gate Short — Daily long and short Bitcoin futures liquidations by exchange.

Units: usd

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

Calendar: calendar_daily