Tushare ft_limit 期货合约涨跌停价格接口详解：在 Vibe-Trading 中获取每日涨跌停价与最低保证金率

Tushare ft_limit 期货合约涨跌停价格接口详解在 Vibe-Trading 中获取每日涨跌停价与最低保证金率【免费下载链接】Vibe-TradingVibe-Trading: Your Personal Trading Agent项目地址: https://gitcode.com/GitHub_Trending/vi/Vibe-Trading本篇技术指南以 Vibe-Trading 仓库中 Tushare 技能参考文档 期货合约涨跌停价格 为核心系统讲解ft_limit接口的输入/输出参数、调用示例、数据字段含义并结合仓库源码Tushare 加载器、国内期货回测引擎深入说明涨跌停价格、保证金率在期货策略回测中的底层作用与落地方式。读完本文你将掌握如何通过 Tushare 快速批量获取全部期货合约每日涨跌停价格与最低保证金率、如何按合约/品种/交易所/日期灵活筛选以及这些盘前数据在涨跌停封板过滤、保证金与杠杆测算等实战场景中的使用方法。接口概览ft_limit 能提供什么ft_limitFutures Limit是 Tushare 提供的期货涨跌停价格接口核心能力是获取所有期货合约每天的涨跌停价格涨停价up_limit、跌停价down_limit同时输出最低交易保证金率m_ratio单位 %历史数据开始于 2005 年覆盖 CFFEX / SHFE / DCE / ZCE / INE / GFEX 等国内期货交易所的合约单次最大获取 4000 行数据可通过日期、合约代码等参数循环拉取全部历史调用门槛用户积分达到 5000 分方可调取积分可通过 Tushare 官方积分机制获取具体以官方文档说明为准。从仓库的技能清单看该接口在 SKILL.md 中被注册为编号 368 的数据接口ft_limit归入期货数据分类与fut_daily日线行情、fut_settle每日结算参数、fut_mapping期货主力与连续合约等接口构成完整的期货数据体系。ft_limit的典型定位是盘前数据——交易所会在每个交易日开盘前公布当日涨跌停价格与保证金要求这正是它区别于收盘后生成的日线行情fut_daily的关键时间属性。前置准备环境、Token 与积分按照 SKILL.md 的快速上手说明调用ft_limit前需要完成以下准备安装 tushare 依赖包推荐 Python 3.7 环境可从清华 PyPI 镜像安装pip install tushare -i https://pypi.tuna.tsinghua.edu.cn/simple注册 Tushare 并获取 token配置为环境变量export TUSHARE_TOKENyour_token确认账户积分达到 5000 分。若积分不足接口会返回权限类错误无法正常取数。初始化 Pro API 实例。仓库 tushare.py 加载器 中的初始化方式可作为参考——它从配置读取TUSHARE_TOKEN并校验 token 是否为占位符TUSHARE_TOKEN_PLACEHOLDERS {, your-tushare-token}import os import tushare as ts token os.getenv(TUSHARE_TOKEN) or ts.get_token() pro ts.pro_api(token)输入参数详解ft_limit共支持 6 个输入参数全部可选标 N但实际使用时需至少提供一个筛选维度如日期或合约代码否则会返回全量数据。名称类型必选描述ts_codestrN合约代码trade_datestrN交易日期格式YYYYMMDDstart_datestrN开始日期格式YYYYMMDDend_datestrN结束日期格式YYYYMMDDcontstrN合约代码品种代码例如contCUexchangestrN交易所代码例如exchangeDCE参数使用要点ts_code与cont的区分ts_code是具体合约代码如A2503.DCE、ZN2509.SHF对应单一月份合约cont是品种代码如CU铜、A豆一、ZN沪锌一次可拉取该品种下全部月份合约的涨跌停价。trade_date/start_date/end_date日期统一使用YYYYMMDD格式如20250213。trade_date精确到单日start_date/end_date用于日期区间查询。exchange交易所代码常见取值包括DCE大连商品交易所、SHFE上海期货交易所、CFFEX中国金融期货交易所、ZCE郑州商品交易所、INE上海国际能源交易中心、GFEX广州期货交易所。从仓库 china_futures.py 的模块注释可以看出国内期货市场正是由这六家交易所构成。组合筛选各参数可以组合使用例如DCE 交易所某日的全部合约涨跌停价可同时传trade_date与exchange。输出参数详解接口每次返回一个 pandas DataFrame包含 8 个字段名称类型默认显示描述trade_datestrY交易日期ts_codestrYTS 合约代码namestrY合约名称up_limitfloatY涨停价down_limitfloatY跌停价m_ratiofloatY最低交易保证金率%contstrY合约代码品种代码exchangestrY交易所代码字段解读ts_code为 Tushare 标准化合约代码格式为品种代码年份月份交易所后缀例如A2503.DCE表示大商所 2025 年 3 月到期的豆一合约。up_limit/down_limit为当日涨停价与跌停价。国内期货的涨跌停板价格以前一交易日结算价为基准计算这一点在仓库 china_futures.py 中有明确体现self.base_price_fields (pre_settle, pre_close)并注释Futures bands come off the previous settlement, not the previous close期货涨跌停幅以昨结算价而非昨收盘价为基准。m_ratio为最低交易保证金率单位为 %。例如7.000表示该合约最低保证金比例为 7%。这是期货杠杆的核心变量——保证金率越低相同资金可撬动的合约名义价值越大。name为中文合约名称如连豆一2503沪锌2509便于人工阅读与展示。接口调用示例原文档给出的两个核心调用示例如下pro ts.pro_api() # 获取单日全部期货合约涨跌停价格 df pro.ft_limit(trade_date20250213) # 获取单个品种所有合约涨跌停价格 df pro.ft_limit(contCU)在此基础上可以扩展出更多实用调用方式import tushare as ts pro ts.pro_api() # 按交易所筛选获取 2025 年 2 月 13 日大商所全部合约涨跌停价 df_dce pro.ft_limit(trade_date20250213, exchangeDCE) # 按具体合约代码查询 df_a2503 pro.ft_limit(ts_codeA2503.DCE) # 按日期区间查询 df_range pro.ft_limit(start_date20250201, end_date20250213, contCU) # 单次最大 4000 行可循环翻页拉取全历史 import pandas as pd frames [] dates pro.trade_cal(exchangeDCE, start_date20250101, end_date20250228, is_open1) for d in dates[cal_date].tolist(): part pro.ft_limit(trade_dated, exchangeDCE) if part is not None and not part.empty: frames.append(part) df_all pd.concat(frames, ignore_indexTrue)说明由于ft_limit单次最多返回 4000 行而全市场期货合约数量通常远超此数原文档样例中仅 DCE SHFE 两个交易所单日就有近 800 条记录因此拉取全历史数据时推荐按交易日或交易所循环请求再使用pd.concat合并结果。交易日历可配合期货数据专题中的 交易日历 接口获取避免对非交易日发起无效请求。数据样例解读原文档给出了20250213交易日的数据样例trade_date ts_code name up_limit down_limit m_ratio cont exchange 0 20250213 A2503.DCE 连豆一2503 4229.000 3751.000 7.000 A DCE 1 20250213 A2505.DCE 连豆一2505 4249.000 3769.000 7.000 A DCE ... 783 20250213 ZN2509.SHF 沪锌2509 24890.000 21635.000 9.000 ZN SHFE 784 20250213 ZN2510.SHF 沪锌2510 24885.000 21630.000 9.000 ZN SHFE逐字段解读这几行数据A2503.DCE / 连豆一2503大连商品交易所豆一黄大豆 1 号2025 年 3 月合约。当日涨停价 4229 元/吨、跌停价 3751 元/吨最低保证金率 7%。A2505.DCE / A2507.DCE / A2509.DCE / A2511.DCE同一品种不同月份到期的合约涨跌停价随合约价位不同而不同但保证金率保持一致同为 7%说明保证金率按品种设定而非按月份合约。ZN2509.SHF / 沪锌2509上海期货交易所沪锌 2025 年 9 月合约。涨停价 24890 元/吨、跌停价 21635 元/吨最低保证金率 9%。可以看到不同品种的保证金率存在明显差异豆一 7% vs 沪锌 9%这与品种波动性和交易所风控要求直接相关。仓库 china_futures.py 中维护了一张按品种区分的保证金率表_MARGIN_RATE例如a: 0.08豆一 8%、zn: 0.08沪锌 8%与接口返回的最低保证金率互为印证——接口数据是交易所实际公布值引擎表是回测时的近似模拟值。涨跌停价与保证金率的市场含义涨跌停价的定价基准国内期货的涨跌停板价格并非简单按昨收盘价 × 涨跌幅计算而是以前一交易日结算价为基准。结算价由交易所按当日成交加权等方式确定与收盘价不同。这也是 china_futures.py 将base_price_fields设置为(pre_settle, pre_close)的原因——期货涨跌停幅度的计算基准与股票昨收盘有本质区别。该引擎注释中还给出了各交易所的价格波动范围规则股指期货CFFEX±10%国债期货CFFEX±2%简化商品期货±3%8% 不等。对应到代码中的_PRICE_LIMIT表IF/IC/IH/IM均为 0.10±10%国债T为 0.02、TF0.012、TS0.005、TL0.035未列出的商品品种默认按 0.055%处理。这与ft_limit返回的每个合约当日具体涨跌停价格形成对照接口给出的是每个合约的实际价格数值而引擎表给出的是回测时的品种级涨跌幅比例近似值。保证金率与杠杆m_ratio最低交易保证金率直接决定期货交易的杠杆倍数杠杆 ≈ 1 / 保证金率。例如保证金率 7% 对应约 14.3 倍杠杆9% 对应约 11.1 倍杠杆。在 china_futures.py 中_leverage_for_symbol正是通过1.0 / self.get_margin_rate(symbol)从保证金率推导杠杆而_MARGIN_RATE表记录的品种保证金率范围约在 1.5%12% 之间如国债TS为 0.015、镍ni为 0.12与接口文档所述保证金率随品种不同而不同完全一致。涨跌停价在回测中的执行过滤涨跌停价格在回测引擎中的一个关键用途是执行过滤当某合约开盘即封在涨停/跌停板上时买单/卖单可能无法成交。仓库 china_futures.py 的can_execute方法在每次模拟交易时调用_blocked_by_limit定义于 china_a.py结合品种涨跌幅比例判断当前 bar 是否处于涨跌停封板状态从而决定是否允许成交。若使用ft_limit提供的每日精确涨跌停价格替换品种级比例近似值可以让回测的成交过滤更加贴近真实市场。在 Vibe-Trading 项目中的落地方式技能体系中的数据源定位Vibe-Trading 将 Tushare 封装为 Agent 可调用的数据源技能入口为 SKILL.md。该技能以references/目录下的 Markdown 文档作为接口参考手册本文主题文档即其中之一Agent 通过阅读这些文档获知接口参数、调用方法与返回结构再编写 Python 代码调取数据。同一技能目录下还提供了 股票数据获取示例 与 基金数据获取示例 两个脚本模板。加载器与限频处理仓库的 tushare.py 加载器 展示了生产级调用 Tushare 的工程细节对编写ft_limit的循环拉取代码同样适用Token 校验is_available()检查TUSHARE_TOKEN是否已配置且非占位符限频识别与退避重试_RATE_LIMIT_MARKERS通过异常文本中的每分钟/每天/抽取/频率/rate limit等标记识别配额拒绝_call_with_backoff按 5 秒、20 秒、40 秒三级退避等待_RATE_LIMIT_BACKOFF_SECONDS等待窗口覆盖 Tushare 每分钟配额周期错误隔离单个合约/日期拉取失败只记录 warning不中断整体任务——这在按日循环拉取全历史涨跌停价时尤为重要。需要注意的是该加载器当前声明支持的 market 为{a_share, hk_equity, fund}并明确注释未声明 futures原因在于期货日线接口fut_daily需要较高的积分门槛加载器暂未实现对应积分档位因此期货数据目前更适合通过技能文档 独立脚本的方式使用。这一点说明若要在 Vibe-Trading 中正式接入期货行情需要账户具备相应积分能力这也是使用ft_limit时必须满足 5000 积分门槛的相同约束。与其他期货数据接口的配合ft_limit通常与期货数据专题中的其他接口配合使用形成完整的期货策略数据闭环日线行情fut_daily提供pre_close、pre_settle、OHLC 等每日行情可与涨跌停价对照验证价格是否触及板幅每日结算参数fut_settle提供交易与交割费率等结算参数合约信息fut_basic提供合约列表用于构造需要遍历的合约代码集合期货主力与连续合约fut_mapping用于将逐月合约映射为主力/连续序列。使用注意事项与最佳实践积分门槛ft_limit需要 5000 积分未达标账户会收到权限错误。使用前请先确认账户积分状态。单次行数限制单次最大返回 4000 行。全市场合约数据量大务必按trade_date或配合exchange循环拉取再用pd.concat合并避免数据截断。日期格式所有日期参数统一使用YYYYMMDD字符串格式如20250213不要使用带连字符的YYYY-MM-DD或 datetime 对象。品种代码大小写cont参数按品种代码传入如CU沪铜、ZN沪锌、A豆一。注意不同交易所品种代码风格不同可从 合约信息 接口获取权威品种代码列表。限频控制Tushare 对积分档位有限频约束。循环取数时建议引入退避重试机制参考 tushare.py 加载器 的_call_with_backoff模式识别每分钟/每天等配额拒绝文本并等待后重试而不是盲目重发请求。盘前时间属性涨跌停价是盘前公布的当日数据与收盘后生成的日线行情时间语义不同。若用于回测需注意将当日涨跌停价与当日行情正确对齐避免引入未来函数look-ahead bias。与引擎参数互为校验ft_limit返回的实际涨跌停价和保证金率可用于校验回测引擎如 china_futures.py中品种级默认参数_PRICE_LIMIT、_MARGIN_RATE的合理性对引擎未覆盖的品种也可从接口数据中提取真实参数进行校准。通过本文的完整讲解你已具备从环境准备、参数筛选、循环取数到回测落地的一整套ft_limit使用能力。无论是做期货涨跌停统计、封板率分析还是为多品种期货策略补充精确的保证金与价格限制数据都可以直接以原文档 期货合约涨跌停价格 为速查手册、以仓库源码为实现参考快速构建出可运行的数据管线。【免费下载链接】Vibe-TradingVibe-Trading: Your Personal Trading Agent项目地址: https://gitcode.com/GitHub_Trending/vi/Vibe-Trading创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考