---
title: "GET /liquidations"
method: GET
path: "/liquidations"
tags: ["api-gateway"]
---

# GET /liquidations

`GET /liquidations`

Returns historical liquidations for the authenticated user. Requires an explicit time range: both `start_timestamp_ns` and `end_timestamp_ns` must be provided and span no more than 7 days. Missing, inverted, or wider ranges are rejected with a 400.

## Query parameters

- `account_id` string, nullable
- `symbol` string, nullable
- `end_timestamp_ns` integer, nullable
- `start_timestamp_ns` integer, nullable
- `cursor` string, nullable
- `limit` integer, nullable
- `sort_ts` 'asc' | 'desc' — Sort order/direction. - `asc`: ascending order per field type (e.g. lexicographic, numeric, etc.) - `desc`: descending order per field type

## Response `200`

List of liquidations

- GetFillsResponse — Page metadata for cursor-paged responses. This is intended for response bodies (not query params).
  - `limit` integer, nullable
  - `next_cursor` string, nullable
  - `total_count` integer, nullable
  - `fills` Fill[], required
    - `account_id` string, required
    - `fee` string, required
    - `is_block_trade` boolean — True if this fill was generated by a block trade — a privately negotiated trade booked away from the order book.
    - `is_final_settlement` boolean — True if this fill was generated by final settlement of a delisted or expired contract at the final settlement price; the counterparty is the exchange settlement account. Implies `is_block_trade`.
    - `is_taker` boolean, required
    - `order_id` string, nullable
    - `price` string, required
    - `quantity` integer, required
    - `realized_pnl` string, nullable
    - `side` 'B' | 'S', required
    - `symbol` string, required
    - `timestamp` string, date-time, required
    - `trade_id` string, required

## Other responses

- `400` — Time range missing or wider than the 7-day maximum

---

[API](https://skmtc.net/architect/apis/ax-api-gateway.md) · [All operations](https://skmtc.net/architect/apis/ax-api-gateway/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/architect/ax-api-gateway/versions/2955c31c524d/schema)