Skip to content

下單 ​

POST /api/v1.0/sim-trade/{acc_id}/orders

模擬交易下單。數量和價格均為字串;限價單必須傳 price,市價單可不傳。下單不冪等:超時或結果未知時先查今日訂單,避免重複下單。服務端未建單時(如 market 與賬戶不符)返回 -5 backend_biz_error。

請求參數 ​

參數類型位置必填說明
acc_idstringpath是業務賬戶 ID
marketintbody是賬戶市場ID(賬戶列表中該賬戶的 market_id,如 1=港股 100=美股融資融券),必須與 acc_id 對應賬戶一致
symbolstringbody是證券代碼,支援 MARKET.CODE(如 US.AAPL、US.AAPL261120C275000)或不帶前綴的代碼
order_typeintbody是訂單類型:1=限價 3=市價
order_sideintbody是買賣方向:1=買入 2=賣出
qtystringbody是數量
pricestringbody否委託價格(限價單必填;市價單可不傳)
textstringbody否備註(≤100 字節)
order_trade_time_typeintbody否交易時段:0=未設置 1=僅盤中 2=含盤前盤後(美股融資融券賬戶支援)

請求示例 ​

bash
curl -s -X POST "https://webapi.futunn.com/api/v1.0/sim-trade/80306537/orders" \
  -H "Authorization: Bearer <AccessToken>" \
  -H "Content-Type: application/json" \
  -d '{"market":100,"symbol":"US.AAPL","order_type":1,"order_side":1,"qty":"1","price":"1","order_trade_time_type":1}' | jq

響應欄位 ​

欄位類型說明
order_idstring訂單 ID

響應示例 ​

json
{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "order_id": "1294505"
  }
}

錯誤響應 ​

HTTP 狀態仍為 200。請求失敗時返回非 0 的 ret_code 和 error 物件。

json
{
  "ret_code": -3,
  "ret_msg": "invalid request",
  "error": {"code": "invalid_parameter", "message": "invalid request"}
}

服務端未建單時(如 market 與賬戶不符)同樣按失敗返回:

json
{
  "ret_code": -5,
  "ret_msg": "backend business error",
  "error": {"code": "backend_biz_error", "message": "backend business error"}
}