Vibe-Trading 实战指南用 Tushareslb_len接口构建转融资交易汇总数据管线【免费下载链接】Vibe-TradingVibe-Trading: Your Personal Trading Agent项目地址: https://gitcode.com/GitHub_Trending/vi/Vibe-Trading本篇技术指南以 Vibe-Trading 仓库内置的 Tushare 技能文档 转融资交易汇总 为核心系统讲解转融通融资汇总接口slb_len的调用方式、参数语义、字段字典与数据勾稽关系。读完本文你将掌握如何在 Vibe-Trading 的 Agent 技能体系中接入该数据源并能独立编写循环拉取全历史 本地落盘的完整数据获取脚本为两融资金面的量化研究提供日频基础数据。一、接口定位两融及转融通数据家族中的转融资汇总在 Vibe-Trading 的 Tushare 技能目录中slb_len被归类在股票数据 两融及转融通分类下。查阅技能索引 SKILL.md 可以看到该接口的注册信息为字段内容接口 ID331接口名slb_len标题转融资交易汇总分类股票数据, 两融及转融通描述转融通融资汇总从接口字段与数据示例的结构看slb_len反映的是证券金融公司向证券公司转融通融出资金的全市场汇总口径ob期初余额与cb期末余额刻画资金池规模repo_amount再借成交金额与repay_amount偿还金额刻画资金进出节奏。它不包含个股维度每个交易日仅返回一行汇总记录适合作为宏观资金面观察指标。在两融及转融通目录下slb_len与四个兄弟接口共同构成完整的数据家族它们在维度与口径上互补融资融券交易汇总margin券商向投资者融资融券的每日交易汇总按交易所维度SSE/SZSE/BSE输出融资融券交易明细margin_detail沪深两市每日融资融券明细个股维度转融券交易汇总(停).md)slb_sec转融通转融券交易汇总个股维度现已标注停止做市借券交易汇总(停).md)slb_len_mm做市借券交易汇总现已标注停止。对比可见slb_len是两融及转融通家族中目前仍在维护、且口径为全市场汇总的转融资数据接口这一点从目录命名转融券与做市借券文件名均带(停)后缀转融资未标注可以得到印证。二、调用前置条件环境、Token 与积分权限1. 安装与 Token 配置依据 SKILL.md 的快速上手说明首先安装 Python 运行环境推荐 Python 3.7与tushare依赖包pip install tushare -i https://pypi.tuna.tsinghua.edu.cn/simple随后在 Tushare 官网注册账号获取 token并配置环境变量export TUSHARE_TOKENyour_token在 Vibe-Trading 项目中仓库提供的股票数据示例脚本 stock_data_example.py 展示了更工程化的 token 读取方式——优先从项目环境配置读取失败时回退到ts.get_token()import tushare as ts from src.config.accessor import get_env_config token get_env_config().data.tushare_token or ts.get_token() pro ts.pro_api(token)这说明在 Vibe-Trading 中Tushare token 已纳入项目的统一环境配置体系tushare_token配置项Agent 调用数据接口时无需在代码中硬编码密钥。2. 积分与频率限制根据关联文档slb_len接口的权限门槛如下限量单次最大可提取 5000 行数据可循环获取所有历史积分2000 积分每分钟可请求 200 次5000 积分每分钟可请求 500 次。由于slb_len每日仅产生一行汇总数据5000 行的单次上限可覆盖约 20 年的全部历史记录一般场景下单次调用即可取全若需高频率轮询请按积分档位控制请求节奏避免触发限频。三、输入参数详解slb_len共支持 3 个输入参数均为可选必选列均为 N格式约定为YYYYMMDD名称类型必选描述trade_datestrN交易日期YYYYMMDD 格式下同start_datestrN开始日期end_datestrN结束日期参数组合逻辑按单日查询仅传trade_date返回指定交易日的数据推荐用于盘后增量更新按区间查询同时传start_date与end_date返回区间内全部交易日数据推荐用于历史回补不传参数可返回近期默认数据用于快速了解数据结构。需要注意交易日与自然日并不完全重合。若传入区间内包含节假日或周末接口不会返回对应日期的记录参考数据示例中 20240614 之后直接跳到 20240617中间 6 月 15 日、16 日为周末无数据行。四、输出参数详解与数据字典slb_len返回 6 个字段全部默认显示名称类型默认显示描述trade_datestrY交易日期obfloatY期初余额(亿元)auc_amountfloatY竞价成交金额(亿元)repo_amountfloatY再借成交金额(亿元)repay_amountfloatY偿还金额(亿元)cbfloatY期末余额(亿元)字段业务含义与使用要点obOpening Balance期初余额当日开盘前的转融资资金存量单位亿元auc_amountAuction Amount竞价成交金额通过竞价方式撮合的转融资成交金额。从数据示例看该字段在多数交易日为None仅个别日期有值如 20240604 为 50.00可以推断竞价成交并非转融资的常规路径仅在特定情形下发生因此处理该列时需做好空值兼容repo_amountRepurchase Amount再借成交金额当日再借展期/续借成交金额是转融资资金滚动续作的主要通道repay_amountRepay Amount偿还金额当日偿还的转融资资金cbClosing Balance期末余额当日收盘后的转融资资金存量单位亿元。在 Vibe-Trading 中调用时返回对象为 pandas DataFrameSKILL.md 明确返回格式pandas DataFrame可直接基于trade_date建立时间索引进行时序分析。五、接口示例与完整可运行代码1. 原文档示例关联文档给出的最小调用示例如下pro ts.pro_api() df pro.slb_len(start_date20240601, end_date20240620)2. 工程化完整示例结合 SKILL.md 的初始化约定与 stock_data_example.py 的 token 读取方式可将其扩展为可复制的完整脚本import os import tushare as ts # 方式一环境变量 token os.getenv(TUSHARE_TOKEN) or ts.get_token() # 方式二Vibe-Trading 项目统一配置仓库示例脚本采用 # from src.config.accessor import get_env_config # token get_env_config().data.tushare_token or ts.get_token() pro ts.pro_api(token) # 按日期区间查询转融资交易汇总 df pro.slb_len(start_date20240601, end_date20240620) print(df)slb_len同样支持 Tushare 的通用查询语法与margin接口的用法一致参见 融资融券交易汇总df pro.query(slb_len, start_date20240601, end_date20240620)3. 循环拉取全部历史的实战模板由于单次最多提取 5000 行而slb_len每日仅一行实际上一次请求即可覆盖全部历史但如果希望按年分片、稳健回补并落盘可以按如下模式组织import pandas as pd def fetch_slb_len_all(pro, start20100101, end20241231, chunks(0101, 1231)): frames [] for year in range(int(start[:4]), int(end[:4]) 1): s f{year}{chunks[0]} e f{year}{chunks[1]} part pro.slb_len(start_dates, end_datee) if part is not None and not part.empty: frames.append(part) # 按积分档位控制频率例如 time.sleep(0.3) df pd.concat(frames, ignore_indexTrue) if frames else pd.DataFrame() df df.sort_values(trade_date).drop_duplicates(trade_date) df.to_csv(slb_len_history.csv, indexFalse) return df分年片请求既能规避单次 5000 行的行数上限风险也便于断点续传与增量更新。六、数据示例解读从一行记录读懂转融资业务关联文档给出的数据示例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从这组真实数据中可以验证三个关键规律1期初余额承接上一交易日期末余额。例如 20240620 的ob1435.50恰好等于 20240619 的cb1435.5020240619 的ob又等于 20240618 的cb。这印证了ob/cb的存量承接关系可用于数据完整性校验。2期末余额大体满足期初 再借成交 − 偿还的勾稽关系。例如 202406181440.20 29.50 − 34.20 1435.50与cb完全一致202406171442.20 3.00 − 5.00 1440.20同样吻合。多数交易日该恒等式成立但在个别交易日如 20240604存在竞价成交等额外因素扰动因此不能机械地仅用三列求和建议以接口原始数据为准。3auc_amount空值常态化。12 行示例中仅 1 行有值其余均为None。在做均值、占比等统计前必须先以fillna(0)或dropna()明确空值策略。七、与两融及转融通家族其他接口的对比接口方法名维度关键字段状态转融资交易汇总slb_len全市场汇总日频 1 行ob / auc_amount / repo_amount / repay_amount / cb正常融资融券交易汇总margin按交易所汇总SSE/SZSE/BSErzye / rzmre / rqye / rqmcl / rzrqye正常融资融券交易明细margin_detail个股维度rzye / rqye / rzmre / rqyl / rzrqye正常转融券交易汇总slb_sec个股维度ope_inv / lent_qnt / cls_inv / end_bal已停做市借券交易汇总slb_len_mm个股维度ope_inv / lent_qnt / cls_inv / end_bal已停选择建议若研究券商融资资金总盘子与资金面压力使用slb_len全市场口径、字段聚焦资金存量与流转若需拆分沪深北交易所看投资者两融余额使用margin若需定位到具体标的的融资融券敞口使用margin_detail。注意已标注停止的slb_sec与slb_len_mm仅可回取历史数据不再产出新记录。八、在 Vibe-Trading 项目中的接入方式Vibe-Trading 通过技能Skill体系向 Agent 暴露外部数据源Tushare 技能即其中之一。其接入路径如下技能清单与接口索引所有 Tushare 数据接口统一登记在 SKILL.md 的数据接口列表中slb_lenID 331以标准表格形式收录Agent 可通过技能清单发现该接口并定位其详细文档 转融资交易汇总技能注册与调度从 skills.py 的统计口径看tushare是项目内被高频使用的数据供给技能之一在该文件中记录的技能用量统计中占有显著比例这意味着两融及转融通数据可以被 Agent 在行情分析、资金面研究中按需调用Token 统一配置仓库示例脚本 stock_data_example.py 展示了从get_env_config().data.tushare_token读取密钥的规范写法接口调用统一经由ts.pro_api(token)初始化。因此在 Vibe-Trading 中构建转融资数据管线时推荐流程为先在 SKILL.md 确认接口清单与参数格式约定再按本文第五节模板编写拉取脚本最后将 DataFrame 按trade_date索引持久化供后续因子计算或策略研究使用。九、注意事项与使用建议行数与频率限制单次最大 5000 行、按积分档位限频2000 积分 200 次/分钟5000 积分 500 次/分钟。slb_len日频仅一行历史全量通常一次可取完但建议保留循环分片逻辑以备扩展。空值处理auc_amount普遍为Nonerepo_amount/repay_amount偶发为空聚合统计前务必统一空值策略。交易日对齐返回数据仅含交易日若需与daily等行情数据按日期对齐建议先通过 交易日历 接口trade_cal获取交易日列表。单位换算slb_len全部金额字段单位为亿元而margin系列接口的金额单位为元见 融资融券交易汇总跨接口计算时务必统一量纲。勾稽校验可用期初余额承接上一交易日期末余额这一规律对历史数据做完整性校验发现跳变时优先核对是否跨节假日或存在竞价成交auc_amount非空。已停接口区分如需转融券或做市借券数据注意对应接口slb_sec、slb_len_mm已标注停止仅适合历史研究不应接入增量调度。综上slb_len是一个调用门槛低、口径清晰、历史完整的日频宏观资金面接口配合 Vibe-Trading 的 Tushare 技能体系与统一 token 配置可以快速纳入 Agent 的两融资金面分析管线。【免费下载链接】Vibe-TradingVibe-Trading: Your Personal Trading Agent项目地址: https://gitcode.com/GitHub_Trending/vi/Vibe-Trading创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考