v1
latestOpenAPI 3.0.32026-07-2613529376.3 KBSpot 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
Example request
{
"orderId": 3134995325,
"limit": 50,
"request": "{{request}}",
"nonce": 1594297865000
}Response
Successful response - returns paginated order deals
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
}