Institutional Flow Tracker

# Institutional Flow Tracker

## 概述

此技能通过 13F SEC 文件追踪机构投资者活动，以识别进出股票的“聪明钱”流向。通过分析机构持股的季度变化，您可以在重大价格变动之前发现成熟投资者正在积累的股票，或者在机构减少持仓时识别潜在风险。

**核心洞察：** 机构投资者（对冲基金、养老基金、共同基金）管理着数万亿美元资产并进行广泛研究。它们的集体买卖/卖出模式通常先于重大价格走势 1-3 个季度出现。

## 何时使用此技能

在以下情况下使用此技能： - 验证投资思路（检查聪明钱是否认同您的论点） - 发现新机会（寻找机构正在积累的股票） - 风险评估（识别机构正在退出的股票） - 投资组合监控（追踪您持仓的机构支持情况） - 关注特定投资者（追踪沃伦·巴菲特、凯茜·伍德等） - 板块轮动分析（识别机构资金正在转向哪里）

**请勿在以下情况使用：** - 寻找实时日内信号（13F 数据有 45 天的报告滞后） - 分析微型股股票（市值 < 1 亿美元，机构关注度有限） - 寻找短期交易信号（时间跨度 < 3 个月）

## 数据来源与要求

### 必需：FMP API 密钥

此技能使用 Financial Modeling Prep (FMP) API 访问 13F 文件数据：

**设置：** ```bash # Set environment variable (preferred) export FMP_API_KEY=your_key_here

# Or provide when running scripts python3 scripts/track_institutional_flow.py --api-key YOUR_KEY ```

**API 层级要求：** - **免费层级：** 每天 250 次请求（足以每季度分析 20-30 只股票） - **付费层级：** 限制更高，适用于广泛筛选

**13F 文件时间表：** - 每季度在季度结束后 45 天内提交 - Q1（1 月-3 月）：5 月中旬前提交 - Q2（4 月-6 月）：8 月中旬前提交 - Q3（7 月-9 月）：11 月中旬前提交 - Q4（10 月-12 月）：2 月中旬前提交

## 分析工作流

### 步骤 1：识别机构持仓发生重大变化的股票

执行主要筛选脚本以查找具有显著机构活动的股票：

**快速扫描（按机构变化前 50 名）：** ```bash python3 institutional-flow-tracker/scripts/track_institutional_flow.py \ --top 50 \ --min-change-percent 10 ```

**聚焦板块的扫描：** ```bash python3 institutional-flow-tracker/scripts/track_institutional_flow.py \ --sector Technology \ --min-institutions 20 ```

**自定义筛选：** ```bash python3 institutional-flow-tracker/scripts/track_institutional_flow.py \ --min-market-cap 2000000000 \ --min-change-percent 15 \ --top 100 \ --output institutional_flow_results.json ```

**输出包括：** - 股票代码和公司名称 - 当前机构持股百分比（占流通股的比例） - 持股数量的季度环比变化 - 持有机构数量 - 持有机构数量的变化（新买家 vs 卖家） - 主要机构持有者 - 美元价值总变化

### 步骤 2：深度分析特定股票

对特定股票的机构持股进行详细分析：

```bash python3 institutional-flow-tracker/scripts/analyze_single_stock.py AAPL ```

**这将生成：** - 历史机构持股趋势（8 个季度） - 列出所有有持仓变动的机构持有者 - 集中度分析（前 10 大持有者占机构总持股的百分比） - 新建仓位 vs 增持 vs 减持 vs 清仓 - 季度资金流向图（净增减股数） - 与板块平均机构持股的比较

**需评估的关键指标：** - **持股比例：** 较高的机构持股（>70%）= 稳定性更高但上行空间有限 - **持股趋势：** 持股增加 = 看涨，减少 = 看跌 - **集中度：** 高集中度（前 10 名 > 50%）= 如果他们卖出则有风险 - **持有者质量：** 优质长期投资者（伯克希尔、富达）的存在 vs 动量基金

### 步骤 3：追踪特定机构投资者

关注特定对冲基金或投资公司的投资组合动向：

```bash # Track Warren Buffett's Berkshire Hathaway python3 institutional-flow-tracker/scripts/track_institution_portfolio.py \ --cik 0001067983 \ --name "Berkshire Hathaway"

# Track Cathie Wood's ARK Investment Management python3 institutional-flow-tracker/scripts/track_institution_portfolio.py \ --cik 0001579982 \ --name "ARK Investment Management" ```

**CIK（中央索引键）查询：** - 搜索地址：https://www.sec.gov/cgi-bin/browse-edgar - 或使用 FMP API 机构搜索

**分析输出：** - 当前投资组合持仓（前 50 大持仓） - 本季度新建仓位 - 完全卖出的仓位 - 现有仓位的最大增减 - 投资组合集中度和板块配置变化 - 其首选股的历史表现

### 步骤 4：解读与行动

