ASasksurf
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.

get/gateway/v1/market/liquidation/chart

Request

  • Base URL
    https://api.asksurf.ai
  • Auth
    HTTP bearer

Query parameters

symbolstring required

Token ticker symbol like BTC or ETH

Example:BTC
interval'1m' | '3m' | '5m' | '15m' | '30m' | '1h' | '4h' | '6h' | '8h' | '12h' | '1d' | '1w'

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.

Example:1h
exchange'Binance' | 'OKX' | 'Bybit' | 'Bitget' | 'Hyperliquid' | 'Gate' | 'HTX' | 'Bitmex' | 'Bitfinex' | 'CoinEx' | 'Aster' | 'Lighter'

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

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

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

Example response

{
  "$schema": "https://example.com/schemas/SimpleListResponseLiquidationChartItem.json"
}

Changes

No recorded changes to this operation across all 12 revisions of this API.