組合期權詢價
POST/api/v1.0/quote/combo-option-quote按調用方給出的組合腿(合約 + BUY/SELL + 數量)獲取組合報價。side 必須由調用方傳入,不會根據策略類型推斷。 返回每組的 price / bid_price / ask_price / bid_volume / ask_volume / volume / turnover / last_close_price(價格和成交額均爲實際金額),並回顯 legs。 不返回 Greeks、IV、盈虧平衡點或 OHLC 數據。 支持美股和港股期權合約。美股備兌組合可包含一條標的正股腿(如 US.AAPL BUY 100)。港股不支持正股腿(擔保策略),返回 -8。單個組合的錯誤通過 item.rsp_code 返回。 實時行情,需登錄且該市場有實時權限。
請求參數
| 參數 | 類型 | 位置 | 必填 | 說明 |
|---|---|---|---|---|
combo_list | string | 請求體 | 是 | 組合列表。每元素一套組合,腿在 legs[]。美股/港股期權合約;美股備兌可再帶一條標的正股。港股不可帶正股。一組最多一條正股腿,同組市場必須相同。 |
請求示例
bash
curl -X POST 'https://webapi.moomoo.com/api/v1.0/quote/combo-option-quote' -H 'Content-Type: application/json' -d '{"combo_list":[{"legs":[{"code":"US.AAPL261218C200000","side":"BUY","quantity":1}]}]}' | jq響應字段
| 參數 | 類型 | 説明 |
|---|---|---|
data | object | |
data.quote_list | object[] | |
data.quote_list[].rsp_code | int | 單組詢價結果碼,0=成功 |
data.quote_list[].legs | string | 回顯的請求腿(code / side / quantity) |
data.quote_list[].price | number | 組合市價(实际价格) |
data.quote_list[].bid_price | number | 買一價(实际价格) |
data.quote_list[].ask_price | number | 賣一價(实际价格) |
data.quote_list[].bid_volume | int | 買一量 |
data.quote_list[].ask_volume | int | 賣一量 |
data.quote_list[].volume | int | 組合成交量 |
data.quote_list[].turnover | number | 組合成交額 |
data.quote_list[].last_close_price | number | 昨收價(实际价格) |
pagination | object | 部分接口返回分頁信息 |
錯誤碼
| ret_code | error.code | 說明 |
|---|---|---|
| 0 | — | 成功 |
| -3 | invalid_parameter | 參數缺失或不在允許範圍內 |
| -7 | invalid_symbol | 標的在證券庫中不存在 |
| -8 | unsupported | 市場或品類不在本接口範圍內 |
| -9 | permission_denied | 已登錄但沒有對應行情權限 |
| -10 | no_data | 當前沒有可返回的數據 |
| -11 | rate_limited | 調用過於頻繁 |
響應示例
json
{
"ret_code": 0,
"ret_msg": "success",
"data": {
"quote_list": [
{
"rsp_code": 0,
"legs": "example",
"price": 2.5,
"bid_price": 2.45,
"ask_price": 2.55,
"bid_volume": 10,
"ask_volume": 12,
"volume": 500,
"turnover": 125000,
"last_close_price": 2.4
}
]
}
}