# 机构流量追踪器 ## 概述该技能通过 13F SEC 文件跟踪机构投资者活动，以识别流入和流出股票的“聪明资金”。通过分析机构持股的季度变化，您可以发现经验丰富的投资者在价格大幅波动之前增持的股票，或者识别机构减仓时的潜在风险。 **关键见解：** 机构投资者（对冲基金、养老基金、共同基金）管理着数万亿美元并进行广泛的研究。他们的集体买/卖模式通常先于价格大幅波动 1-3 个季度。 ## 先决条件 * **FMP API 密钥：** 设置 `FMP_API_KEY` 环境变量或将 `--api-key` 传递给脚本 * **Python 3.8+：** 运行分析脚本所需 * **依赖项：** `pip install requests` （脚本优雅地处理缺少的依赖项） ## 何时使用此技能在以下情况下使用此技能： *验证投资想法（检查聪明的钱是否同意你的论点） * 发现新机会（找股机构正在积累） * 风险评估（识别股票机构正在退出） * 投资组合监控（跟踪机构对您所持资产的支持） * 追踪特定投资者（追踪沃伦·巴菲特、凯西·伍德等） * 行业轮换分析（确定机构在哪些地方进行资本轮换） **请勿在以下情况下使用：** * 寻求实时盘中信号（13F数据有45天的报告滞后） * 分析微型股票（市值<1亿美元，机构兴趣有限） * 寻找短期交易信号（<3个月范围） ## 数据来源和要求 ### 必需：FMP API 密钥此技能使用 Financial Modeling Prep (FMP) API 访问 13F 归档数据： **设置：** # 设置环境变量（首选）导出 FMP_API_KEY=your_key_here # 或者在运行脚本时提供 python3 脚本/track_institutional_flow.py --api-key YOUR_KEY **API 层要求：** * **免费套餐：** 250 个请求/天（足以每季度分析 20-30 只股票） * **付费等级：** 广泛筛查的更高限制 **13F 归档时间表：** * 每季度提交一次，在季度结束后 45 天内提交 * Q1（一月至三月）：五月中旬之前提交 * 第二季度（4 月至 6 月）：8 月中旬提交 * 第三季度（7 月至 9 月）：11 月中旬提交 * 第四季度（10 月至 12 月）：2 月中旬提交 ## 分析工作流程 ### 第 1 步：识别发生重大制度变化的股票执行主筛选脚本以查找具有显着机构活动的股票： **快速扫描（按机构变化排名前 50 名股票）：** python3 脚本/track_institutional_flow.py \ --前50名\ --最小变化百分比 10 **扇区聚焦扫描：** python3 脚本/track_institutional_flow.py \ --部门技术\ --最少机构 20 **定制筛选：** python3 脚本/track_institutional_flow.py \ --最小市值 2000000000 \ --最小变化百分比 15 \ --前100名\ --输出机构_流程_结果.json **输出包括：** * 股票代码和公司名称 * 当前机构持股百分比（已发行股票） * 持股环比变化 * 持有机构数量 * 机构数量变化（新买家与卖家） * 顶级机构持有者 ### 第 2 步：深入研究特定股票对于特定股票的机构所有权的详细分析： python3 脚本/analyze_single_stock.py AAPL **这会生成：** *历史机构持股趋势（8个季度） * 所有持仓变动的机构持有人名单 * 集中度分析（前10名持有人占机构总持股比例） * 新持仓 vs 持仓增加 vs 持仓减少 * 数据质量评估与可靠性等级 **评估的关键指标：** * **所有权百分比：** 较高的机构所有权 (>70%) = 更高的稳定性，但上行空间有限 * **所有权趋势：** 所有权上升=看涨，所有权下降=看跌 * **集中度：** 高集中度（前 10 名 > 50%）= 如果出售则存在风险 * **持有人的质量：** 优质长期投资者（伯克希尔、富达）与动量基金的存在 ### 第三步：追踪特定机构投资者 > **注意：** `track_institution_portfolio.py` **尚未实现**。 FMP API 按股票（而不是按机构）组织机构持有人数据，仅通过此 API 无法实现完整的投资组合重建。 **替代方法 - 使用`analyze_single_stock.py`检查特定机构是否持有股票：** # 分析股票并在输出中查找特定机构 python3 机构流量跟踪器/scripts/analyze_single_stock.py AAPL # 然后在报告中搜索前 20 名持有者表中的“Berkshire”或“ARK” **要进行完整的机构级投资组合跟踪，请使用以下外部资源：** 1. **WhaleWisdom：** （免费层可用，13F投资组合查看器） 2. **SEC EDGAR：** （13F 官方文件） 3. **DataRoma：** （超级投资者投资组合跟踪器） ### 步骤 4：解释和行动阅读解释指南的参考资料： * `references/13f_filings_guide.md` \- 了解 13F 数据和限制 * `references/institutional_investor_types.md` \- 不同的投资者类型及其策略 * `references/terpretation_framework.md` \- 如何解读机构流量信号 **信号强度框架：** **强烈看涨（考虑购买）：** * 机构持股量环比增长 >15% * 机构数量增加>10% * 优质长期投资者加仓 * 目前所有权较低（<40%），有增长空间 * 多个季度的积累 **适度看涨：** * 机构持股量环比增长 5-15% * 新买家和卖家的混合，净积极 * 目前持股40-70% **中性：** * 所有权变化最小 (<5%) * 买家和卖家数量相似 * 稳定的制度基础 **适度看跌：** * 机构持股量环比下降 5-15% * 卖家多于买家 * 高所有权（>80%）限制新买家 **强烈看跌（考虑卖出/避免）：** * 机构持股量环比下降 >15% * 机构数量减少>10% * 优质投资者退出头寸 * 分布发生在多个季度 * 集中风险（顶级持有者抛售大量头寸） ### 第 5 步：作品集申请 **对于新职位：** 1. 对你的股票想法进行机构分析 2.寻找确认（机构也在累积） 3. 如果出现强烈的看跌信号，请重新考虑或减少头寸规模 4. 如果出现强烈的看涨信号，请对论文充满信心 **对于现有资产：** 1. 13F提交截止日期后的季度审核 2. 监控分发（预警系统） 3.如果机构正在退出，重新评估你的论文 4. 如果机构抛售广泛，则考虑削减 **筛选工作流程集成：** 1. 使用价值股息筛选器或其他筛选器寻找候选人 2. 对最佳候选人运行机构流程跟踪器 3、优先选择机构积累的股票 4、避开机构配股的股票 ## 输出格式所有分析都会生成保存到存储库根目录的结构化 Markdown 报告： **文件名约定：** `institutional_flow_analysis__.md` **报告部分：** 1. 执行摘要（主要发现） 2. 机构持股趋势（当前与历史） 3. 最高持有者和变化 4. 新买家与卖家 5. 浓度分析六、解释与建议 7. 数据源和时间戳 ## 数据可靠性等级所有分析现在都包括基于数据质量的**可靠性等级**： * **A级：** 覆盖率< 3x，匹配率>= 50%，正版持有者比例>= 70%。投资决策安全。 * **B级：** 正品持有比例>= 30%。仅供参考-谨慎使用。 * **C级：** 正品持有比例< 30%。不可靠 - 排除在筛选结果之外。筛选脚本（`track_institutional_flow.py`）自动排除 C 级股票。个股分析（`analyze_single_stock.py`）显示带有适当警告的等级。 **为什么这很重要：** FMP 每季度返回不同数量的持有者。一只股票在第四季度可能有 5,415 名持有人，但在第三季度只有 201 名。如果不进行过滤，聚合指标会产生误导性的百分比变化（例如，+400%）。数据质量模块过滤“真实”持有者（存在于两个季度）以产生可靠的指标。 ## 限制和注意事项 **数据滞后：** * 13F 申请有 45 天的报告延迟 * 自提交日期以来，职位可能已发生变化 * 用作确认指标，而非引导信号 **覆盖范围：** * 只有管理金额超过 1 亿美元的机构才需要提交文件 * 不包括个人投资者和小型基金 * 国际机构不得提交13F **报告规则：** * 仅报告多头股票头寸（无空头、期权、债券） * 截至季度末快照的持股量 * 某些职位可能是保密的（延迟报告） **释义：** * 相关性≠因果关系（尽管有机构买入，股票仍可能下跌） * 考虑整体市场环境和基本面 * 结合技术分析和其他技能 ## 高级用例 **内部人士+机构组合：** * 寻找内部人士和机构都在买入的股票 * 对准时信号特别强大 **扇区轮换检测：** * 按部门追踪机构总流量 * 在价格出现之前识别早期轮换趋势 **逆向玩法：** * 寻找机构正在出售的优质股票（潜在价值） * 需要坚定的基本信念 **智能货币验证：** * 在主要建仓之前，检查聪明资金是否同意 * 获得信心或发现被忽视的风险 ## 参考文献 `references/` 文件夹包含详细指南： * **13f_filings_guide.md** \- 13F SEC 备案的综合指南、内容、报告要求和数据质量注意事项 * **institutional_investor_types.md** \- 不同类型的机构投资者（对冲基金、共同基金、养老基金等）、他们的典型策略以及如何解释他们的举动 * **terpretation_framework.md** \- 用于解释机构所有权变更、信号质量评估以及与其他分析集成的详细框架 ## 脚本参数 ### track_institutional_flow.py 用于寻找具有重大机构变化的股票的主要筛选脚本。 **必填：** * `--api-key`: FMP API 密钥（或设置 FMP_API_KEY 环境变量） **可选：** * `--top N`: 按机构变化返回前 N 个股票（默认：50） * `--min-change-percent X`：机构所有权的最小变化百分比（默认值：10） * `--min-market-cap X`：以美元为单位的最小市值（默认值：1B） * `--sector NAME`: 按特定扇区过滤 * `--min-institutions N`：机构持有者的最小数量（默认：10） * `--limit N`：从筛选器中获取的股票数量（默认值：100）。较低的值可以节省 API 调用。 * `--output FILE`: 输出JSON文件路径 * `--output-dir DIR`：报告的输出目录（默认：reports/） * `--sort-by FIELD`: 按 'ownership_change' 或 'institution_count_change' 排序 ###analyze_single_stock.py 对特定股票的机构所有权进行深入分析。 **必填：** * 股票代码（位置参数） * `--api-key`: FMP API 密钥（或设置 FMP_API_KEY 环境变量） **可选：** * `--quarters N`：要分析的季度数（默认值：8，即 2 年） * `--output FILE`: 输出markdown报告路径 * `--output-dir DIR`：报告的输出目录（默认：reports/） * `--compare-to TICKER`：将机构所有权与另一只股票进行比较（未来功能） ### track_institution_portfolio.py **状态：尚未实施** 该脚本是一个占位符。它打印替代资源（WhaleWisdom、SEC EDGAR、DataRoma）并退出并显示错误代码 1。FMP API 按股票（而不是按机构）组织机构持有人数据，使得完整的投资组合重建不切实际。对于特定于机构的投资组合跟踪，请使用： 1. WhaleWisdom：（提供免费套餐） 2. SEC EDGAR： 3.DataRoma： ### 数据质量模块 (data_quality.py) `track_institutional_flow.py` 和 `analyze_single_stock.py` 使用的共享实用程序模块： * **classify_holder():** 将持有者分类为正版/new_full/已退出/未知 * **calculate_filtered_metrics():** 仅使用真实持有者计算指标 * **reliability_grade():** 根据数据质量分配 A/B/C 等级 * **is_tradable_stock():** 过滤掉 ETF、基金和非活跃股票 * **deduplicate_share_classes():** 删除 BRK-A/B、GOOG/GOOGL 重复项 ## 与其他技能的整合 **价值股息筛选+机构流程：** 1. 运行价值股息筛选器来寻找候选人 2. 对于每个候选人，检查机构流程 3. 优先考虑机构持股比例上升的股票 **美股分析+机构流向：** 1. 进行全面的基本面分析 2. 验证机构所有权趋势 3. 如果机构正在出售，请调查原因 **投资组合经理+机构流程：** 1.通过Alpaca获取当前投资组合 2. 对每个持仓进行机构分析 3. 机构支持不断恶化的标志立场 4.考虑重新平衡分配 **技术分析师+机构流程：** 1. 确定技术设置（例如突破） 2. 检查机构买入是否确认 3. 如果两者一致，就会有更高的信念 ## 最佳实践 1. **季度审核：** 设置 13F 提交截止日期的日历提醒 2. **多季度趋势：** 寻找持续趋势（3个以上季度），而不是一次性变化 3. **质量重于数量：**伯克希尔添加> 100只小型基金 4. **背景很重要：** 下跌股票的所有权增加可能是价值投资者抓住下跌的刀 5. **组合信号：** 切勿孤立地使用机构流动 6. **更新您的数据：** 每个季度在提交新的 13F 后重新运行分析 ## 支持和资源 * FMP API 文档： * SEC 13F 文件数据库：[https://www.sec.gov/cgi-bin/browse-edgar?action=getcompany&type=13F]() * 机构投资者数据库：（提供免费套餐） ** ** **注意：** 该技能是为长期投资者（3-12 个月范围）设计的。对于短线交易，结合技术分析和其他动量指标。

机构流程追踪器

包含技能