当前位置： 首页 > news >正文

Tushare接口文档：期货合约信息表（fut_basic）

news 2026/7/26 13:13:23

  • 官方文档：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团队。本文另一个目的也是为了聚集大家的智慧以创建“我为人人，人人为我”的共创氛围。

http://www.cnnetsun.cn/news/3662383.html

相关文章：

  • AnimojiStudio：如何用iPhone制作无限时长的创意表情视频？
  • VR-Reversal：如何在普通设备上体验VR视频的自由视角探索
  • 3大突破解析：腾讯开源SongGeneration如何重新定义AI音乐创作边界
  • 魔兽世界终极宏编辑器：GSE如何彻底改变你的游戏操作体验
  • QuantLib高级随机过程建模：从数学原理到企业级金融工程应用
  • 如何在TypeScript项目中统一集成多个AI模型提供商？
  • LabVIEW光纤光栅准分布式传感解调系统
  • 异步FIFO深度解析：跨时钟域数据传输的核心架构设计
  • 智能体与扣子技术：从理论到生产环境的AI工程实践
  • Parabolic终极指南：3步掌握全网视频下载与格式转换技巧
  • 企业智能监管系统：计算机视觉与行为分析的自动化实践
  • AI文献检索工具链：Semantic Scholar与Elicit实战指南
  • TI CC26x0/CC13x0低功耗调试实战：WUC TAP与电源管理架构解析
  • 5分钟极速解锁：ncmppGui双平台NCM解密转换全攻略
  • 技术学习陷阱识别与优质社区构建指南
  • Dism++终极指南：5步让Windows系统运行如新的免费神器
  • 工地安全防护设备检测数据集构建与应用实践
  • 基于RetinaNet的校园建筑物智能识别系统设计与优化
  • TMSpeech：让你的电脑“听懂“每一个声音，离线语音转文字革命
  • UE4SS终极指南：5个步骤掌握虚幻引擎游戏脚本系统
  • 三合一QQ机器人框架：LuckyLilliaBot终极开发指南
  • 如何利用OrionCMS构建响应式管理后台：Bootstrap与Materialize主题全攻略
  • SRIO中断系统详解：从硬件配置到软件处理的完整指南
  • 一文读懂DenseNet核心原理：密集连接如何解决梯度消失难题
  • Ember CLI Rails多应用配置：轻松管理多个Ember前端项目的技巧
  • AI城市管理执法系统：技术赋能与效率提升实践
  • 知识图谱新范式：Nucleoid动态关系构建技术入门教程
  • 深入解析TI DM644x VPFE模块：嵌入式视觉图像处理流水线实战
  • AI邮件分拣≠关键词匹配！资深NLP工程师拆解真实生产环境中的意图识别偏差、多义词消歧与冷启动应对策略
  • TMS320F240xA事件管理器：通用定时器与中断机制深度解析