Skip to main content
GET
/
gateway
/
v1
/
market
/
liquidation
/
chart
Liquidation Chart
curl --request GET \
  --url https://api.ask.surf/gateway/v1/market/liquidation/chart
{
  "data": [
    {
      "long_liquidation_usd": 123,
      "short_liquidation_usd": 123,
      "timestamp": 123
    }
  ],
  "meta": {
    "cached": true,
    "credits_used": 123
  },
  "$schema": "<string>"
}

Query Parameters

​
symbol
string
required

Token ticker symbol like BTC or ETH

Example:

"BTC"

​
interval
enum<string>
default:1h

Candlestick interval. Can be 1m, 3m, 5m, 15m, 30m, 1h, 4h, 6h, 8h, 12h, 1d, or 1w.

Available options:
1m,
3m,
5m,
15m,
30m,
1h,
4h,
6h,
8h,
12h,
1d,
1w
Example:

"1h"

​
exchange
enum<string>
default:Binance

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

Available options:
Binance,
OKX,
Bybit,
Bitget,
Hyperliquid,
Gate,
HTX,
Bitmex,
Bitfinex,
CoinEx,
Aster,
Lighter
Example:

"Binance"

​
limit
integer<int64>
default:500

Results per page

Required range: 1 <= x <= 4500
Example:

500

​
from
string

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

Example:

"2024-01-01"

​
to
string

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

Example:

"2024-02-01"

Response

OK

​
data
object[] | null
required
​
meta
object
required
​
$schema
string<uri>

A URL to the JSON Schema for this object.

Example:

"https://example.com/schemas/SimpleListResponseLiquidationChartItem.json"