期权合同列表 在线试调 →
期权在市合同列表: 代码/名称/交易所, 支持市场筛选与模糊匹配
接口说明
三大期权市场在市合同清单:中金所股指期权(IO/HO/MO)、上交所 ETF/个股期权、深交所 ETF 期权,共 1900+ 合约,随目录每日刷新。
market=7/8/9 限定市场;keyword 名称/代码模糊(如 IO、510050)
合同有到期日,目录只含在市合同;已摘牌合同的历史数据仍可查
快速调用
同一调用的三种等价写法,按接入习惯任选其一,复制即可运行。
中金所股指期权合同
import top369 as gp
pro = gp.pro_api("sk-xxxxxxxxxxxx") # 安装: pip install top369
df = pro.option_contracts(market=7)
print(df.head())
50ETF期权模糊匹配
import top369 as gp
pro = gp.pro_api("sk-xxxxxxxxxxxx") # 安装: pip install top369
df = pro.option_contracts(market=8, keyword="510050")
中金所股指期权合同
import requests
API = "https://api.369.top/api"
KEY = "sk-xxxxxxxxxxxx"
r = requests.get(f"{API}/option/contracts",
headers={"X-API-Key": KEY},
params={"market": 7},
timeout=30)
r.raise_for_status()
data = r.json()["data"] # 信封解包, 本接口数据在 data["total"]
50ETF期权模糊匹配
import requests
API = "https://api.369.top/api"
KEY = "sk-xxxxxxxxxxxx"
r = requests.get(f"{API}/option/contracts",
headers={"X-API-Key": KEY},
params={"market": 8, "keyword": "510050"},
timeout=30)
r.raise_for_status()
data = r.json()["data"] # 信封解包, 本接口数据在 data["total"]
中金所股指期权合同
curl -H "X-API-Key: sk-xxxxxxxxxxxx" \ "https://api.369.top/api/option/contracts?market=7"
50ETF期权模糊匹配
curl -H "X-API-Key: sk-xxxxxxxxxxxx" \ "https://api.369.top/api/option/contracts?market=8&keyword=510050"
输入参数
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| market | int | False | 期权市场: 7=中金所 8=上交所 9=深交所, 缺省全部 |
| keyword | str | False | 合同名称/代码模糊匹配(如: IO 或 510050) |
| limit | int | False | 返回条数上限, 默认200(≤2000) |
返回字段
| 名称 | 类型 | 描述 |
|---|---|---|
| total | int | 命中合同总数 |
| items[].code | str | 合同码(IO930668 / 10011425 / 90007393) |
| items[].name | str | 合同名称 |
| items[].exchange | str | 交易所(中金所/上交所/深交所) |
| items[].catalog_date | str | 目录日期 |
返回数据样例
{
"total": 1940,
"count": 3,
"items": [
{
"market": 7,
"exchange": "中金所",
"code": "HO8Y03TI",
"name": "HO2610-P-2475",
"catalog_date": "2026-10-18"
},
{
"market": 7,
"exchange": "中金所",
"code": "HO8Y03TJ",
"name": "HO2610-C-2475",
"catalog_date": "2026-10-18"
},
{
"market": 7,
"exchange": "中金所",
"code": "HO8Y03UW",
"name": "HO2610-P-2500",
"catalog_date": "2026-10-18"
}
]
}
最佳实践:先 /option/contracts 建本地合同池, 再逐合同 /option/daily 或 /option/minute_kline; 合同到期摘牌后不再出现在目录(历史已落数据仍可查)。