下單

POST /api/v1/crypto/accounts/{acc_id}/orders

提交新的加密貨幣交易訂單。

路徑參數

參數	類型	必填	說明
acc_id	uint64	是	賬戶 ID

請求參數

參數	類型	位置	必填	說明
req_id	string	請求體	是	冪等 ID，長度 16–64 字符，推薦格式 時間戳_uuid。網關加 gw_ 前綴後透傳至下游用於防重
side	string	請求體	是	買賣方向，可選值參見命名詞典
symbol	string	請求體	是	交易對，如 BTCUSD
ord_type	string	請求體	是	訂單類型，可選值參見命名詞典
time_in_force	string	請求體	是	訂單有效期，可選值參見命名詞典
price	string	請求體	條件	委託價格。ord_type 為 LIMIT、TAKE_PROFIT_LIMIT、STOP_LOSS_LIMIT 時必填
qty	string	請求體	條件	委託數量，與 cash_order_qty 二選一
cash_order_qty	string	請求體	條件	金額下單金額，與 qty 二選一。僅支持 side=BUY 且 ord_type=MARKET 的買入市價單
conditional_info	object	請求體	條件	條件單信息。ord_type 為 TAKE_PROFIT_LIMIT、TAKE_PROFIT_MARKET、STOP_LOSS_LIMIT、STOP_LOSS_MARKET 時必填

conditional_info 字段

參數	類型	必填	說明
trigger_price	string	是	條件單觸發價

請求示例

curl -X POST "https://webapi.futunn.com/api/v1/crypto/accounts/123456/orders" \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: <AppKey>" \
  -H "X-Timestamp: <timestamp_ms>" \
  -H "X-Nonce: <nonce>" \
  -H "Authorization: <signature_base64>" \
  -d '{
    "req_id": "1750000000000_a1b2c3d4e5f6g7h8",
    "side": "BUY",
    "symbol": "BTCUSD",
    "ord_type": "LIMIT",
    "qty": "0.01",
    "price": "30000",
    "time_in_force": "TIF_GTC"
  }'

響應示例

{
  "code": 0,
  "msg": "success",
  "data": {
    "order_id": "FTHC2989880641155745280T"
  }
}

失敗響應：

{
  "code": 550000001,
  "msg": "Invalid code. Please adjust and place the order again."
}

提示

錯誤碼 550000001 表示交易對非法，當前僅支持「數字幣 + 法幣」的交易對（如 BTCUSD）。