阅读参考资料以获取解读指导： - `references/13f_filings_guide.md` - 了解 13F 数据及其局限性 - `references/institutional_investor_types.md` - 不同的投资者类型及其策略 - `references/interpretation_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_<TICKER/THEME>_<DATE>.md`

**报告部分：** 1. 执行摘要（主要发现） 2. 机构持股趋势（当前 vs 历史） 3. 主要持有者及变化 4. 新买家 vs 卖家 5. 集中度分析 6. 解读与建议 7. 数据来源和时间戳

## 局限性与注意事项

**数据滞后：** - 13F 文件有 45 天的报告延迟 - 自文件提交日期以来，持仓可能已发生变化 - 用作确认指标，而非领先信号

**覆盖范围：** - 仅管理 >1 亿美元的机构被要求提交文件 - 不包括个人投资者和小型基金 - 国际机构可能不会提交 13F

**报告规则：** - 仅报告多头股票仓位（不包括空头、期权、债券） - 持仓数据为季度末快照 - 部分仓位可能属于机密（延迟报告）

**解读：** - 相关性 ≠ 因果关系（尽管机构买入，股票仍可能下跌） - 考虑整体市场环境和基本面 - 结合技术分析和其他技能

## 高级用例

**内部人士 + 机构组合：** - 寻找内部人士和机构都在买入的股票 - 当两者一致时，信号特别强大

**板块轮动检测：** - 按板块追踪机构总资金流向 - 在价格变动之前识别早期轮动趋势

**逆向博弈：** - 寻找机构正在卖出优质股票（潜在价值） - 需要强大的基本面信心

**聪明钱验证：** - 在建立主要仓位之前，检查聪明钱是否认同 - 增强信心或发现被忽视的风险

## 参考资料

`references/` 文件夹包含详细指南：

- **13f_filings_guide.md** - 13F SEC 文件综合指南，包括其内容、报告要求和数据质量考虑因素 - **institutional_investor_types.md** - 不同类型的机构投资者（对冲基金、共同基金、养老基金等），它们的典型策略以及如何解读其动向 - **interpretation_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） - `--output FILE`：输出 JSON 文件路径（默认：institutional_flow_results.json） - `--sort-by FIELD`：按 'ownership_change'、'institution_count_change'、'dollar_value_change' 排序

### analyze_single_stock.py

对特定股票的机构持股进行深度分析。

**必需：** - 股票代码（位置参数） - `--api-key`：FMP API 密钥（或设置 FMP_API_KEY 环境变量）

**可选：** - `--quarters N`：要分析的季度数（默认：8，即 2 年） - `--output FILE`：输出 Markdown 报告路径 - `--compare-to TICKER`：将机构持股与另一只股票进行比较

### track_institution_portfolio.py

追踪特定机构投资者的投资组合变化。

**必需：** - `--cik CIK`：机构的中央索引键 (CIK) - `--name NAME`：机构名称，用于报告 - `--api-key`：FMP API 密钥（或设置 FMP_API_KEY 环境变量）

**可选：** - `--top N`：显示前 N 大持仓（默认：50） - `--min-position-value X`：包含的最低持仓价值（默认：10M） - `--output FILE`：输出 Markdown 报告路径

## 与其他技能集成

**股息红利筛选器 + 机构资金流：** ``` 1. Run Value Dividend Screener to find candidates 2. For each candidate, check institutional flow 3. Prioritize stocks with rising institutional ownership ```

**美股分析 + 机构资金流：** ``` 1. Run comprehensive fundamental analysis 2. Validate with institutional ownership trends 3. If institutions are selling, investigate why ```

**投资组合管理器 + 机构资金流：** ``` 1. Fetch current portfolio via Alpaca 2. Run institutional analysis on each holding 3. Flag positions with deteriorating institutional support 4. Consider rebalancing away from distribution ```

**技术分析师 + 机构资金流：** ``` 1. Identify technical setup (e.g., breakout) 2. Check if institutional buying confirms 3. Higher conviction if both align ```

## 最佳实践

1. **季度复盘：** 为 13F 文件提交截止日期设置日历提醒 2. **多季度趋势：** 关注持续趋势（3 个季度以上），而非一次性变化 3. **重质不重量：** 巴菲特的加仓 > 100 家小基金的加仓 4. **情境很重要：** 股价下跌时持股增加可能是价值投资者在“接飞刀” 5. **结合信号：** 绝不要孤立地使用机构资金流数据 6. **更新数据：** 随着新的 13F 文件提交，每季度重新运行分析

## 支持与资源

- FMP API 文档：https://financialmodelingprep.com/developer/docs - SEC 13F 文件数据库：https://www.sec.gov/cgi-bin/browse-edgar?action=getcompany&type=13F - 机构投资者数据库：https://whalewisdom.com（提供免费层级）

---

**注意：** 此技能专为长期投资者（3-12 个月周期）设计。对于短期交易，请结合技术分析和其他动量指标使用。