---
title: "Get recent liquidations across futures exchanges"
method: GET
path: "/market/liquidations"
tags: ["market"]
---

# Get recent liquidations across futures exchanges

`GET /market/liquidations`

## Request

- Base URL: `https://coinlobster.com/api/ai/v1`
- URL: `https://coinlobster.com/api/ai/v1/market/liquidations`
- Auth: HTTP bearer

Recent liquidation events for one pair with the long vs short breakdown. Same composer as the keyless MCP liquidations tool, so the answer is never thinner than the free one: the live feed is merged with the persisted recorded series (history_included says whether that happened), duplicates and zero-size rows are dropped, and window_minutes states the period the answer covers so a count of 0 is a bounded claim. long_liquidations and short_liquidations are event COUNTS; long_usd and short_usd carry the dollar split. A long is force-closed by selling, so sell-side events are long liquidations.

## Query parameters

- `pair` string
- `limit` integer

## Response `200`

Liquidation events with aggregate stats

- object
  - `success` true, required
  - `data` LiquidationLane, required: ONE lane. Perp and lending liquidations are different events and are never summed.
    - `count` integer
    - `totalUsd` number
    - `longUsd` number
    - `shortUsd` number
    - `longSharePct` number, nullable: null on an empty window. Never defaults to 50.
  - `meta` Meta: Present on every /api/ai/v1 response.
    - `timestamp` string, date-time: When this response was assembled, not when the data was measured.
    - `credits_used` integer: Credits this call spent. Absent on free surfaces and on keyless calls.
    - `credits_remaining` integer: Account balance after this call.
    - `deprecation` string: Present when the request used a deprecated form, e.g. the key in the query string.

---

[API](https://skmtc.dev/coinlobster/apis/coinlobster-crypto-data-api.md) · [All operations](https://skmtc.dev/coinlobster/apis/coinlobster-crypto-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/coinlobster/apis/coinlobster-crypto-data-api/revisions/a62c3a47523a?raw)