Sign in

v1

latestOpenAPI 3.0.32026-07-2613529376.3 KB
Spot Trading

Query delisting orders

The endpoint returns the authenticated account's delisting-related order history from the order-history index. The response combines two categories of orders, each identified by the delistingKind field: reverse close orders that the platform generates when a market is delisted (delistingKind = reverse, clientOrderId prefixed with delisting-), and active orders canceled at the moment of delisting (delistingKind = canceled). The endpoint returns a flat array sorted by finishAt descending, then id descending.

Set the status parameter to narrow the response: filled returns only reverse close orders that reached the filled outcome, and delisting returns only orders canceled during delisting. Omit status to return both categories merged in a single array.

<Note> The endpoint supports pagination via `limit` (default: 500, max: 500) and `offset` (default: 0); the sum of `offset` and `limit` must not exceed 10000. A response that returns fewer than `limit` records indicates the last page. </Note> <Note> **Date filter window:** the date range filters orders by the `finishAt` timestamp. The maximum span between `startDate` and `endDate` is **31 days**. `endDate` values greater than the current time are clamped to `now`. </Note> <Warning> Rate limit: 10000 requests/10 sec. </Warning>
post/api/v4/trade-account/order/history/query

Request body

marketstring

Trading pair to filter by. Format: BASE_QUOTE (e.g., BTC_USDT), matching the pattern ^[A-Z0-9]+_[A-Z0-9]+$. Omit to retrieve delisting orders across all markets.

status'filled' | 'delisting'

Category filter — distinct from the response status field. filled returns only reverse close orders (clientOrderId prefixed with delisting-), which carry delistingKind = reverse and response status = filled. delisting returns only orders canceled at delisting, which carry delistingKind = canceled and response status = canceled. Omit to return both categories merged.

startDateinteger

Start of the query window as a Unix timestamp in seconds. Default: now - 30 days. Must not be later than endDate.

endDateinteger

End of the query window as a Unix timestamp in seconds. Default: now. Values greater than the current time are clamped to now. The maximum span between startDate and endDate is 31 days.

offsetinteger

Number of records to skip. Default: 0. The sum of offset and limit must not exceed 10000.

limitinteger

Maximum number of records to return. Default: 500. Minimum: 1. Maximum: 500.

requeststring
nonceinteger

Example request

{
  "market": "BTC_USDT",
  "status": "filled",
  "startDate": 1731369600,
  "endDate": 1733961600,
  "limit": 500,
  "request": "{{request}}",
  "nonce": 1594297865000
}

Response

Successful response - returns a flat array of delisting-related orders sorted by finishAt descending, then id descending. Returns an empty array when no delisting orders match the filters.

idinteger

Unique order identifier assigned by the matching engine.

clientOrderIdstring

Custom client order identifier. Reverse close orders carry the platform-generated value prefixed with delisting-. Returns an empty string when the original order had no client identifier.

createdAtnumber

Unix timestamp in seconds (UTC) of order creation, with microsecond precision.

finishAtnumber

Unix timestamp in seconds (UTC) at which the order reached its final status, with microsecond precision. Primary sort key, descending.

marketstring

Trading pair the order belongs to. Format: BASE_QUOTE.

side'buy' | 'sell'

Order side. Possible values: buy, sell.

typestring

Order type. Possible values: limit, market, stock market, stop limit, stop market.

pricestring

Limit price per unit in quote currency. Returns "0" for market orders.

amountstring

Order quantity in base currency for limit orders, or in quote currency for buy market orders.

dealStockstring

Filled amount in base (stock) currency.

dealMoneystring

Filled amount in quote (money) currency.

feestring

Cumulative trading fee charged for filled portions, denominated in the fee asset.

feeAssetstring

Currency ticker of the asset used to pay the trading fee.

statusstring

Execution outcome in lowercase. Reverse close orders that filled return filled. Orders canceled during delisting return canceled.

delistingKind'reverse' | 'canceled'

Delisting category discriminator. reverse marks a reverse close order generated by the platform. canceled marks an active order canceled at the moment of delisting.

Example response

[
  {
    "id": 2286423327099,
    "clientOrderId": "delisting-2286423327099",
    "createdAt": 1778077388.002424,
    "finishAt": 1778077400.123456,
    "market": "BTC_USDT",
    "side": "sell",
    "type": "market",
    "price": "61234.5000000000",
    "amount": "0.0500000000",
    "dealStock": "0.0500000000",
    "dealMoney": "3061.7250000000",
    "fee": "1.5308625000",
    "feeAsset": "USDT",
    "status": "filled",
    "delistingKind": "reverse"
  }
]