derivatives

Liquidation History

Liquidation history for one coin's perpetuals: market-wide long/short liquidations (USD) in 4h buckets and the 24h split by venue, plus a minute-level timing sample of individual liquidation orders from venues that publish them (OKX, Gate) with detected cascades (time, side, size, order count, price range) and the largest orders. The sample is a share of the market, stated per bucket, never scaled up. Use it to say WHEN and WHICH SIDE was forced out, instead of inferring liquidations from price and open interest: flat OI can hide heavy liquidations that new positions replaced. A 1y baseline ranks the trailing ~24h of longs and shorts against a year of daily totals (percentile, 'largest since' date, median day, the year's three largest days per side), so a figure can be called big or routine for this coin.

get/derivatives/liquidations/{symbol}

Request

  • Base URL: https://mcp.f1ow.com/v1
  • URL: https://mcp.f1ow.com/v1/derivatives/liquidations/{symbol}
  • Auth: one of:
    • HTTP bearer
    • none

Path parameters

symbolstring required

Coin symbol, e.g. "BTC".

Query parameters

hoursinteger

Trailing window in hours, 1–72. Default 24.

interval'5m' | '15m' | '1h'

Bucket size for the timing sample. Default 15m.

top_ordersinteger

Largest individual liquidations to list, 0–20. Default 5.

Response

The result.

textstring required

Human-readable rendering of the result.

Changes

No recorded changes to this operation across all 1 revision of this API.