下單
POST/api/v1.0/accounts/{acc_id}/orders提交新的交易訂單。
路徑參數
| 參數 | 類型 | 必填 | 說明 |
|---|---|---|---|
acc_id | string | 是 | 業務賬戶 ID。 |
請求參數
| 參數 | 類型 | 位置 | 必填 | 說明 |
|---|---|---|---|---|
code | string | 請求體 | 是 | 可交易標的代碼。格式:exchange.symbol,例如 US.AAPL,US.AAPL250926C235000 |
qty | string | 請求體 | 是 | 訂單數量。期權和期貨的單位為「合約」。 |
price | string | 請求體 | 否 | 訂單價格。證券賬戶精確到 4 位小數(期貨精確到 9 位小數),超出部分四捨五入。 |
side | string | 請求體 | 是 | 交易方向。可選值:BUY、SELL、SELL_SHORT、BUY_BACK |
order_type | string | 請求體 | 是 | 訂單類型。可選值:LIMIT、MARKET、AUCTION、AUCTION_LIMIT、STOP、STOP_LIMIT、MARKET_IF_TOUCHED、LIMIT_IF_TOUCHED |
time_in_force | string | 請求體 | 是 | 有效期。可選值:DAY(當日有效)、GTC(撤單前有效) |
session | string | 請求體 | 否 | 交易時段(僅適用於美股)。可選值:RTH(常規交易時段)、RTH+Pre/Post-Mkt(盤前盤後)、OVERNIGHT(夜間交易)、ALL_DAY(全日交易)。市價單僅支持 RTH。 |
aux_price | string | 請求體 | 否 | 觸發價格。當訂單類型為 STOP、STOP_LIMIT、MARKET_IF_TOUCHED、LIMIT_IF_TOUCHED 時必填。證券賬戶精確到 3 位小數,期貨精確到 9 位小數。 |
lot_type | string | 請求體 | 否 | 手數類型,預設整手。適用於港股交易。 |
remark | string | 請求體 | 否 | 備註,UTF-8 編碼後最大長度 64 位元組。 |
order_class | string | 請求體 | 否 | 訂單類別。多腿訂單需指定為 MLEG。 |
multi_leg_info | object | 請求體 | 否 | 多腿訂單資訊,下多腿訂單時必填。 |
請求示例
bash
curl -X POST 'https://webapi.moomoo.com/api/v1.0/accounts/{acc_id}/orders' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <AccessToken>' \
-d '{
"code": "US.AAPL",
"qty": "100",
"price": "150.00",
"side": "BUY",
"order_type": "LIMIT",
"time_in_force": "DAY"
}' | jq響應示例
json
{
"s": "ok",
"d": {
"order_id": "New order identifier."
}
}失敗響應:
json
{
"s": "error",
"errcode": -1200,
"errmsg": "Error message.",
"jump_url": "a jump url",
"need_order_confirm": true,
"confirm_id": "a confirm id"
}提示
當響應中 need_order_confirm 為 true 時,需調用二次確認接口完成訂單確認。