# HoldingsHub — complete API reference for AI agents Source: SEC EDGAR Form 13F-HR. Attribution: Data: HoldingsHub (https://holdingshub.top) — normalized from SEC EDGAR Form 13F-HR public filings Coverage: 9,251 filers · 68 quarters (2000-Q4 → 2026-Q3) · 27,532,135 position rows. Last updated: 2026-11-15 ## Response envelope Every 2xx response has this shape (legacy top-level keys are also re-emitted for pre-1.1 clients): ```json { "data": [ ... ], "meta": {"endpoint": "...", "schema_version": "1.1", "count": 100, "total": 412, "limit": 100, "offset": 0, "has_more": true, "units": 1, "query": {...}, "docs": "..."}, "provenance": {"source": "SEC EDGAR Form 13F-HR", "sec_edgar_url": "https://www.sec.gov/Archives/...", "cik": "0001067983", "accession_no": "0001193125-26-352200", "period": "2026-Q2", "report_date": "2026-06-30", "filed_at": "2026-08-14", "retrieved_at": "..."}, "usage": {"tier": "gold", "calls_today": 12, "quota_month": 10000, "used_month": 4312, "overage_calls": 0, "estimated_charges_usd": 9.9}, "attribution": "Data: HoldingsHub (https://holdingshub.top) — normalized from SEC EDGAR Form 13F-HR public filings" } ``` Errors: `{"error": {"message": ..., "code": 404}, "status": 404}`. 429 = quota exceeded (see `usage`), 402 = payment required (x402). ## Endpoints ### `GET /api/v1/meta` Coverage, freshness, endpoint index. ### `GET /api/v1/funds?q=&type=&limit=&offset=` Search filers by name/slug; returns latest-quarter aggregates. ### `GET /api/v1/funds/{slug}` Filer profile + every available quarter. ### `GET /api/v1/funds/{slug}/holdings?quarter=2026-Q2&limit=100&offset=0` Position rows for one quarter (default: latest). ### `GET /api/v1/funds/{slug}/changes?from=2025-Q4&to=2026-Q2` Quarter-over-quarter new / exit / add / reduce diff. ### `GET /api/v1/funds/{slug}/active-share?benchmark=sp-500` Active Share vs a benchmark, with top contributors. ### `GET /api/v1/stocks/{symbol}` Security profile + top holders. ### `GET /api/v1/stocks/{symbol}/holders?quarter=&limit=` Every institution holding a ticker in a quarter. ### `GET /api/v1/compare/funds?funds=slug1,slug2` Portfolio overlap / Jaccard / shared and exclusive positions. ### `GET /api/v1/13f/filings?since=2026-08-01&fund=&period=` Newly disclosed 13F filings feed (watch13FFiling). ### `GET /api/v1/stats` Market-wide quarterly aggregates. ### `GET /api/v1/usage` Your key's quota, usage and current charges. ### `POST /mcp` Model Context Protocol endpoint (tools/call). ## Field reference (holdings rows) | field | type | meaning | |---|---|---| | symbol | string | US ticker (primary key; CUSIP is not stored) | | company | string | Issuer name as filed | | sector | string | GICS sector (11 buckets, 'Miscellaneous' fallback) | | shares | number | Share count as reported (share classes merged) | | value_usd | number | Manager-reported market value, USD | | weight_pct | number | % of the filing's disclosed long book | | shares_prev | number|null | Prior-quarter shares (null = NEW) | | change_type | string | NEW / ADD / REDUCE / HOLD | ## Known limitations - 13F is long-US-equity only: no shorts, no derivatives, no cash. - Filings land up to 45 days after quarter end; a quarter is only complete ~2 months after it closes. - Reported values can aggregate sub-advisors; a disclosed book is not the manager's full strategy. - `weight_pct` is a share of the disclosed book, not of firm AUM. ## MCP POST https://holdingshub.top/mcp (Streamable HTTP, JSON-RPC 2.0). Also runs locally over stdio: `python mcp_server.py --stdio`. Tools: getFundHoldings, getStockHolders, compareFunds, getActiveShare, getHistoricalChanges, watch13FFiling, searchFunds, getFundProfile.