
Vibe-Trading 游资交易数据接入实战Tushare hm_detail 接口全解析与打板量化研究【免费下载链接】Vibe-TradingVibe-Trading: Your Personal Trading Agent项目地址: https://gitcode.com/GitHub_Trending/vi/Vibe-Trading游资hot money动向是 A 股短线打板研究中最核心的资金面情报之一。本文以 Vibe-Trading 仓库内 Tushare 技能文档 为主线完整拆解hm_detail游资交易每日明细接口的权限要求、输入输出参数、调用方式与循环取数策略并结合仓库中的 Tushare 加载器实现、环境变量配置 与数据路由技能给出可直接落地的游资资金行为量化研究方案。读完本文你将掌握用 Tushare 抓取单日全市场游资明细、按游资名称或个股回查历史仓位以及在 Vibe-Trading 中配置与复用该数据源的完整方法。一、接口概览游资交易每日明细hm_detailhm_detail是 Tushare 数据平台中“股票数据 打板专题数据”分类下的专用接口接口编号 312见 Tushare 技能总览 中的接口列表用于获取每日游资交易明细数据开始于 2022 年 8 月。它的核心价值在于把抽象的“龙虎榜营业部”数据进一步归因到“知名游资 / 市场席位”这一资金主体维度使研究者可以直接跟踪某一路资金如赵老哥、炒股养家、章盟主等在哪些股票上进出了多少资金。从接口设计看Tushare 提供了配套的游资名录接口hm_list市场游资最全名录见 市场游资最全名录文档二者构成“名录—明细”的完整数据链先用hm_list拿到游资名称与关联营业部再用hm_detail按游资名称或交易日拉取实际交易数据。这种双接口结构在仓库的 Tushare 技能中被完整保留适合构建“游资监控 → 行为画像 → 策略因子”的研究流水线。访问权限与积分要求项目说明接口名hm_detail数据起始2022 年 8 月单次限量最多提取 2000 条记录可循环调取总量不限制积分要求用户积分达到10000 分可调取使用需要注意的是10000 积分属于 Tushare 的高等级权限门槛远高于普通行情接口如daily通常 2000 分。这意味着实际调用该接口前需要先确认账号积分等级避免在量化任务编排中因权限不足而中断。仓库的 Tushare 加载器 对这类权限/频控异常有成熟的识别与退避处理机制详见下文“频控与容错”小节可直接复用其思路。二、输入参数详解hm_detail共提供 5 个输入参数全部为可选必选列均为 N可按需组合使用名称类型必选描述trade_datestrN交易日期YYYYMMDDts_codestrN股票代码hm_namestrN游资名称start_datestrN开始日期YYYYMMDDend_datestrN结束日期YYYYMMDD参数组合的核心逻辑trade_date单日全览只传交易日期可一次性获取该日全市场游资买卖明细适合每日盘后快照式扫描ts_code个股反查指定股票代码可查看某只个股当日或区间内被哪些游资参与hm_name游资跟踪指定游资名称需与hm_list名录中的名称一致可跟踪该路资金的历史交易轨迹start_dateend_date区间拉取与ts_code、hm_name搭配可限定时间窗口配合 2000 条/次的分页循环完成历史数据全量回填。日期格式统一为YYYYMMDD如20230815与仓库 SKILL.md 参数格式约定 一致。股票代码采用ts_code格式如000001.SZ、600000.SH。三、输出参数详解hm_detail返回 8 个字段覆盖了交易主体、标的、金额三个维度名称类型默认显示描述trade_datestrY交易日期ts_codestrY股票代码ts_namestrY股票名称buy_amountfloatY买入金额元sell_amountfloatY卖出金额元net_amountfloatY净买卖元hm_namestrY游资名称hm_orgsstrY关联机构一般为营业部或机构专用tagstrN标签字段解读与量化用途金额三件套buy_amount/sell_amount/net_amount单位均为元构成该路游资对某标的的单日资金净流向可直接用于计算“净买入强度”“买卖比”等资金行为因子关联机构hm_orgs给出该游资实际使用的营业部席位如“华泰证券股份有限公司南京六合雄州西路证券营业部”可与hm_list名录中的orgs字段交叉校验判断资金是否更换席位或出现多席位联动标签tag为可选字段可用于区分资金属性如机构专用、深股通专用等特殊席位标签在过滤“真假游资”时非常有用。文档特别提示数据为当日部分数据此处仅作为示例效果即返回结果可能并非该日全量成交研究中应把接口返回视为官方披露口径的子集避免把“无记录”误判为“未参与”。四、接口调用示例与循环取数基础调用文档给出的标准调用方式如下import tushare as ts pro ts.pro_api() # 获取单日全部明细 df pro.hm_detail(trade_date20230815) print(df.head())返回为 pandas DataFrame含上述 8 个字段。结合仓库 SKILL.md 快速上手 的规范写法推荐显式传入 tokenimport os import tushare as ts token os.getenv(TUSHARE_TOKEN) or ts.get_token() pro ts.pro_api(token) # 获取单日全部明细 df pro.hm_detail(trade_date20230815)在 Vibe-Trading 仓库内token 的推荐来源是环境变量TUSHARE_TOKEN其读取逻辑定义在 env_schema.pycfg.data.tushare_token可直接用ts.pro_api(token)初始化后调用任意 Tushare 接口。按游资名称跟踪# 跟踪某一路游资的历史交易名称需与 hm_list 名录一致 df pro.hm_detail(hm_name赵老哥, start_date20230801, end_date20230831) print(df[[trade_date, ts_code, ts_name, buy_amount, sell_amount, net_amount]])按个股反查资金参与# 查看某只个股被哪些游资参与 df pro.hm_detail(ts_code000001.SZ, start_date20230801, end_date20230831) print(df.groupby(hm_name)[net_amount].sum().sort_values(ascendingFalse))循环取数全量回填由于单次上限为 2000 条历史全量数据需按日期分页循环。推荐按交易日逐日拉取既可规避单次超限也便于断点续传与增量更新import time trade_dates [20230801, 20230802, 20230803] # 可用 trade_cal 接口生成完整交易日列表 all_data [] for d in trade_dates: page pro.hm_detail(trade_dated) all_data.append(page) time.sleep(0.5) # 尊重接口频控避免触发限流 import pandas as pd full pd.concat(all_data, ignore_indexTrue)五、在 Vibe-Trading 中的落地配置、路由与容错环境变量配置仓库通过env_schema.py以TUSHARE_TOKEN别名注册 token 配置项DataLoader.is_available()见 tushare.py会读取该配置并判定数据源是否可用。实际使用前只需export TUSHARE_TOKENyour_token数据源路由根据 contenteditable="false">【免费下载链接】Vibe-TradingVibe-Trading: Your Personal Trading Agent项目地址: https://gitcode.com/GitHub_Trending/vi/Vibe-Trading创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考