Skip to main content
GET
/
api
/
v1
/
markets
/
{market_id}
/
perps
/
liquidations
Get liquidations
curl --request GET \
  --url https://api.allium.so/api/v1/markets/{market_id}/perps/liquidations \
  --header 'X-API-KEY: <api-key>'
{
  "items": [
    {
      "market_id": "<string>",
      "ts": "<string>",
      "size_base": "<string>",
      "price": "<string>",
      "notional_usd": "<string>"
    }
  ],
  "cursor": "<string>"
}
Alpha — The Market Data API is in alpha. Schema and response format may change. To request access, contact us or reach out to your account manager.
Returns the historical liquidations feed for a perpetual market, newest first, with cursor pagination. Perp markets only. A live streaming variant is available on request.
side is the direction of the liquidated position (long or short), not the matching fill’s taker side. The cursor format is {ts_ms}_{id}. The query window is currently capped at 7 days per request.

Authorizations

​
X-API-KEY
string
header
required

Path Parameters

​
market_id
string
required

Canonical market slug, {venue}:{instrument_type}:{pair}.

Query Parameters

​
from
string
required

Start of the window (ISO 8601; naive datetimes treated as UTC).

​
to
string
required

End of the window (ISO 8601).

​
limit
integer
default:500

Maximum rows to return (1–5000).

Required range: 1 <= x <= 5000
​
cursor
string

Pagination cursor from a previous response. Format: {ts_ms}_{id}.

Response

200 - application/json

Liquidation events.

​
items
object[]
required
​
cursor
string

Cursor for the next page. Absent when there are no more results.