---
title: "Market liquidations"
method: GET
path: "/timeseries/market-liquidations"
tags: ["Timeseries"]
---

# Market liquidations

`GET /timeseries/market-liquidations`

Returns liquidations for specified futures markets.<br/> Results are ordered by tuple `(market, time)`.<br/> To fetch the next page of results use `next_page_url` JSON response field. Keep in mind that spot markets are not supported by this endpoint.

## Query parameters

- `markets` string[], required
- `start_time` string
- `end_time` string
- `start_inclusive` boolean
- `end_inclusive` boolean
- `timezone` string
- `page_size` integer
- `paging_from` 'start' | 'end', PagingFrom
- `limit_per_market` integer
- `pretty` boolean
- `format` 'json' | 'csv'
- `next_page_token` string

## Response `200`

Time series of market liquidations.

- MarketLiquidationsResponse
  - `data` MarketLiquidation[], required — Time series of market liquidations.
    - `market` string, required — Unique name of the market.
    - `time` string, required — The time in ISO 8601 date-time format. Always with nanoseconds precision.
    - `coin_metrics_id` string, required — ID of a liquidation (unique per exchange market). We are using exchange reported value if exchange reports a unique numeric liquidation id. If exchange reports liquidation id as a string we convert to numeric using Bijective mapping from exchange reported liquidation id's string. If exchange doesn't report unique ID we transform it using exchange reported data to form a unique value per market.
    - `amount` string, required — The amount of the base asset liquidated.
    - `price` string, required — The price of the base asset quoted in the quote asset that the liquidation was executed at.
    - `side` string — The market order side. "buy" means that an ask was removed from the book by an incoming buy order, "sell" means that a bid was removed from the book by an incoming sell order.
    - `type` string, required — The liquidation type. "trade" means that liquidation was executed, "order" means that the order was placed for the liquidation at the timestamp of the data entry but it wasn't necessarily executed yet.
    - `database_time` string, required — A time when we saved the data in the database. The time is in ISO 8601 date-time format. Always with nanoseconds precision.
  - `next_page_token` string — Token of the next page results for a given request.
  - `next_page_url` string — URL of the next page results for a given request.

## Other responses

- `400` — Market not found.
- `401` — Requested resource requires authorization.
- `403` — Requested resource is not available with supplied credentials.
- `414` — Provided URI is too long. It must not be greater than 10000 symbols.

---

[API](https://skmtc.net/coinmetrics/apis/coin-metrics-api-v4.md) · [All operations](https://skmtc.net/coinmetrics/apis/coin-metrics-api-v4/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/coinmetrics/coin-metrics-api-v4/revisions/774268c0a4fe/schema)