---
title: "Liquidation feed"
method: GET
path: "/api/v1/liquidations"
tags: ["Liquidations"]
---

# Liquidation feed

`GET /api/v1/liquidations`

The raw liquidation feed (~last 48h, then pruned), newest first. Source coverage
is currently OKX swap markets. Prices are decimal strings. `meta` carries the
pagination fields plus a `retention` and `note`.

## Query parameters

- `page` integer, nullable — Page number (1-based). Must be at least 1.
- `per_page` integer, nullable — Rows per page. The cap is plan-based (Free 100, Starter/Pro 250); exceeding it returns 422 rather than clamping. Must be at least 1. Must not be greater than 100.
- `exchange` string, nullable — Restrict to a single exchange by slug. Source coverage is currently OKX swap markets. Must match the regex /^[a-z0-9\-]{1,120}$/.
- `instrument` 'future' | 'option' | 'swap' | 'spot' | 'margin', nullable — Instrument type: future, option, swap, spot or margin.
- `position` 'long' | 'short', nullable — Liquidated position side: long or short.
- `order` 'buy' | 'sell', nullable — Fill side that triggered the liquidation: buy or sell.
- `symbol` string, nullable — Prefix match on the venue instId (e.g. BTC matches BTC-USDT-SWAP). Must match the regex /^[A-Za-z0-9$\.\-]{1,25}$/.
- `min_usd` number, nullable — Only liquidations with a USD value at or above this threshold. Must be at least 0.

## Response `200`

- object
  - `data` object[]
    - `symbol` string
    - `exchange` object
      - `id` integer
      - `slug` string
      - `name` string
    - `instrument` string
    - `position` string
    - `order` string
    - `price` string
    - `value_usd` number
    - `quantity` number
    - `liquidated_at` string
  - `meta` object
    - `current_page` integer
    - `per_page` integer
    - `total` integer
    - `last_page` integer
    - `retention` string
    - `note` string

---

[API](https://skmtc.net/bitculator/apis/bitculator-data-api.md) · [All operations](https://skmtc.net/bitculator/apis/bitculator-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bitculator/bitculator-data-api/revisions/ed1378af68b6/schema)