Get Order Status

Fetch the current state of a single futures order by order_id.

HTTP

Method	GET
Endpoint	/trade/api/v2/futures/order
Rate limit	20 requests per 60 seconds

Request Parameters

Parameter	Type	Mandatory	Description
order_id	string	Yes	The order_id you want to fetch.

Example

Python

import requests

headers, path = sign_request("GET", "/trade/api/v2/futures/order",
                             params={"order_id": "698ed406-8ef5-4664-9779-f7978702a447"})
response = requests.get(BASE_URL + path, headers=headers)
print(response.json())

Java

HttpResponse<String> resp = client.send(
    "GET", "/trade/api/v2/futures/order",
    Map.of("order_id", "698ed406-8ef5-4664-9779-f7978702a447"), null);
System.out.println(resp.body());

Go

headers, p, err := SignRequest("GET", "/trade/api/v2/futures/order", map[string]string{"order_id": "698ed406-8ef5-4664-9779-f7978702a447"})
if err != nil { panic(err) }

req, _ := http.NewRequest("GET", BaseURL+p, nil)
for k, v := range headers { req.Header.Set(k, v) }
resp, err := http.DefaultClient.Do(req)
if err != nil { panic(err) }
defer resp.Body.Close()
out, _ := io.ReadAll(resp.Body)
fmt.Println(string(out))

Node.js

const {signRequest, BASE_URL} = require('./reference-client');

const {headers, path} = signRequest('GET', '/trade/api/v2/futures/order', {"order_id": "698ed406-8ef5-4664-9779-f7978702a447"});
const r = await fetch(BASE_URL + path, {
  method: 'GET',
  headers,
});
console.log(await r.json());

Response

{
  "data": {
    "order": {
      "order_id": "698ed406-8ef5-4664-9779-f7978702a447",
      "exchange": "EXCHANGE_2",
      "symbol": "DOGEUSDT",
      "side": "BUY",
      "status": "CANCELLED",
      "order_type": "LIMIT",
      "quantity": "6.16",
      "exec_quantity": "0",
      "price": "0.28",
      "avg_execution_price": "0",
      "execution_fee": "0.0041",
      "realised_pnl": "0",
      "reduce_only": false,
      "created_at": 1732623664116,
      "updated_at": 1732623664116
    }
  }
}

Note the response is wrapped in data.order (singular), not data directly. Same field shape as Place Order's response.