股票与公司MCP / HTTP API
list_option_contracts
list_option_contracts发现境内 ETF、IO/HO/MO 股指期权合约,默认保留已到期合约。
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
| underlying | string | 是 | - | 标的标准代码,如 510050.SH、159919.SZ、000300.SH |
| exchange | string | 否 | null | 交易所 可选值:SSE / SZSE / CFFEX |
| option_type | string | 否 | null | C=认购,P=认沽 可选值:C / P |
| as_of | string | 否 | null | 查询该日存续合约,YYYY-MM-DD;不能与 include_expired=false 混用 |
| include_expired | boolean | 否 | true | 默认包含已到期合约;false 只保留尚未到期合约 |
| limit | integer | 否 | 100 | 每页行数 |
| offset | integer | 否 | 0 | 分页偏移;续页使用 next_offset,保持其他查询条件一致 |
使用说明
先按标的标准代码查合约,再使用返回的 ticker 查询历史行情;as_of 可筛选指定日期存续的合约。结合覆盖状态判断可用范围。