尧图网站建设 尧图网络
  • 首页
  • 关于我们
  • 服务项目
  • 案例展示
  • 建站流程
  • 资讯中心
  • 联系我们
首页/资讯中心/详情

Tushare接口文档:期货合约信息表(fut_basic)

Tushare接口文档:期货合约信息表(fut_basic)
📅 发布时间:2026/7/26 13:30:24
  • 官方文档:https://tushare.pro/document/2?doc_id=135

  • 功能描述:获取期货合约的代码、名称、乘数、交易单位、上市日期、最后交易日等关键信息

  • 返回限量:单次请求最大返回10000行

  • 接口权限:2000积分200次/分钟,5000积分500次/分钟

  • 说明:

  1. 本接口需要通过交易所代码循环遍历来获取所有合约信息,无法在一次请求内完成(示例1有较为详尽的演示);

输入参数:

名称

类型

必选

描述

exchange

str

N

交易所代码

fut_type

str

N

合约类型

ts_code

str

N

合约代码

fut_code

str

N

标准合约代码

list_date

str

N

上市开始日期

  1. 交易所代码取值有:CFFEX-中金所、DCE-大商所、CZCE-郑商所、SHFE-上期所、INE-上海国际能源交易中心、GFEX-广州期货交易所;

  2. 合约类型取值有:1-普通合约、2-主力与连续合约。默认取全部;

  3. 标准合约代码即为期货品种的代码,如:AG-白银、AP-鲜苹果;

  4. 输入参数中的list_date为上市开始日期,即该日期及以后上市的合约均会获取到,与输出数据中的同名字段有差异,输出数据中的同名字段数据表示该合约上市日期(示例4有较为详尽的演示);

输出参数:

名称

类型

默认显示

描述

ts_code

str

Y

合约代码

symbol

str

Y

交易标识

exchange

str

Y

交易市场

name

str

Y

中文简称

fut_code

str

Y

合约产品代码

multiplier

float

Y

合约乘数(只适用于国债期货、指数期货)

trade_unit

str

Y

交易计量单位

per_unit

float

Y

交易单位(每手)

quote_unit

str

Y

报价单位

quote_unit_desc

str

Y

最小报价单位说明

d_mode_desc

str

Y

交割方式说明

list_date

str

Y

上市日期

delist_date

str

Y

最后交易日期

d_month

str

Y

交割月份

last_ddate

str

Y

最后交割日

trade_time_desc

str

N

交易时间说明

示例:

示例1:获取所有合约所有默认显示的数据

虽然所有的输入参数都不是必选的,但由于输出行数的限制,在想要获取所有合约的场景下,本文作者建议还是按照交易所代码(exchange)获取单个交易所的所有期货合约进行循环遍历。

import tushare as ts import pandas as pd pro = ts.pro_api() lst_dfs = [] exchanges = ['CFFEX', 'DCE', 'CZCE', 'SHFE', 'INE', 'GFEX'] for e in exchanges: df = pro.fut_basic(exchange=e) lst_dfs.append(df) df_all = pd.concat(lst_dfs, ignore_index=True) df_all

输出结果:

ts_code symbol exchange name fut_code multiplier trade_unit per_unit quote_unit quote_unit_desc d_mode_desc list_date delist_date d_month last_ddate 0 T1906.CFX T1906 CFFEX T1906 T 10000.0 张 1.0 人民币元 0.005人民币元 实物交割 20180917 20190614 201906 20190619 1 TF1906.CFX TF1906 CFFEX TF1906 TF 10000.0 张 1.0 人民币元 0.005人民币元 实物交割 20180917 20190614 201906 20190619 2 IF1507.CFX IF1507 CFFEX IF1507 IF 300.0 张 1.0 指数点 0.2指数点 现金交割 20150518 20150717 201507 20150717 3 T1703.CFX T1703 CFFEX T1703 T 10000.0 张 1.0 人民币元 0.005人民币元 实物交割 20160614 20170310 201703 20170315 4 IM2505.CFX IM2505 CFFEX IM2505 IM 200.0 张 1.0 指数点 0.2指数点 现金交割 20250324 20250516 202505 20250516 ... ... ... ... ... ... ... ... ... ... ... ... ... ... ... ... 11114 PT2706.GFE PT2706 GFEX 粤铂2706 PT NaN 克 1000.0 人民币元/克 0.05人民币元/克 实物交割 20260615 20270615 202706 20270618 11115 SI2706.GFE SI2706 GFEX 粤工业硅2706 SI NaN 吨 5.0 人民币元/吨 5人民币元/吨 实物交割 20260615 20270615 202706 20270618 11116 LC2707.GFE LC2707 GFEX 粤碳酸锂2707 LC NaN 吨 1.0 人民币元/吨 20人民币元/吨 实物交割 20260715 20270714 202707 20270719 11117 PS2707.GFE PS2707 GFEX 粤多晶硅2707 PS NaN 吨 3.0 人民币元/吨 5人民币元/吨 实物交割 20260715 20270714 202707 20270719 11118 SI2707.GFE SI2707 GFEX 粤工业硅2707 SI NaN 吨 5.0 人民币元/吨 5人民币元/吨 实物交割 20260715 20270714 202707 20270719 11119 rows × 15 columns

