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

# Market liquidations

`GET /timeseries-stream/market-liquidations`

Returns a WebSocket stream of liquidations for specified markets.<br/> If you are falling behind (slow client) you will get `warning` message first, then `error` message and disconnection will happen.

## Query parameters

- `markets` string[], required
- `backfill` 'latest' | 'none'
- `pretty` boolean

## Response `default`

Liquidation WebSocket message.

- StreamingMarketLiquidation — Market liquidation WebSocket message.
  - `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.
  - `cm_sequence_id` string, required — The monotonically increasing message number, resets on disconnection.

## Other responses

- `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)