# HoldingsHub > US institutional 13F holdings & index constituents. Quarterly US institutional holdings (Form 13F-HR), normalized and queryable via a free JSON API and an MCP server. Data source: SEC EDGAR Form 13F-HR (https://www.sec.gov/forms/form13f). Public data, free with attribution; commercial use allowed. Coverage: 9,251 institutions · 68 quarters (2000-Q4 → 2026-Q3) · 27,532,135 position rows · 26,195 securities. Last updated: 2026-11-15 ## Preferred access for AI agents - MCP server (streamable HTTP): POST https://holdingshub.top/mcp — tools: getFundHoldings, getStockHolders, compareFunds, getActiveShare, getHistoricalChanges, watch13FFiling, searchFunds - Machine-readable API docs: https://holdingshub.top/llms-full.txt - JSON-LD dataset record: https://holdingshub.top/data/dataset.jsonld ## REST API v1 (API key required) - 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). ## Conventions - `period` is `YYYY-Qn` (e.g. 2026-Q2 = positions as of 2026-06-30). - Money is USD as reported by the manager; `weight_pct` is the share of the disclosed long book, NOT of AUM. - `change_type` is NEW / ADD / REDUCE / HOLD vs the fund's previous filing. - 13F excludes shorts, most derivatives and non-US listings. - Every response carries a `provenance.sec_edgar_url` — cite it. ## Pricing API + MCP access is included in the HoldingsHub membership and needs an API key: register, then create one at /developers/ — calls without a key return 401. Free includes 3,000 req/month (stops at the allowance); Gold $9.9/mo includes 10,000 req/month; Diamond $19.9/mo includes 30,000 req/month. Overage $0.01/call up to a monthly cap ($30 Gold / $100 Diamond) that stops the meter with HTTP 402. One API key bills at its owner's membership tier. See /pricing/ and /developers/. ## Optional - Entity mapping CSV: https://holdingshub.top/data/entity-mapping.csv - Data dictionary: https://holdingshub.top/data/dictionary/ - Changelog: https://holdingshub.top/changelog/