事件合約 Combo 詢價
POST/api/v1.0/quote/combo-quotes事件合約 Combo 詢價:提交至少兩腿合約與 MVC 標的,返回 YES 買/賣價、quote_id 與 rfq_id。 combo_legs 每腿:code(KS 合約或 .YES/.NO 子合約,後綴原樣回顯)、side(BUY/SELL/SELL_SHORT/BUY_BACK)、 qty_ratio(正整數,所有腿必須相同)、pred_side(YES/NO,各腿可以不同);position_id 可選。 side 不參與詢價,只回顯給下單;詢價只用 pred_side。返回價格仍是 YES 買/賣價。 跨事件組腿:每個事件最多 1 條腿。不要把 valid-combo-list 同一條 event 的 combo_contracts 互組。 mvc 必須來自 quote.valid_combo_list,不可自行構造。詢價可能走緩存價,非精確詢價。 quote_id、rfq_id 有時效,過期後需重新詢價。服務端未下發時對應欄位省略。無需先訂閱。
請求參數
| 參數 | 類型 | 位置 | 必填 | 說明 |
|---|---|---|---|---|
mvc | string | 請求體 | 是 | MVC 標的,必須從 quote.valid_combo_list 的 data.mvc 原樣傳入 |
mvc_exchange | string | 請求體 | 否 | MVC 交易所,可選;有則與 data.mvc_exchange 一起原樣傳入 |
combo_legs | string | 請求體 | 是 | 組合腿,至少 2 條,最多 20 條。必須跨事件,每個事件最多 1 條。各腿 pred_side 可以不同;side 與 qty_ratio 所有腿必須相同 |
請求示例
bash
curl -X POST 'https://webapi.moomoo.com/api/v1.0/quote/combo-quotes' -H 'Content-Type: application/json' -d '{}' \
-H 'Authorization: Bearer <AccessToken>' | jq響應參數
| 參數 | 類型 | 說明 |
|---|---|---|
data.combo_legs | string | 回顯的組合腿 |
data.bid_price | string | YES 買價,範圍 (0,1) |
data.ask_price | string | YES 賣價,範圍 (0,1) |
data.quote_id | string | 報價 ID,有時效,下單需儘快使用 |
data.rfq_id | string | 詢價單 ID,與 quote_id 成對返回;服務端未下發時省略 |
data.should_retry | bool | 是否建議重試詢價 |
data.bid_size | string | 買價數量 |
data.ask_size | string | 賣價數量 |
錯誤碼
| ret_code | error.code | 說明 |
|---|---|---|
| 0 | — | 成功 |
| -3 | invalid_parameter | 參數不合法 |
| -8 | unsupported | 不支援 |
| -10 | no_data | 沒有數據 |
響應示例
json
{
"ret_code": 0,
"ret_msg": "success",
"data": {
"combo_legs": "example",
"bid_price": "example",
"ask_price": "example",
"quote_id": "example",
"rfq_id": "example",
"should_retry": false,
"bid_size": "example",
"ask_size": "example"
}
}