示例2: 筛选当前正在交易的活跃合约

本示例在示例1的基础上通过delist_date(最后交易日)大于等于当前日期的条件,筛选出尚未到期的活跃合约。

from datetime import datetime today = datetime.today().strftime('%Y%m%d') df_active = df_all[df_all['delist_date'] >= today] df_active

输出结果:

ts_code symbol exchange name fut_code multiplier trade_unit per_unit quote_unit quote_unit_desc d_mode_desc list_date delist_date d_month last_ddate 48 IF2609.CFX IF2609 CFFEX IF2609 IF 300.0 张 1.0 指数点 0.2指数点 现金交割 20260119 20260918 202609 20260918 107 IF2612.CFX IF2612 CFFEX IF2612 IF 300.0 张 1.0 指数点 0.2指数点 现金交割 20260420 20261218 202612 20261218 118 TF2609.CFX TF2609 CFFEX TF2609 TF 10000.0 张 1.0 人民币元 0.005人民币元 实物交割 20251215 20260911 202609 20260916 204 TL2612.CFX TL2612 CFFEX TL2612 TL 10000.0 张 1.0 人民币元 0.01人民币元 实物交割 20260316 20261211 202612 20261216 250 IM2609.CFX IM2609 CFFEX IM2609 IM 200.0 张 1.0 指数点 0.2指数点 现金交割 20260119 20260918 202609 20260918 ... ... ... ... ... ... ... ... ... ... ... ... ... ... ... ... 11114 PT2706.GFE PT2706 GFEX 粤铂2706 PT NaN 克 1000.0 人民币元/克 0.05人民币元/克 实物交割 20260615 20270615 202706 20270618 11115 SI2706.GFE SI2706 GFEX 粤工业硅2706 SI NaN 吨 5.0 人民币元/吨 5人民币元/吨 实物交割 20260615 20270615 202706 20270618 11116 LC2707.GFE LC2707 GFEX 粤碳酸锂2707 LC NaN 吨 1.0 人民币元/吨 20人民币元/吨 实物交割 20260715 20270714 202707 20270719 11117 PS2707.GFE PS2707 GFEX 粤多晶硅2707 PS NaN 吨 3.0 人民币元/吨 5人民币元/吨 实物交割 20260715 20270714 202707 20270719 11118 SI2707.GFE SI2707 GFEX 粤工业硅2707 SI NaN 吨 5.0 人民币元/吨 5人民币元/吨 实物交割 20260715 20270714 202707 20270719 871 rows × 15 columns

示例3:获取所有主力与连续合约

通过传递fut_type参数可指定合约类型,从而仅获取“普通合约”或“主力与连续合约”。

df = pro.fut_basic(fut_type='2') df.head()

输出结果:

ts_code symbol exchange name fut_code multiplier trade_unit per_unit quote_unit quote_unit_desc d_mode_desc list_date delist_date d_month last_ddate 0 SS.SHF SS SHFE 不锈钢主力 SS None None None None None None None None None None 1 PG.DCE PG DCE LPG主力 PG None None None None None None None None None None 2 PGL.DCE PGL DCE LPG连续 PG None None None None None None None None None None 3 BCL.INE BCL INE 国际铜连续 BC None None None None None None None None None None 4 SH.ZCE SH CZCE 烧碱主力 SH None None None None None None None None None None

示例4:获取某日以来上市的某个品种期货的合约

通过传递list_date可获取该日及以后上市的期货合约,传递fut_code(标准合约代码)可指定特定期货品种,传递fields参数可获取指定的字段。本示例演示获取截至目前(2026/07/26)自2026/01/01以来上市的所有棕榈油(品种代码为:P)的期货合约,返回所有字段(包括默认不返回的trade_time_desc(交易时间说明))。

主力与连续合约没有上市日期;

fields = 'ts_code,symbol,exchange,name,fut_code,multiplier,trade_unit,per_unit,quote_unit,quote_unit_desc,d_mode_desc,list_date,delist_date,d_month,last_ddate,trade_time_desc' df = pro.fut_basic(list_date='20260101', fut_code='P', fields=fields) df

输出结果:

