Files
alphafactor_tushare/references/futures_api.md

5.7 KiB
Raw Blame History

Tushare 期货接口文档

官方文档: https://tushare.pro/document/2?doc_id=134

基础信息接口

fut_basic - 期货合约基础信息

输入参数

名称 类型 必选 描述
exchange str N 交易所代码
fut_type str N 合约类型 (1: 普通合约 2: 主力合约)

输出字段

名称 类型 描述
ts_code str 合约代码
symbol str 交易标的
exchange str 交易所
name str 合约名称
fut_code str 合约标码
multiplier float 合约乘数
trade_unit str 交易单位
per_unit float 最小变动价位
delivery_date str 交割日期
delist_date str 最后交易日期
list_date str 上市日期
last_ddate str 最后交割日
trade_time_desc str 交易时间描述

行情接口

fut_daily - 期货日线行情

输入参数

名称 类型 必选 描述
trade_date str N 交易日期
ts_code str N 合约代码
exchange str N 交易所
start_date str N 开始日期
end_date str N 结束日期

输出字段

名称 类型 描述
ts_code str 合约代码
trade_date str 交易日期
pre_close float 昨收盘价
pre_settle float 昨结算价
open float 开盘价
high float 最高价
low float 最低价
close float 收盘价
settle float 结算价
change1 float 涨跌1收盘价-昨结算价)
change2 float 涨跌2结算价-昨结算价)
vol float 成交量(手)
amount float 成交金额(万元)
oi float 持仓量(手)
oi_chg float 持仓量变化
exchange str 交易所

fut_holding - 每日持仓排名

输入参数

名称 类型 必选 描述
trade_date str N 交易日期
symbol str N 合约代码(不带年份月份)
exchange str N 交易所

输出字段

名称 类型 描述
trade_date str 交易日期
symbol str 合约符号
broker str 期货公司会员
vol int 成交量
vol_chg int 成交量变动
long_hld int 多单持仓
long_chg int 多单持仓变动
short_hld int 空单持仓
short_chg int 空单持仓变动
exchange str 交易所

fut_wsr - 期货仓单日报

输入参数

名称 类型 必选 描述
trade_date str N 交易日期
symbol str N 合约代码
exchange str N 交易所

输出字段

名称 类型 描述
trade_date str 交易日期
symbol str 合约代码
wsr_num int 仓单数量
wsr_num_chg int 仓单数量变化
wsr_unit str 仓单单位
close float 收盘价
exchange str 交易所

fut_settle - 期货结算参数

输入参数

名称 类型 必选 描述
trade_date str N 交易日期
exchange str N 交易所

输出字段

名称 类型 描述
trade_date str 交易日期
ts_code str 合约代码
exchange str 交易所
settle float 结算价
trading_fee_rate float 交易手续费率
trading_fee float 交易手续费
delivery_fee float 交割手续费
min_price_chg float 最小变动价位

期货代码说明

交易所代码

代码 交易所 主要品种
SHFE 上海期货交易所 铜、铝、锌、黄金、原油、螺纹钢
DCE 大连商品交易所 豆粕、豆油、铁矿石、焦炭、玉米
CZCE 郑州商品交易所 棉花、白糖、PTA、菜粕、甲醇
CFFEX 中国金融期货交易所 沪深300、中证500、国债期货
INE 上海国际能源交易中心 原油期货
GFEX 广州期货交易所 工业硅、碳酸锂

常见品种代码

品种 代码 交易所
CU SHFE
AL SHFE
ZN SHFE
黄金 AU SHFE
白银 AG SHFE
原油 SC INE
螺纹钢 RB SHFE
热轧卷板 HC SHFE
天然橡胶 RU SHFE
豆粕 M DCE
豆油 Y DCE
棕榈油 P DCE
铁矿石 I DCE
焦炭 J DCE
焦煤 JM DCE
玉米 C DCE
棉花 CF CZCE
白糖 SR CZCE
PTA TA CZCE
甲醇 MA CZCE
菜粕 RM CZCE
玻璃 FG CZCE
纯碱 SA CZCE
沪深300指数期货 IF CFFEX
中证500指数期货 IC CFFEX
上证50指数期货 IH CFFEX
10年期国债期货 T CFFEX
5年期国债期货 TF CFFEX

合约代码格式

期货合约代码由 品种代码 + 到期年月 组成:

  • CU2403 - 2024年3月到期的铜合约
  • RB2405 - 2024年5月到期的螺纹钢合约
  • IF2403 - 2024年3月到期的沪深300股指期货

主力合约通常用 .SHF, .DCE, .CZC, .CFX 后缀表示:

  • CU.SHF - 铜主力合约(上期所)
  • M.DCE - 豆粕主力合约(大商所)
  • IF.CFX - 沪深300主力合约中金所

交易时间

日盘(上午 + 下午)

  • 上午09:00 - 10:15, 10:30 - 11:30
  • 下午13:30 - 15:00

夜盘(部分品种)

  • 21:00 - 23:00有色金属、黑色系等
  • 21:00 - 02:30原油、贵金属等

具体交易时间因品种而异,请参考各交易所规定。