Order Details
GET/api/v1/crypto/accounts/{acc_id}/orders/{orderId}Query detailed information for one or more orders.
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
acc_id | uint64 | Yes | Account ID |
orderId | string | Yes | Order ID. Supports comma-separated batch queries of up to 20 orders. |
Response Parameters
| Field | Type | Description |
|---|---|---|
orders | list[OrderItem] | Order list |
Request Example
bash
# Single order
curl -X GET "https://webapi.futunn.com/api/v1/crypto/accounts/123456/orders/FTHC2989880641155745280T" \
-H "X-Api-Key: <AppKey>" \
-H "X-Timestamp: <timestamp_ms>" \
-H "X-Nonce: <nonce>" \
-H "Authorization: <signature_base64>"
# Batch query (comma-separated, up to 20)
curl -X GET "https://webapi.futunn.com/api/v1/crypto/accounts/123456/orders/FTHC001,FTHC002,FTHC003" \
-H "X-Api-Key: <AppKey>" \
-H "X-Timestamp: <timestamp_ms>" \
-H "X-Nonce: <nonce>" \
-H "Authorization: <signature_base64>"Response Example
json
{
"code": 0,
"msg": "success",
"data": {
"orders": [
{
"order_id": "FTHC2989880641155745280T",
"version": 1,
"symbol_pair": { "symbol": "BTCUSD", "base": "BTC", "quote": "USD" },
"side": "BUY",
"order_qty": "0.01",
"price": "30000",
"order_amount": "300.00",
"cum_qty": "0.01",
"avg_px": "30000",
"fill_amount": "300.00",
"ord_type": "LIMIT",
"time_in_force": "TIF_GTC",
"create_time": 1750000000000000,
"update_time": 1750000100000000,
"ord_status": "FILLED",
"order_show_id": "SHOW-001",
"is_close": true,
"trigger_price": "",
"trigger_time": 0,
"cash_order_qty": ""
}
]
}
}Error Response:
json
{
"code": 1,
"msg": "Error Message."
}