Retrieves the historical time series liquidations for the specified instrument and exchange(s).


Deprecation Notice

As part of our ongoing efforts to improve our API and services, we will be deprecating this endpoint. This decision is in line with our commitment to providing high-quality, efficient, and secure API services to our users.

We encourage all users of this endpoint to transition to the Futures Liquidations Historical endpoint as soon as possible. This endpoint offers the same data, we have simply merged our Swaps data together with the Futures data. Therefore, "Swaps" data (aka Perpetual Futures) can now be found under the Futures section of the Amberdata API docs.


Time Range Limit

The maximum time range (difference between startDate and endDate) is 1 year.


Not specifying startDate and endDate

If the startDate and endDate query parameters are not provided, the API will return the data from the previous 1 year.


{metadata}objectThe metadata associated with the data.
{metadata}.startDatenumber or stringThe first date/time for which data is available.
{metadata}.endDatenumber or stringThe last date/time for which data is available.
[data]arrayThe liquidation data corresponding to the columns fields, aggregated by exchange.
[data].exchangestringThe name of the exchange, as specified by the filter provided or representing the supported exchanges for this instrument.
[data].timestampnumber or stringThe time at which the liquidation occurred.
[data].originalQuantitynumberThe original quantity before the liquidation occurred.
[data].pricenumberThe price of the instrument at the time of the liquidation.
[data].sidestringThe direction of the trade.
[data].statusstringThe status of the liquidation.
[data].typestringThe type of liquidation.
[data].timeInForcestringHow long the order is to remain active before it is executed or expires, for example:
- IOC: immediate-or-cancel
- FOK: fill-or-kill
- GTC: good-'till-canceled
- etc
[data].actionstringThe type of action taken during the liquidation process (for example: delete, insert, update, etc).
[data].orderIdstringThe order identifier.
[data].unitstring | nullThe units are on originalQuantity

Refer to Liquidations - Information for more detail on unit
Click Try It! to start a request and see the response here!