v1

latestOpenAPI 3.0.32026-07-2613529376.3 KB
Spot Trading

Query executed order deals

The endpoint retrieves individual trade fills (deals) for a specific order. Each deal represents a partial or full execution of the order against a counterparty. The response includes pagination and returns deal details such as price, amount, fee, and execution role (maker or taker).

<Warning> Rate limit: 12000 requests/10 sec. </Warning> <Note> This endpoint supports pagination. Use `limit` (default: 50) and `offset` (default: 0) to page through results. The response does not include a `total` field — detect the last page when `records.length < limit`. An empty `records` array means you have paged past the end; receiving exactly `limit` records does not guarantee that another page exists. </Note> <Note> An unknown or not-owned `orderId` is **not** an error. The endpoint always returns HTTP 200 with the paged-list envelope; a non-matching `orderId` simply filters down to an empty `records` array. </Note> <Note> The endpoint can retrieve data not older than 6 months from the current month. For older data, use the Report on the History page. An order older than this window returns an empty `records` array even when the order was filled. </Note> <Accordion title="Error Codes"> - `30` - default validation error code (for example, a missing or malformed `orderId`, or invalid pagination) </Accordion>
post/api/v4/trade-account/order

Request body

orderIdinteger required

Identifier of the order to retrieve deals for.

offsetinteger

Number of records to skip. Default: 0.

limitinteger

Maximum number of records to return. Default: 50.

requeststring required
nonceinteger required

Example request

{
  "orderId": 3134995325,
  "limit": 50,
  "request": "{{request}}",
  "nonce": 1594297865000
}

Response

Successful response - returns paginated order deals

offsetinteger

Number of records skipped

limitinteger

Number of records per page

Example response

{
  "records": [
    {
      "time": 1593342324.613711,
      "fee": "0.00000419198",
      "price": "0.00000701",
      "amount": "598",
      "id": 149156519,
      "dealOrderId": 3134995325,
      "clientOrderId": "customId11",
      "role": 2,
      "deal": "0.00419198",
      "feeAsset": "USDT",
      "rpi": true
    }
  ],
  "limit": 100
}