期货合约列表 在线试调 →
期货在市合约列表: 代码/名称/品种族/交易所, 支持品种族与交易所筛选
接口说明
期货在市合约清单:四大交易所(中金所股指/国债 + 郑商/大商/上期商品)共1,100+ 合约,实约+连续合约,随目录每日刷新。
exchange=交易所市场号筛选(28郑商/29大商/30上期/47中金所);family=品种族前缀(IF/T/AP/CU/TA 等)
实约到期摘牌后不再出现在目录(历史已落数据仍可查)
快速调用
同一调用的三种等价写法,按接入习惯任选其一,复制即可运行。
全部合约
import top369 as gp
pro = gp.pro_api("sk-xxxxxxxxxxxx") # 安装: pip install top369
df = pro.fut_contracts()
print(df.head())
沪深300族
import top369 as gp
pro = gp.pro_api("sk-xxxxxxxxxxxx") # 安装: pip install top369
df = pro.fut_contracts(family="IF")
全部合约
import requests
API = "https://api.369.top/api"
KEY = "sk-xxxxxxxxxxxx"
r = requests.get(f"{API}/fut/contracts",
headers={"X-API-Key": KEY},
timeout=30)
r.raise_for_status()
data = r.json()["data"] # 信封解包, 本接口数据在 data["rows"]
沪深300族
import requests
API = "https://api.369.top/api"
KEY = "sk-xxxxxxxxxxxx"
r = requests.get(f"{API}/fut/contracts",
headers={"X-API-Key": KEY},
params={"family": "IF"},
timeout=30)
r.raise_for_status()
data = r.json()["data"] # 信封解包, 本接口数据在 data["rows"]
全部合约
curl -H "X-API-Key: sk-xxxxxxxxxxxx" \ "https://api.369.top/api/fut/contracts"
沪深300族
curl -H "X-API-Key: sk-xxxxxxxxxxxx" \ "https://api.369.top/api/fut/contracts?family=IF"
输入参数
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| family | str | 可选 | 品种族前缀: 中金所 IF/IH/IC/IM/IZ(股指) T/TF/TL/TS(国债) 或商品 AP/CU/M/TA 等, 缺省全部 |
| exchange | int | 可选 | 交易所(exhq市场号): 28=郑商所 29=大商所 30=上期所 47=中金所, 缺省全部 |
| limit | int | 可选 | 返回条数上限, 默认500(≤1000) |
返回字段
| 名称 | 类型 | 描述 |
|---|---|---|
| total | int | 命中合约总数 |
| rows[].code | str | 合约码(IF2612 实约 / IFL0 当月连续 / ZCL9 主力连) |
| rows[].name | str | 合约名称 |
| rows[].family | str | 品种族代码(IF/T/AP/CU/TA等) |
| rows[].family_name | str | 品种族名称 |
| rows[].exchange | int | 交易所市场号(28/29/30/47) |
| rows[].exchange_name | str | 交易所名称(郑商所/大商所/上期所/中金所) |
| rows[].continuous | bool | 是否连续合约 |
返回数据样例
{
"total": 12,
"rows": [
{
"code": "IF2610",
"name": "沪深2610",
"family": "IF",
"family_name": "沪深300",
"continuous": false
},
{
"code": "IF2611",
"name": "沪深2611",
"family": "IF",
"family_name": "沪深300",
"continuous": false
},
{
"code": "IF2612",
"name": "沪深2612",
"family": "IF",
"family_name": "沪深300",
"continuous": false
}
]
}
样例取自平台数据,rows共 12 条,样例仅展示前 3 条。
最佳实践:连续合约(IFL0 等)适合长期回测(免展期拼接); 实约(IF2612 等)到期摘牌后不再出现在目录(历史已落数据仍可查)。