下單
POST/api/v1.0/sim-trade/{acc_id}/orders模擬交易下單。數量和價格均為字串;限價單必須傳 price,市價單可不傳。下單不冪等:超時或結果未知時先查今日訂單,避免重複下單。服務端未建單時(如 market 與賬戶不符)返回 -5 backend_biz_error。
請求參數
| 參數 | 類型 | 位置 | 必填 | 說明 |
|---|---|---|---|---|
acc_id | string | path | 是 | 業務賬戶 ID |
market | int | body | 是 | 賬戶市場ID(賬戶列表中該賬戶的 market_id,如 1=港股 100=美股融資融券),必須與 acc_id 對應賬戶一致 |
symbol | string | body | 是 | 證券代碼,支援 MARKET.CODE(如 US.AAPL、US.AAPL261120C275000)或不帶前綴的代碼 |
order_type | int | body | 是 | 訂單類型:1=限價 3=市價 |
order_side | int | body | 是 | 買賣方向:1=買入 2=賣出 |
qty | string | body | 是 | 數量 |
price | string | body | 否 | 委託價格(限價單必填;市價單可不傳) |
text | string | body | 否 | 備註(≤100 字節) |
order_trade_time_type | int | body | 否 | 交易時段: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_id | string | 訂單 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"}
}