下单

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）。