多彩编程 多彩编程MZPH · CODE BLOG
ARTICLE DETAIL

文章详情

深耕前端与后端开发技术的一线实战笔记与踩坑复盘。

Tushare 转融资交易汇总接口(slb_len)实战指南:从权限配置到量化因子落地

Tushare 转融资交易汇总接口(slb_len)实战指南:从权限配置到量化因子落地 金融科技示例工程【免费下载链接】ai_quant_tradeStock AI Trader: 1-stop platform for learning, sim live trading. Covers: stock basics, strategies, LLMs, factor mining, ML/DL/RL, graph nets, HFT, C deploy JoinQuant code. 股票AI操盘手一站式学习、模拟、实盘平台。涵盖股票基础、策略、大模型、因子挖掘、机器学习/深度学习/强化学习、图网络、高频交易、C部署及聚宽代码。项目地址https://gitcode.com/gh_mirrors/ai/ai_quant_trade点击查看免费下载导读本文聚焦 Tushare 数据接口中两融及转融通专题下的转融资交易汇总接口名slb_len讲解如何在 ai_quant_trade 仓库的 tushare Skill 包 规范下完成接口鉴权、参数调用、返回字段解析与批量历史数据拉取。读完本文你将掌握通过slb_len获取转融通融资全市场汇总数据的能力并能将其用于资金面观察与量化策略因子构建。一、接口定位转融通融资在两融及转融通数据体系中的位置转融通业务是证券公司向证金公司借入资金转融资或有价证券转融券再出借给客户开展融资融券交易的机制。slb_len接口提供的是转融通融资汇总数据即全市场转融资交易的每日汇总口径属于资金供给端的重要观测指标。在 Tushare 的数据体系中该接口归属于股票数据 → 两融及转融通分类同目录下还包含融资融券交易汇总margin融资融券每日交易汇总细分为融资余额、融券余额等融资融券交易明细margin_detail个股维度的融资融券明细转融券交易汇总slb_sec.md) 等部分接口已标注停用。其中margin反映的是投资者直接融资融券的存量与流量而slb_len反映的是券商向证金公司借入资金的规模二者结合可以形成资金供给端 → 资金使用端的完整分析链路。二、调用前置条件环境与权限准备在调用slb_len之前需要按 SKILL.md 中的快速上手流程完成环境配置2.1 安装 tushare推荐 Python 3.7 环境通过清华 PyPI 镜像安装pip install tushare -i https://pypi.tuna.tsinghua.edu.cn/simple2.2 配置访问令牌Token在 Tushare 官网注册账号获取 token 后配置环境变量export TUSHARE_TOKENyour_token仓库中的示例脚本 stock_data_example.py 给出了标准的 token 读取与pro接口初始化方式可直接复用import tushare as ts import os # 读取环境变量中的token, 或者读取本地记录的token token os.getenv(TUSHARE_TOKEN) or ts.get_token() # 初始化pro接口 pro ts.pro_api(token)2.3 接口权限说明slb_len对积分有明确要求积分档位每分钟请求次数限制2000 积分200 次/分钟5000 积分500 次/分钟单次请求最大可提取5000 行数据通过按日期区间循环请求可获取全部历史数据。这意味着即使数据量较大也无需担心漏数只需在循环中控制请求节奏即可。三、接口参数详解3.1 输入参数名称类型必选描述trade_datestrN交易日期YYYYMMDD 格式下同start_datestrN开始日期end_datestrN结束日期三个参数均为可选。实际使用中推荐优先使用 start_date / end_date 区间查询一次性拉取一段交易日范围内的汇总数据trade_date则适用于单日定点查询或核对某个具体日期的数据。三个参数既可单独使用也可组合使用如同时指定 trade_date 与日期区间。3.2 输出参数名称类型默认显示描述trade_datestrY交易日期obfloatY期初余额亿元auc_amountfloatY竞价成交金额亿元repo_amountfloatY再借成交金额亿元repay_amountfloatY偿还金额亿元cbfloatY期末余额亿元字段语义解读ob / cb期初与期末余额是全市场转融资资金的存量口径二者与当日成交、偿还之间存在勾稽关系期末余额 ≈ 期初余额 再借成交金额 − 偿还金额repo_amount再借成交金额反映当日券商向证金公司新增借入的资金规模是判断资金供给意愿的核心流量指标repay_amount偿还金额反映当日归还的资金规模auc_amount竞价成交金额对应以竞价方式成交的转融资部分部分交易日该字段可能为空见下方数据示例中的None。所有金额字段单位均为亿元与margin接口输出参数以元为单位的约定不同拼接使用不同接口时需注意单位换算。四、接口调用示例与数据样例4.1 标准调用pro ts.pro_api() df pro.slb_len(start_date20240601, end_date20240620)返回结果即为 pandas DataFrame可直接用于后续数据处理与入库。4.2 返回数据样例以 2024 年 6 月前半月数据为例节选trade_date ob auc_amount repo_amount repay_amount cb 0 20240620 1435.50 None 3.10 3.10 1435.50 1 20240619 1435.50 None 2.70 2.70 1435.50 2 20240618 1440.20 None 29.50 34.20 1435.50 3 20240617 1442.20 None 3.00 5.00 1440.20 4 20240614 1442.20 None None None 1442.20 5 20240613 1445.20 None 2.90 5.90 1442.20 6 20240612 1445.20 None 3.30 3.30 1445.20 7 20240611 1454.20 None 2.70 11.70 1445.20 8 20240607 1454.20 None None None 1454.20 9 20240606 1454.20 None 26.00 26.00 1454.20 10 20240605 1455.60 None 6.00 7.40 1454.20 11 20240604 1406.00 50.00 6.40 6.80 1455.60 12 20240603 1406.00 None 1.00 1.00 1406.00从样例可以观察出几个实战要点数据为全市场汇总口径每个交易日只返回一行不存在个股维度因此单次 5000 行的限额对应约 20 年的日频数据一次请求即可覆盖全部历史auc_amount多数交易日为None仅在特定交易日如 20240604 的 50.00 亿元有值处理数据时需对空值做填充或剔除处理存量ob/cb与流量repo_amount/repay_amount天然满足平衡关系例如 20240604期初 1406.00 再借 6.40 − 偿还 6.80 ≈ 期末 1405.60样例中 20240605 期初即 1455.60存在跨日口径衔接可用于数据质量校验。五、批量拉取全部历史数据的最佳实践由于单次最大提取 5000 行而该接口为日频单行数据通常一次区间请求即可覆盖全部历史。但为了通用性和健壮性建议采用按年度/季度分段 循环拉取 合并去重的模式同时遵守积分对应的每分钟请求频率上限2000 积分 200 次/分5000 积分 500 次/分。import time import tushare as ts pro ts.pro_api() def fetch_slb_len_all(start20100101, end20261231, chunk_days60): 按日期分片循环拉取转融资交易汇总全量历史 import datetime start_dt datetime.datetime.strptime(start, %Y%m%d) end_dt datetime.datetime.strptime(end, %Y%m%d) frames [] cur start_dt while cur end_dt: nxt cur datetime.timedelta(dayschunk_days) if nxt end_dt: nxt end_dt df pro.slb_len( start_datecur.strftime(%Y%m%d), end_datenxt.strftime(%Y%m%d), ) frames.append(df) cur nxt time.sleep(0.3) # 控制请求频率避免触发限流 return pd.concat(frames, ignore_indexTrue).drop_duplicates(trade_date)要点说明分片步长日频数据按 60 天分片单次请求行数远低于 5000 行上限安全且有冗余去重相邻分片可能因节假日或数据更新产生重复记录drop_duplicates(trade_date)保证主键唯一限流控制sleep间隔结合自身积分档位设置2000 积分建议不低于 0.3 秒/次5000 积分可适当加密。六、实战应用转融资数据如何用于量化研究slb_len数据的核心价值在于刻画券商体系从证金公司获得资金的供给规模可作为资金面观察与策略信号的补充维度资金面情绪指标跟踪cb期末余额的连续变化判断转融资资金总规模趋势结合 融资融券交易汇总margin 的融资余额rzye对比供给端 vs 需求端的剪刀差再借成交脉冲识别repo_amount出现显著放量如样例中 20240618 的 29.50 亿元明显高于前后交易日时可标记为资金供给异动事件作为择时或风控的辅助信号数据质量校验利用期末余额 期初余额 再借 − 偿还的勾稽关系对跨日数据做一致性检查过滤异常样本后再进入因子池与明细数据联动当需要下钻到个股层面时可结合 融资融券交易明细margin_detail构建总量趋势 个股结构的多层次分析框架。七、注意事项与限制接口状态slb_len当前为可用接口而部分同类接口如转融券相关接口、做市借券接口在仓库文档中已标注停接入前请确认接口仍处于正常服务状态积分门槛2000 积分起可用积分决定每分钟请求频率高频循环拉取前务必确认自己的积分档位单位口径本接口金额单位为亿元与其他融资融券接口元不同跨接口聚合时需统一单位空值处理auc_amount等多数字段在部分交易日为None建模前需按研究需要填充或剔除数据版权数据来源于交易所及证金公司公开披露仅建议用于个人与机构研究请遵守 Tushare 数据使用规范。八、小结slb_len转融资交易汇总是 Tushare两融及转融通体系中观察转融通资金供给端的高质量日频接口参数简单、返回字段语义清晰、单次可覆盖全部历史。结合仓库 tushare Skill 包 提供的鉴权模板与 股票数据示例脚本开发者可以快速将其接入本地数据库用于资金面监控、策略信号构造与数据质量校验等量化研究场景。赞分享金融科技示例工程【免费下载链接】ai_quant_tradeStock AI Trader: 1-stop platform for learning, sim live trading. Covers: stock basics, strategies, LLMs, factor mining, ML/DL/RL, graph nets, HFT, C deploy JoinQuant code. 股票AI操盘手一站式学习、模拟、实盘平台。涵盖股票基础、策略、大模型、因子挖掘、机器学习/深度学习/强化学习、图网络、高频交易、C部署及聚宽代码。项目地址https://gitcode.com/gh_mirrors/ai/ai_quant_trade点击查看免费下载相关推荐Vibe-Trading 实战指南用 Tushare slb_len 接口构建转融资交易汇总数据管线Vibe Trading 实战指南用 Tushare slb_len 接口构建转融资交易汇总数据管线 本篇技术指南以 Vibe Trading 仓库内置的 T人工智能AI Agent金融科技MCP 服务ai_quant_trade 债券大宗交易数据获取实战Tushare bond_blk 接口从权限配置到量化落地ai_quant_trade 债券大宗交易数据获取实战Tushare bond_blk 接口从权限配置到量化落地 导读 本文以 ai_quant_trade金融科技示例工程ai_quant_trade 两融数据接入实战使用 Tushare margin 接口获取融资融券交易汇总数据ai_quant_trade 两融数据接入实战使用 Tushare margin 接口获取融资融券交易汇总数据 导读 本文基于 ai_quant_trade金融科技示例工程上一篇SharpKeys终极教程Windows键盘重映射完全指南下一篇如何3步实现暗黑3操作自动化智能辅助工具终极指南创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表