Liquidations — Kiyotaka Docs

GET/v1/points

LIQUIDATION_AGGWeight: 1x | Max points: 100,000

Aggregated liquidation volume over an interval. Returns one series per side (buy/sell liquidations).

Response fields

Field	Type	Description
`liquidations`	double	Total liquidation volume (coin by default, USD with transform)
`timestamp`	Timestamp	Start of the interval

The series identifier includes a side field (BUY or SELL) to distinguish the direction of liquidations.

Capabilities

Feature	Supported	Details
USD denomination	Yes	`transform.normalize.quote=USD` converts to USD
Multi-exchange aggregation	Yes	`transform.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"

import requests


response = requests.get(
    "https://api.kiyotaka.ai/v1/points?type=LIQUIDATION_AGG&exchange=BINANCE_FUTURES&rawSymbol=BTCUSDT&interval=HOUR&from=1774800000&period=3600 ",
    headers={"X-Kiyotaka-Key": "YOUR_API_KEY"}
)
data = response.json()

const response = await fetch(
  "https://api.kiyotaka.ai/v1/points?type=LIQUIDATION_AGG&exchange=BINANCE_FUTURES&rawSymbol=BTCUSDT&interval=HOUR&from=1774800000&period=3600 ",
  { headers: { "X-Kiyotaka-Key": "YOUR_API_KEY" } }
)
const data = await response.json()

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"

import requests


response = requests.get(
    "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 ",
    headers={"X-Kiyotaka-Key": "YOUR_API_KEY"}
)
data = response.json()

const response = await fetch(
  "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 ",
  { headers: { "X-Kiyotaka-Key": "YOUR_API_KEY" } }
)
const data = await response.json()

Response

JSON

{
  "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 }
          }
        }
      ]
    }
  ]
}