Count liquidations per day
/v1/chains/{chain}/perpl/liquidations/dailyCall this to draw the history of liquidations. The answer has one item per UTC day for the last days days, ending on today, in ascending order of day. A day without any liquidation is there with count 0 and notional_usd "0", so the series has no gaps. Today's item is partial. market narrows it to one market.
days is 1 to 400, 90 by default.
Path parameters
| Name | Type | Description |
|---|---|---|
chainRequired | string | The chain, as a CAIP-2 chain ID. Only Monad, |
Query parameters
| Name | Type | Description |
|---|---|---|
market | string | Only this market, as its symbol in any case or its decimal perp id. Without it every market is counted. A market that has no mark price any more can still be named here, because its history stays. An unknown market answers 404 |
days | integerDefault 90 | How many UTC days the series covers, ending today, from 1 to 400. The default is 90. |
Response
The answer, wrapped in the {data, meta, links} envelope. data.kind is perpl_liquidations_daily. meta.as_of names the snapshot block.
| Field | Type | Description |
|---|---|---|
| chain | string | The CAIP-2 id of the chain. |
| coverage | array of strings | The codes of the limits that apply to this answer, in a fixed order. It is empty when none applies. The status route explains each code. |
| items | array of objects | One item per day for the last |
| kind | string | perpl_liquidations_daily |
Cost
1 credit. The time limit is 5 seconds.
Errors
| Status | Code |
|---|---|
| 400 | invalid_query |
| 404 | not_foundunsupported_chain |
| 429 | rate_limitedcredits_exhausted |
| 500 | internal |
| 503 | upstream_unavailable |
| 504 | deadline_exceeded |
400 invalid_query for a bad days or market, 404 not_found, 404 unsupported_chain, 503 and 504 as elsewhere.