Get Futures Order History

Your finished futures orders: FILLED, CANCELED, EXPIRED and REJECTED. It shares one query schema with the open orders endpoint and returns exactly the complementary set.

Permission: READ_ORDERS

This is the endpoint you need for two things

Fees and realized profit. Each element carries a fills array with feeAmount, feeAsset, isMaker and realisedPnl per execution. Sum them yourself, because there are no order-level totals. Note that GET /v1/futures/orders/{id} returns an order without its fills, so this list is the only place to read them.

Why an order was rejected. On rows with status: "REJECTED" this endpoint adds rejectReason (the venue's message) and venueCode (the venue's own code, often a number such as 109400). On every other row those keys are absent, not null.

The same filter warning applies: only limit works. The response is a bare JSON array, newest first, capped at 200 rows with no way to page further back.

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200

application/json

Bodyapplication/json

Example

[
  {
    "id": "clw8n2k4x0009abcdefghij",
    "symbol": "BTC-USDT",
    "positionSide": "LONG",
    "side": "BUY",
    "orderType": "LIMIT",
    "status": "FILLED",
    "price": "60000",
    "quantity": "0.01",
    "filledQty": "0.01",
    "avgPrice": "59998.5",
    "leverage": 10,
    "marginMode": "ISOLATED",
    "terminalAt": "2026-08-18T09:25:00.000Z",
    "createdAt": "2026-08-18T09:20:43.000Z",
    "fills": [
      {
        "id": "clw8n2k4x0010abcdefghij",
        "orderId": "clw8n2k4x0009abcdefghij",
        "venueFillId": "5566778899",
        "price": "59998.5",
        "quantity": "0.01",
        "feeAmount": "0.24",
        "feeAsset": "USDT",
        "isMaker": false,
        "realisedPnl": "0",
        "venueTs": "2026-08-18T09:24:59.900Z",
        "createdAt": "2026-08-18T09:25:00.000Z"
      }
    ]
  }
]

This is the endpoint you need for two things#

Request

Request Code Samples

Responses

This is the endpoint you need for two things