HORIZON INSIGHTS / 开发文档

工具文档

金融数据工具的参数、返回结果与调用示例。
接入指南
股票与公司MCP / HTTP API

list_option_contracts

list_option_contracts

发现境内 ETF、IO/HO/MO 股指期权合约,默认保留已到期合约。

参数类型必填默认说明
underlyingstring是-标的标准代码,如 510050.SH、159919.SZ、000300.SH
exchangestring否null交易所
可选值:SSE / SZSE / CFFEX
option_typestring否nullC=认购,P=认沽
可选值:C / P
as_ofstring否null查询该日存续合约,YYYY-MM-DD;不能与 include_expired=false 混用
include_expiredboolean否true默认包含已到期合约;false 只保留尚未到期合约
limitinteger否100每页行数
offsetinteger否0分页偏移;续页使用 next_offset,保持其他查询条件一致
使用说明

先按标的标准代码查合约,再使用返回的 ticker 查询历史行情;as_of 可筛选指定日期存续的合约。结合覆盖状态判断可用范围。