StatusTerminal
APIUse casesOracleMCP & AgentsSDKsSkillsChangelog

Daily liquidations of a perpetual or a whole venue

GET
/perps/liquidations

Liquidated notional per UTC day, long and short, with counts and the largest single liquidation. Omit market for the venue as a whole. stale means the liquidation feed stopped and recent days may be short.

Query Parameters

chain?string

chain slug or id of the perpetuals venue

Length1 <= length <= 32
Default"hyperliquid"
market?string

one market's address; omit for the whole venue

Length1 <= length <= 128
from?integer

window start, unix seconds UTC; defaults to the longest window served

Formatint64
Range0 <= value
to?integer

window end, unix seconds UTC; defaults to now

Formatint64
Range0 <= value

Header Parameters

Accept-Payment?string

payment methods the client can use, comma-separated, case-insensitive. With x402 in the list, a spent keyless budget answers 402 with the x402 challenge instead of 429.

PAYMENT-SIGNATURE?string

base64 x402 v2 payment payload for this request. A paid request skips the keyless budget and is settled only when it answers 2xx. The v1 header X-PAYMENT is accepted too.

Response Body

application/json

application/problem+json

application/problem+json

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X GET "https://example.com/perps/liquidations"
{  "chain": {    "slug": "hyperliquid",    "chain_id": 0  },  "market": "string",  "stale": true,  "items": [    {      "day": "string",      "liquidated_long_usd": 0.1,      "liquidated_short_usd": 0.1,      "long_count": 0,      "short_count": 0,      "max_liquidation_usd": 0.1    }  ]}

Open interest, funding and mark history of a perpetual GET

Snapshots of one perpetual at a fixed interval — mark and oracle price, premium, open interest by side and hourly funding and borrow rates. A point whose open interest was not observed says so in `oi_known`.

Launches of one deployer, with its reputation card GET

Every pair the wallet launched, across chains, newest first, including the ones that went bad — that is the point of the list. `deployer` is the reputation card; it is absent when the address never launched a pair.