期权链
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
}
]
}
}