订单详情

GET /api/v1/crypto/accounts/{acc_id}/orders/{orderId}

查询一个或多个订单的详细信息。

路径参数

参数	类型	必填	说明
acc_id	uint64	是	账户 ID
orderId	string	是	订单 ID，支持英文逗号分隔批量查询，最多 20 个

响应参数

字段	类型	说明
orders	list[OrderItem]	订单列表

请求示例

# 单个订单
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>"

# 批量查询（逗号分隔，最多 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>"

响应示例

{
  "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": ""
      }
    ]
  }
}

失败响应：

{
  "code": 1,
  "msg": "Error Message."
}