期货合约列表 在线试调 →

期货在市合约列表: 代码/名称/品种族/交易所, 支持品种族与交易所筛选

门槛注册即用(免费版可用)

数据四大期货交易所在市合约清单(中金所股指/国债 + 郑商/大商/上期商品, 共1,100+), 实约+连续合约, 随目录每日刷新

限制≤1000条/次; 连续合约码尾 L0/L1/L2=当月连/下月连/下季连(商品 L9=主力连); exchange=交易所市场号筛选

接口说明

期货在市合约清单:四大交易所(中金所股指/国债 + 郑商/大商/上期商品)共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")

输入参数

名称类型必填描述
familystr可选品种族前缀: 中金所 IF/IH/IC/IM/IZ(股指) T/TF/TL/TS(国债) 或商品 AP/CU/M/TA 等, 缺省全部
exchangeint可选交易所(exhq市场号): 28=郑商所 29=大商所 30=上期所 47=中金所, 缺省全部
limitint可选返回条数上限, 默认500(≤1000)

返回字段

名称类型描述
totalint命中合约总数
rows[].codestr合约码(IF2612 实约 / IFL0 当月连续 / ZCL9 主力连)
rows[].namestr合约名称
rows[].familystr品种族代码(IF/T/AP/CU/TA等)
rows[].family_namestr品种族名称
rows[].exchangeint交易所市场号(28/29/30/47)
rows[].exchange_namestr交易所名称(郑商所/大商所/上期所/中金所)
rows[].continuousbool是否连续合约

返回数据样例

{
  "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 等)到期摘牌后不再出现在目录(历史已落数据仍可查)。

认证方式、代码规范、错误码等通用约定见文档首页; 可在在线测试中直接调试本接口。