Liquidation Chart

GET/gateway/v1/market/liquidation/chart

Returns OHLC-style aggregated liquidation data for a token on a specific exchange.

Filters: `symbol`, `exchange`, `interval`.

Useful for charting liquidation volume over time.

Query Parameters

symbolstringrequired

Token ticker symbol like `BTC` or `ETH`

Example: BTC

intervalenum<string>

Candlestick interval — bucket size for each point in the liquidation chart series: `1m`, `3m`, `5m`, `15m`, `30m`, `1h`, `4h`, `6h`, `8h`, `12h`, `1d`, or `1w`. This endpoint uses `interval` only; it does NOT accept `time_range`. Use `from`/`to` to bound the series.

Available options:1m3m5m15m30m1h4h6h8h12h1d1w

Example: 1h

exchangeenum<string>

Exchange name. Can be `Binance`, `OKX`, `Bybit`, `Bitget`, `Hyperliquid`, `Gate`, `HTX`, `Bitmex`, `Bitfinex`, `CoinEx`, `Aster`, or `Lighter`.

Available options:BinanceOKXBybitBitgetHyperliquidGateHTXBitmexBitfinexCoinExAsterLighter

Example: Binance

limitinteger

Results per page

Example: 500

fromstring

Start of time range. Accepts Unix seconds (`1704067200`) or date string (`2024-01-01`)

Example: 2024-01-01

tostring

End of time range. Accepts Unix seconds (`1706745600`) or date string (`2024-02-01`)

Example: 2024-02-01

Liquidation Chart

const options = {method: 'GET'};

fetch('https://api.asksurf.ai/gateway/v1/market/liquidation/chart?symbol=BTC&interval=1h&exchange=Binance&limit=500&from=2024-01-01&to=2024-02-01', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "$schema": "https://example.com/schemas/SimpleListResponseLiquidationChartItem.json",
  "data": [
    {
      "contributing_exchanges": [],
      "excluded_exchanges": [],
      "long_liquidation_usd": 123,
      "short_liquidation_usd": 123,
      "timestamp": 123
    }
  ],
  "meta": {
    "cached": true,
    "credits_used": 123,
    "empty_reason": "<string>"
  }
}