期權鏈
GET/api/v1.0/quote/{symbol}/option-chain獲取指定標的和到期日範圍的期權鏈，每條記錄是單個 CALL 或 PUT 合約。 返回包含：合約代碼、stock_id、合約名稱、每手股數、證券類型（DRVT）、期權方向（CALL/PUT）、標的股代碼、行權日、行權價、index_option_type（NORMAL/SMALL/N/A）、到期週期（MONTH/WEEK/END_OF_MONTH/QUARTERLY/WEEKMON-FRI/N/A）、期權規格（STANDARD/NON_STANDARD/N/A）。 支持市場：HK / US / JP；其他市場返回 ret_code=-8 unsupported。 支持港美日正股，及港股恒指/國指/恆科等指數與美股 VIX/XSP/DJX/OEX 及板塊/RUT 等指數標的；指數標的需傳 index_option_type；普通正股不傳。 暫不支持的指數：US..SPX、US..NDX（暫無數據）。 start/end 為可選 yyyy-MM-dd 區間；當無期權鏈時返回空列表；服務端單次查詢最多返回 20 個到期日（按時間近優先）。 到期日列表請用 quote.option_expiration_date；期權 IV/HV 分析請用 quote.option_volatility；期權行權概率請用 quote.option_exercise_probability。
請求參數
| 參數 | 類型 | 位置 | 必填 | 說明 |
|---|---|---|---|---|
symbol | string | 路徑 | 是 | 期權標的代碼（路徑參數），例: HK.00700 |
start | string | 查詢 | 否 | 起始到期日 yyyy-MM-dd（含），不傳則不限下界。例: 2026-05-01 |
end | string | 查詢 | 否 | 結束到期日 yyyy-MM-dd（含），不傳則不限上界。例: 2026-05-31 |
index_option_type | int | 查詢 | 否 | 指數期權類型（僅指數標的需要，普通正股不傳）。港股: 1=HSI/2=HSCEI/3=Mini-HSI/4=Mini-HSCEI/5=HSTECH；美股: 1000=兜底指數期權/1001=VIX/1003=XSP/1005=EFS/1006=MXS/1007=DJX/1008=OEX/1009=SIXB/1010=SIXI/1011=SIXM/1012=SIXU/1013=SIXV/1014=XEO/1015=BKX/1016=XAU/1017=OSX/1018=SOX/1019=UTY/1020=RUT/1021=SIXRE/1022=XND/1023=CBTX/1024=MBTX；日股: 2001=N225/2002=N225M/2003=TOPIX。SPX(1002)/NDX(1004) 暫無數據，已移除 |
filter_standard | string | 查詢 | 否 | 按標準/非標準期權過濾；ALL=全部（默認），STANDARD=僅標準期權，NON_STANDARD=僅非標準期權（FLEX 等調整後合約） |
請求示例
bash
curl 'https://webapi.moomoo.com/api/v1.0/quote/US.AAPL/option-chain' | jq響應字段
| 參數 | 類型 | 說明 |
|---|---|---|
data.option_chain | object[] | |
data.option_chain[].code | string | 期權合約代碼，例: HK.TCH260528C230000 |
data.option_chain[].stock_id | string | 期權合約數值 ID，例: 81210697 |
data.option_chain[].name | string | 期權合約英文名 |
data.option_chain[].sc_name | string | 期權合約簡體中文名，例: 騰訊 260528 230.00 購 |
data.option_chain[].tc_name | string | 期權合約繁體中文名 |
data.option_chain[].lot_size | int | 每手合約股數，例: 100 |
data.option_chain[].stock_type | string | 證券類型，期權合約固定為 DRVT |
data.option_chain[].option_type | string | 期權方向，取值: CALL（看漲）/ PUT（看跌） |
data.option_chain[].stock_owner | string | 標的股代碼，例: HK.00700 |
data.option_chain[].strike_time | string | 行權日，格式 yyyy-MM-dd，例: 2026-05-28 |
data.option_chain[].strike_price | number | 行權價，例: 230 |
data.option_chain[].index_option_type | string | 指數期權類型，取值: NORMAL（標準指數期權）/ SMALL（小型指數期權，如恒指小型/國指小型）/ N/A（非指數期權或未指定） |
data.option_chain[].expiration_cycle | int | 到期週期，取值: MONTH / WEEK / END_OF_MONTH / QUARTERLY / WEEKMON / WEEKTUE / WEEKWED / WEEKTHU / WEEKFRI / N/A |
data.option_chain[].option_standard_type | int | 期權規格類型，取值: STANDARD（標準）/ NON_STANDARD（非標準 / FLEX 等調整後合約）/ N/A |
錯誤碼
| 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": {
"option_chain": [
{
"code": "US.AAPL",
"stock_id": "example",
"name": "example",
"sc_name": "example",
"tc_name": "example",
"lot_size": 0,
"stock_type": "example",
"option_type": "example",
"stock_owner": "example",
"strike_time": "example",
"strike_price": 1.2,
"index_option_type": "example",
"expiration_cycle": 0,
"option_standard_type": 0
}
]
}
}