Skip to main content
Type: LIQUIDATION_AGG | Weight: 1x | Max points: 100,000 Aggregated liquidation volume over an interval. Returns one series per side (buy/sell liquidations).

​
Response fields

FieldTypeDescription
liquidationsdoubleTotal liquidation volume (coin by default, USD with transform)
timestampTimestampStart of the interval
The series identifier includes a side field (BUY or SELL) to distinguish the direction of liquidations.

​
Capabilities

FeatureSupportedDetails
USD denominationYestransform.normalize.quote=USD converts to USD
Multi-exchange aggregationYestransform.groupBy.type=GROUP_BY_TYPE_SUM with coin param

​
Examples

​
Single exchange (coin values)

Fetches 1 hour of hourly liquidation data for BTCUSDT on Binance Futures. Returns two series — one for buy-side liquidations (longs getting liquidated) and one for sell-side (shorts getting liquidated). Values are in coin terms. 
curl "https://api.kiyotaka.ai/v1/points?type=LIQUIDATION_AGG&exchange=BINANCE_FUTURES&rawSymbol=BTCUSDT&interval=HOUR&from=1774800000&period=3600" \
  -H "X-Kiyotaka-Key: YOUR_API_KEY"

​
Aggregated across exchanges (USD)

Sums liquidation volume across Binance Futures, Bybit, and OKX for all BTC pairs, converted to USD. Useful for tracking total market liquidation pressure. 
curl "https://api.kiyotaka.ai/v1/points?type=LIQUIDATION_AGG&exchange=BINANCE_FUTURES&exchange=BYBIT&exchange=OKEX_SWAP&coin=BTC&interval=HOUR&from=1774800000&period=3600&transform.groupBy.type=GROUP_BY_TYPE_SUM&transform.normalize.quote=USD" \
  -H "X-Kiyotaka-Key: YOUR_API_KEY"

​
Response

{
  "series": [
    {
      "id": {
        "type": "LIQUIDATION_AGG",
        "exchange": "BINANCE_FUTURES",
        "rawSymbol": "BTCUSDT",
        "normalizedSymbol": "BTC-USDT",
        "category": "PERPETUAL",
        "interval": "HOUR",
        "side": "SELL",
        "coin": "BTC"
      },
      "points": [
        {
          "Point": {
            "liquidations": 0.223,
            "timestamp": { "s": 1774800000 }
          }
        }
      ]
    },
    {
      "id": {
        "type": "LIQUIDATION_AGG",
        "exchange": "BINANCE_FUTURES",
        "rawSymbol": "BTCUSDT",
        "normalizedSymbol": "BTC-USDT",
        "category": "PERPETUAL",
        "interval": "HOUR",
        "side": "BUY",
        "coin": "BTC"
      },
      "points": [
        {
          "Point": {
            "liquidations": 1.529,
            "timestamp": { "s": 1774800000 }
          }
        }
      ]
    }
  ]
}