quantwise 1.2.0 → 1.2.2

package/.claude/skills/institutional-flow-tracker/references/13f_filings_guide.md

@@ -0,0 +1,383 @@
+# 13F Filings Comprehensive Guide
+
+## What is a 13F Filing?
+
+Form 13F is a quarterly report filed with the SEC by institutional investment managers with at least $100 million in assets under management (AUM). The form discloses their equity holdings as of the end of each calendar quarter.
+
+### Legal Requirements
+
+**Who Must File:**
+- Investment advisors
+- Banks
+- Insurance companies
+- Pension funds
+- Hedge funds
+- Other institutions managing >$100M in "13F securities"
+
+**What Must Be Reported:**
+- Long positions in US-listed equities
+- Convertible bonds
+- Exchange-traded options
+- Shares held as of quarter-end date
+
+**What is NOT Reported:**
+- Short positions
+- Non-US securities
+- Private equity investments
+- Fixed income (except convertibles)
+- Cash positions
+- Derivatives (except listed options)
+
+**Filing Deadline:**
+- Within 45 days after quarter end
+- Q1 (ended March 31): Due by May 15
+- Q2 (ended June 30): Due by August 14
+- Q3 (ended September 30): Due by November 14
+- Q4 (ended December 31): Due by February 14
+
+### Key Data Points in 13F Filings
+
+**For Each Holding:**
+1. **Issuer Name** - Company name
+2. **Ticker Symbol** - Stock ticker
+3. **CUSIP** - Unique security identifier
+4. **Shares Held** - Number of shares owned
+5. **Market Value** - Dollar value of position (shares × price at quarter end)
+6. **Investment Discretion** - Sole/Shared/None
+7. **Voting Authority** - Sole/Shared/None
+
+**Aggregate Data:**
+- Total number of holdings
+- Total portfolio value
+- Portfolio concentration
+- Sector allocation
+
+## Understanding the Data
+
+### Position Changes
+
+**Types of Changes:**
+1. **New Position** - Stock not held last quarter, now held
+2. **Increased Position** - More shares than last quarter
+3. **Decreased Position** - Fewer shares than last quarter
+4. **Closed Position** - Stock held last quarter, now zero
+
+**Calculating Changes:**
+```
+Shares Change = Current Quarter Shares - Previous Quarter Shares
+% Change = (Shares Change / Previous Quarter Shares) × 100
+Dollar Value Change = (Shares Change) × (Current Stock Price)
+```
+
+**Example:**
+```
+Previous Quarter: 1,000,000 shares of AAPL @ $150 = $150M
+Current Quarter:  1,200,000 shares of AAPL @ $180 = $216M
+
+Shares Change: +200,000 shares (+20%)
+Dollar Value Change: +$66M (includes price appreciation + new purchases)
+```
+
+### Aggregate Institutional Ownership
+
+**Portfolio-Level Metrics:**
+- **Total Institutional Ownership %** = (Total Shares Held by All Institutions / Shares Outstanding) × 100
+- **Number of Institutional Holders** = Count of unique institutions filing 13F with this stock
+- **Ownership Concentration** = % held by top 10 institutions
+- **Ownership Trend** = QoQ change in total institutional ownership %
+
+**Typical Ownership Ranges:**
+- **<20%** - Low institutional interest (micro/small caps, speculative stocks)
+- **20-40%** - Below average (growth stocks, recent IPOs)
+- **40-60%** - Average (most mid/large caps)
+- **60-80%** - Above average (blue chips, dividend aristocrats)
+- **>80%** - Very high (mature, stable companies)
+
+## Data Quality Considerations
+
+### Timing Lags
+
+**Reporting Lag:**
+- Position as of: Quarter-end date (e.g., March 31)
+- Filing deadline: 45 days later (e.g., May 15)
+- Data available: Mid-May onwards
+- **Total lag:** 6-7 weeks from position date
+
+**Real-World Impact:**
+- Stock may have moved significantly since quarter-end
+- Institutions may have already changed positions
+- Use 13F data as confirming indicator, not real-time signal
+
+### Confidential Treatment
+
+**Form 13F-NT (Notice of Confidential Treatment):**
+- Institutions can request delayed disclosure for certain positions
+- Typically granted for 1-2 quarters to prevent front-running
+- Common for large accumulations or activist positions
+
+**Red Flags:**
+- Sudden appearance of large positions (may have been confidential)
+- Large institutions with unusually low reported AUM (hidden positions)
+
+### Aggregation Issues
+
+**Double Counting:**
+- Same shares may be reported by multiple entities within same organization
+- Example: Vanguard Group + Vanguard Index Funds + Vanguard ETF Trust
+- Need to aggregate related entities for accurate institutional ownership
+
+**Custodial vs Beneficial Ownership:**
+- Some institutions hold shares as custodians (not beneficial owners)
+- Example: State Street as custodian for pension funds
+- Look for "voting authority" and "investment discretion" fields
+
+## Common Pitfalls and How to Avoid Them
+
+### Pitfall 1: Ignoring Price Changes
+
+**Problem:**
+- Institutional ownership % can decrease even if institutions hold same share count
+- Happens when: Stock price falls, institution's AUM falls below reporting threshold
+
+**Solution:**
+- Track both share count changes AND ownership % changes
+- Focus on share count for more accurate signal
+
+**Example:**
+```
+Q1: Institution holds 1M shares, stock at $100, ownership = 5%
+Q2: Institution holds 1M shares, stock at $50, ownership = 2.5%
+Interpretation: No actual selling, just price decline affecting percentage
+```
+
+### Pitfall 2: Interpreting Passive Index Funds
+
+**Problem:**
+- Index funds must buy/sell based on index composition, not fundamental views
+- Large inflows to index funds mechanically increase institutional ownership
+
+**Solution:**
+- Separate active managers from passive funds
+- Weight active manager changes more heavily
+- Track: ARK, Berkshire, Baupost > Vanguard Index Funds
+
+**Active vs Passive Indicators:**
+- Active: Concentrated portfolios (20-50 stocks), high conviction bets
+- Passive: Diversified portfolios (500+ stocks), matching index weights
+
+### Pitfall 3: Ignoring Institution Quality
+
+**Problem:**
+- Not all institutional investors are equal
+- 100 small funds buying ≠ Warren Buffett buying
+
+**Solution:**
+- Tier institutions by track record and strategy alignment
+- Weight Tier 1 (quality long-term investors) more heavily
+
+**Institutional Tiers:**
+- **Tier 1** (High conviction): Berkshire, Appaloosa, Baupost, Pershing Square
+- **Tier 2** (Quality active): Fidelity, T. Rowe Price, Wellington
+- **Tier 3** (Passive/momentum): Vanguard Index, State Street, momentum funds
+
+### Pitfall 4: Overreacting to Single Quarter Changes
+
+**Problem:**
+- One quarter of buying/selling may not indicate trend
+- Could be portfolio rebalancing, redemptions, or temporary factors
+
+**Solution:**
+- Look for multi-quarter trends (3+ quarters)
+- Higher conviction when sustained accumulation/distribution
+- One quarter = noise, three quarters = signal
+
+**Trend Quality:**
+```
+Strong Signal (3+ quarters same direction):
+Q1: +10% institutional ownership
+Q2: +8% institutional ownership
+Q3: +12% institutional ownership
+Interpretation: Sustained accumulation, high conviction
+
+Noise (inconsistent):
+Q1: +10% institutional ownership
+Q2: -5% institutional ownership
+Q3: +3% institutional ownership
+Interpretation: No clear trend, likely portfolio adjustments
+```
+
+## Advanced Analysis Techniques
+
+### Flow Analysis
+
+Track net shares added/removed across all institutions:
+
+```
+Net Institutional Flow = Sum(All Institutional Share Changes)
+Flow Ratio = (Shares Added by Buyers) / (Shares Sold by Sellers)
+
+Flow Ratio > 2.0 = Strong accumulation
+Flow Ratio 1.5-2.0 = Moderate accumulation
+Flow Ratio 0.8-1.2 = Neutral/Balanced
+Flow Ratio 0.5-0.8 = Moderate distribution
+Flow Ratio < 0.5 = Strong distribution
+```
+
+### Concentration Risk Analysis
+
+**Herfindahl-Hirschman Index (HHI):**
+```
+HHI = Sum of (Each Institution's Ownership %)²
+
+HHI < 1000 = Diversified ownership (low concentration risk)
+HHI 1000-1800 = Moderate concentration
+HHI > 1800 = High concentration (risk if top holder sells)
+```
+
+**Example:**
+```
+Top 3 holders: 15%, 12%, 10% of institutional ownership
+HHI = 15² + 12² + 10² = 225 + 144 + 100 = 469 (low concentration)
+
+Top 3 holders: 40%, 30%, 20% of institutional ownership
+HHI = 40² + 30² + 20² = 1600 + 900 + 400 = 2900 (high concentration)
+```
+
+### New Buyers vs Sellers Analysis
+
+**Quarterly Cohort Tracking:**
+```
+New Buyers = Institutions with zero shares last Q, non-zero this Q
+Increasers = Institutions with more shares this Q
+Decreasers = Institutions with fewer shares this Q
+Exited = Institutions with shares last Q, zero this Q
+
+Bull Signal: New Buyers > Exited AND Increasers > Decreasers
+Bear Signal: Exited > New Buyers AND Decreasers > Increasers
+```
+
+### Smart Money Clustering
+
+Identify when multiple quality investors accumulate simultaneously:
+
+**Clustering Score:**
+```
+Score = Sum of (Institution Tier × % Position Change)
+
+Tier 1 institutions: Weight = 3.0
+Tier 2 institutions: Weight = 2.0
+Tier 3 institutions: Weight = 1.0
+
+Example:
+Berkshire (Tier 1) +10% position = 3.0 × 10 = 30 points
+Fidelity (Tier 2) +5% position = 2.0 × 5 = 10 points
+Index Fund (Tier 3) +2% position = 1.0 × 2 = 2 points
+Total Clustering Score = 42
+
+Score > 50 = Strong smart money accumulation
+Score 25-50 = Moderate accumulation
+Score < 25 = Weak/no clustering
+```
+
+## Historical Success Patterns
+
+### Pre-Breakout Accumulation
+
+**Pattern:**
+- Stock trading sideways for 2-4 quarters
+- Institutional ownership quietly rising (10-20% increase)
+- Stock breaks out 1-2 quarters after accumulation visible in 13F
+
+**Example Stocks:**
+- NVDA (2019): Institutions accumulated before AI boom
+- TSLA (2019-2020): Steady institutional buying before 500% run
+
+### Early Distribution Warning
+
+**Pattern:**
+- Stock in uptrend
+- Institutional ownership declining for 2+ quarters
+- Top-tier institutions exiting
+- Stock peaks 1-2 quarters after distribution begins
+
+**Example Stocks:**
+- Dot-com stocks (1999-2000): Smart money exited before crash
+- Housing stocks (2006-2007): Institutional distribution before crisis
+
+## Integration with Fundamental Analysis
+
+**Bullish Confirmation:**
+- Strong fundamentals (revenue growth, margin expansion)
+- Rising institutional ownership
+- Quality investors adding positions
+- **Action:** High conviction buy
+
+**Bearish Warning:**
+- Strong fundamentals but declining institutional ownership
+- Quality investors exiting despite good numbers
+- **Action:** Investigate further, may be hidden risks
+
+**Value Opportunity:**
+- Weak short-term fundamentals
+- Stable/rising institutional ownership (value investors accumulating)
+- **Action:** Contrarian opportunity if fundamentals inflect
+
+**Avoid:**
+- Weak fundamentals
+- Declining institutional ownership
+- Quality investors exiting
+- **Action:** Stay away
+
+## Regulatory Changes and Updates
+
+**Current as of 2025:**
+- Reporting threshold: $100M AUM
+- Filing deadline: 45 days after quarter end
+- Amendment rules: Allowed within filing period
+
+**Proposed Changes (Monitor):**
+- Potential reduction in filing deadline to 30 days
+- Potential requirement to disclose short positions
+- Potential reduction in AUM threshold to $50M
+
+**Stay Updated:**
+- SEC website: https://www.sec.gov/rules
+- Industry news: Follow regulatory announcements
+
+## Tools and Resources
+
+**Official Sources:**
+- SEC EDGAR Database: https://www.sec.gov/edgar/searchedgar/companysearch.html
+- Form 13F instructions: https://www.sec.gov/pdf/form13f.pdf
+
+**Third-Party Aggregators:**
+- WhaleWisdom: https://whalewisdom.com (free tier available)
+- DataRoma: https://www.dataroma.com (tracks superinvestors)
+- Fintel: https://fintel.io (institutional ownership data)
+
+**API Access:**
+- FMP API: Institutional ownership endpoints
+- SEC API: Direct access to filings (free, rate-limited)
+
+## Summary: Using 13F Data Effectively
+
+**Best Practices:**
+1. ✅ Track multi-quarter trends, not single quarters
+2. ✅ Focus on share count changes, not just ownership %
+3. ✅ Weight quality institutions more heavily
+4. ✅ Combine with fundamental analysis
+5. ✅ Use as confirming indicator, not standalone signal
+6. ✅ Update quarterly after filing deadlines
+
+**What to Avoid:**
+1. ❌ Don't assume 13F = real-time positions
+2. ❌ Don't ignore passive fund flows
+3. ❌ Don't overweight single institution moves
+4. ❌ Don't use for short-term trading
+5. ❌ Don't ignore price changes when calculating ownership
+6. ❌ Don't forget about confidential treatment requests
+
+**Expected Returns:**
+- Academic studies show 13F-based strategies can generate 2-4% annual alpha
+- Best results when combined with momentum and value factors
+- Effectiveness highest in small/mid caps where information asymmetry is greater