Open Orders

List currently working (non-terminal) futures orders.

HTTP

Method	POST
Endpoint	/trade/api/v2/futures/orders/open
Rate limit	20 requests per 60 seconds

Request Parameters

Parameter	Type	Mandatory	Description
exchange	string	Yes	EXCHANGE_2.
symbol	string	No	Filter to a single symbol (e.g. BTCUSDT).
limit	integer	No	Page size. Maximum 50.
from_time	integer	No	Filter: orders created at/after this timestamp (Unix ms).
to_time	integer	No	Filter: orders created at/before this timestamp (Unix ms).

Time window

The difference between from_time and to_time cannot exceed 7 days. If you omit both, you get the latest 50 orders from the last 7 days.

To page through more, use the cursor returned in the response as the next call's to_time.

Example

Python

import requests

body = {"exchange": "EXCHANGE_2", "symbol": "btcusdt"}
headers, path = sign_request("POST", "/trade/api/v2/futures/orders/open")
response = requests.post(BASE_URL + path, headers=headers, json=body)
print(response.json())

Java

HttpResponse<String> resp = client.send(
    "POST", "/trade/api/v2/futures/orders/open", null,
    Map.of("exchange", "EXCHANGE_2", "symbol", "btcusdt"));
System.out.println(resp.body());

Go

body := map[string]any{
    "exchange": "EXCHANGE_2",
    "symbol": "btcusdt",
}
bodyJSON, _ := json.Marshal(body)
headers, p, err := SignRequest("POST", "/trade/api/v2/futures/orders/open", nil)
if err != nil { panic(err) }

req, _ := http.NewRequest("POST", BaseURL+p, bytes.NewReader(bodyJSON))
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 body = {"exchange": "EXCHANGE_2", "symbol": "btcusdt"};

const {headers, path} = signRequest('POST', '/trade/api/v2/futures/orders/open');
const r = await fetch(BASE_URL + path, {
  method: 'POST',
  headers,
  body: JSON.stringify(body),
});
console.log(await r.json());

Response

{
  "data": {
    "orders": [
      {
        "order_id": "01936c09-85a6-79d5-a7b8-d0e19daa9fbf",
        "exchange": "EXCHANGE_2",
        "symbol": "BTCUSDT",
        "side": "BUY",
        "status": "RAISED",
        "order_type": "LIMIT",
        "quantity": "160",
        "exec_quantity": "0",
        "price": "80000",
        "avg_execution_price": "0",
        "execution_fee": "0.1051",
        "realised_pnl": "0",
        "reduce_only": false,
        "created_at": 1732684383674,
        "updated_at": 1732684383674
      }
    ],
    "cursor": 1732684383674
  }
}

Response Parameters

Field	Type	Description
data.orders	array	Array of order objects. Each entry has the same shape as Place Order.
data.cursor	integer	Pagination marker (Unix ms timestamp of the oldest entry returned). Pass as to_time in the next call to fetch the next page.