Skip to main content

​
Endpoint

GET https://api.marketdataset.ai/crypto/liquidations
Liquidations occur when a trader’s margin balance falls below the maintenance margin threshold. The exchange forcibly closes their position. Why liquidations matter:
  • Liquidation clusters mark significant support/resistance levels
  • Cascading liquidations can trigger sharp directional moves
  • Large liquidation events often mark local tops/bottoms

​
Parameters

NameTypeRequiredDescription
symbolstringNoFutures symbol, e.g. BTCUSDT. Returns all if omitted.
exchangestringNoExchange (default: binance)
sidestringNolong or short. long = forced sell of a long position
start_datestringNoISO 8601 date
end_datestringNoISO 8601 date
limitintegerNoRecords to return (default: 100, max: 1000)
cursorstringNoPagination cursor

​
Credit cost

$0.010 per request

​
Example request

curl "https://api.marketdataset.ai/crypto/liquidations?symbol=BTCUSDT&side=long&limit=10" \
  -H "X-API-KEY: sk_your_key"

​
Example response

{
  "liquidations": [
    {
      "symbol": "BTCUSDT",
      "exchange": "binance",
      "side": "long",
      "quantity": 0.143,
      "price": 67843.21,
      "value_usd": 9701.58,
      "liquidated_at": "2024-11-01T14:32:17+00:00"
    }
  ],
  "next_page_url": null,
  "meta": {
    "request_id": "req_abc123",
    "credits_used": 0.01,
    "credits_remaining": 49.99
  }
}

​
Fields

FieldDescription
sidelong = a long position was liquidated (forced sell); short = a short position was liquidated (forced buy)
quantityContracts liquidated (in base currency)
priceLiquidation price
value_usdUSD value of the liquidation