ts_code symbol exchange name fut_code multiplier trade_unit per_unit quote_unit quote_unit_desc d_mode_desc list_date delist_date d_month last_ddate trade_time_desc 0 P2701.DCE P2701 DCE 棕榈油2701 P None 吨 10.0 人民币元/吨 1人民币元/吨 实物交割 20260119 20270115 202701 20270120 上午9:00-11:30,下午13:30-15:00,下午21:00-23:00(夜盘) 1 P2702.DCE P2702 DCE 棕榈油2702 P None 吨 10.0 人民币元/吨 1人民币元/吨 实物交割 20260224 20270212 202702 20270226 上午9:00-11:30,下午13:30-15:00,下午21:00-23:00(夜盘) 2 P2703.DCE P2703 DCE 棕榈油2703 P None 吨 10.0 人民币元/吨 1人民币元/吨 实物交割 20260316 20270312 202703 20270317 上午9:00-11:30,下午13:30-15:00,下午21:00-23:00(夜盘) 3 P2704.DCE P2704 DCE 棕榈油2704 P None 吨 10.0 人民币元/吨 1人民币元/吨 实物交割 20260416 20270416 202704 20270421 上午9:00-11:30,下午13:30-15:00,下午21:00-23:00(夜盘) 4 P2705.DCE P2705 DCE 棕榈油2705 P None 吨 10.0 人民币元/吨 1人民币元/吨 实物交割 20260520 20270519 202705 20270524 上午9:00-11:30,下午13:30-15:00,下午21:00-23:00(夜盘) 5 P2706.DCE P2706 DCE 连棕油2706 P None 吨 10.0 人民币元/吨 1人民币元/吨 实物交割 20260615 20270615 202706 20270618 日盘交易:每周一至周五9:00~11:30,13:30~15:00;夜盘交易:前一自然日21... 6 P2707.DCE P2707 DCE 连棕油2707 P None 吨 10.0 人民币元/吨 1人民币元/吨 实物交割 20260715 20270714 202707 20270719 日盘交易:每周一至周五9:00~11:30,13:30~15:00;夜盘交易:前一自然日21...

示例5:获取单个合约的基础信息

传递参数ts_code可获取单个合约的基础信息。

df = pro.fut_basic(ts_code='P2707.DCE') df

输出结果:

ts_code symbol exchange name fut_code multiplier trade_unit per_unit quote_unit quote_unit_desc d_mode_desc list_date delist_date d_month last_ddate 0 P2707.DCE P2707 DCE 连棕油2707 P None 吨 10.0 人民币元/吨 1人民币元/吨 实物交割 20260715 20270714 202707 20270719

说明:

本文说明

本文旨在对Tushare的期货合约信息表fut_basic数据接口进行介绍,提供更多参考示例和使用说明。

本接口用于查询期货合约基础信息的元数据。它提供了期货合约的代码、名称、乘数、交易单位、上市日期、最后交易日等关键信息,是进行期货数据分析和交易前必须了解的基础工具。本文介绍了如何获取所有合约信息,如何筛选当前正在交易的活跃合约,获取某日以来上市的某个品种期货的合约等。

本文目的是为了让用户和AIGC工具能够更便捷、准确地使用该接口。大家在使用过程中遇到什么问题和建议可在线留言,作者会进行数据探索将结果更新到文章中,并将建议反馈给Tushare团队。本文另一个目的也是为了聚集大家的智慧以创建“我为人人,人人为我”的共创氛围。

相关新闻

  • 嵌入式RTOS核心机制:信号量与邮箱的原理、应用与避坑指南
  • 终极Windows PS3手柄兼容方案:DsHidMini完全使用指南
  • 基于YOLO的太阳能电池板智能检测系统开发实践

最新新闻

  • BiRefNet-fp16常见问题解答:解决MLX图像抠图中的技术难题
  • TI CC2564B蓝牙评估板硬件设计与软件集成实战指南
  • 怎样轻松找回Chrome保存的所有密码:3个实用秘诀快速上手
  • 深入解析Cortex-M33调试寄存器:FPB、FPE、ICB与ITM实战指南
  • AntiDupl.NET:开源图片去重工具完整教程,轻松释放硬盘空间的高效解决方案
  • 2026大庆全屋渗漏修缮实用指南|三大正规修缮机构横向测评 - 筑宅安

日新闻

  • 大连理工大学与东京大学联手打造的“主动型AI助手“
  • 170.2026年国家级科研瓶颈:超精密单点金刚石切削(SPDT)光学表面生成
  • SongBloom:革命性歌曲生成框架深度解析——如何通过交织自回归与扩散模型创作完整音乐

周新闻

  • 大连理工大学与东京大学联手打造的“主动型AI助手“
  • 170.2026年国家级科研瓶颈:超精密单点金刚石切削(SPDT)光学表面生成
  • SongBloom:革命性歌曲生成框架深度解析——如何通过交织自回归与扩散模型创作完整音乐

月新闻

  • 2026年6月公司网站搭建最新热门渠道测评:四大低成本/零代码平台对比+避坑
  • 【Linux】Linux arm 编译QT程序,出现expected “}“报错
  • 【MATLAB例程】四基站二维AOA定位与距离辅助增强对比仿真。基于角度观测和测距修正的固定目标平面定位精度分析

关于尧图

  • 公司简介
  • 团队介绍
  • 企业文化
  • 荣誉资质

服务项目

  • 定制开发
  • 电商建站
  • UI 设计
  • 运维服务

快速链接

  • 案例展示
  • 建站流程
  • 常见问题
  • 资讯中心

联系方式

  • 📍北京市朝阳区互联网产业园 A 座 10 层
  • 📞400-888-8888
  • ✉️contact@rkmt.cn
  • 🕐周一至周日 9:00-21:00

© 2024 北京尧图网络科技有限公司 版权所有 | 京 ICP 备 XXXXXXXX 号