Data & API
Everything on HoldingsHub is machine-accessible: a read-only JSON API (free tier: 100 requests/day), a downloadable entity mapping, a field-level data dictionary and a public changelog. Source: SEC EDGAR 13F public filings.
Coverage
9281 institutions · 68 13F quarters (2000-Q4 → 2026-Q3) · 27,557,796 position rows · 26,195 securities
JSON API v1
Free tier: 100 requests/day, no signup; Gold:
1,000/day; Diamond unlimited
(see plans). Over-quota requests
get HTTP 429 with an upgrade link. Responses carry
Cache-Control: max-age=3600 — cache accordingly.
| Endpoint | Description |
|---|---|
GET /api/v1/meta |
Coverage, last update, endpoint list |
GET /api/v1/funds |
All filers with latest-quarter aggregates |
GET /api/v1/funds/{slug} |
One filer: profile + available quarters |
GET /api/v1/funds/{slug}/holdings?quarter=2026-Q2 |
Position rows (quarter defaults to latest; limit≤5000, offset paging) |
GET /api/v1/stocks/{symbol} |
One security + top-25 holders in the latest quarter |
GET /api/v1/stats |
Market-wide quarterly aggregates (filers, value, new positions/exits, sector flows) — pairs with the statistics page |
Example:
curl "https://holdingshub.top/api/v1/funds/berkshire-hathaway/holdings?quarter=2026-Q2"
Errors are JSON: {"error": "...", "status": 404}.
For AI agents
The same data is packaged for machines: every response carries the
originating SEC EDGAR filing URL, one envelope
({data, meta, provenance, usage}) and schema.org markup.
Three ways in:
Developers
Self-service API keys, usage and billing. Call allowances come with the membership: register and create a key — Free 3,000/month, Gold 10,000/month, Diamond 30,000/month, $0.01 per extra call (capped).
MCP Server
Native Claude / Cursor / Codex tools: getFundHoldings, getStockHolders, compareFunds, getActiveShare, getHistoricalChanges, watch13FFiling.
/llms.txt
Machine-readable brief (full version, dataset.jsonld).
New endpoints:
| Endpoint | Description |
|---|---|
GET /api/v1/search?q= |
Resolve a fund name or ticker |
GET /api/v1/funds/{slug}/changes?from=&to= |
New / exit / add / reduce between quarters |
GET /api/v1/funds/{slug}/active-share |
Active Share vs S&P 500 / QQQ |
GET /api/v1/stocks/{symbol}/holders |
Every institution holding the ticker |
GET /api/v1/compare/funds?funds= |
Overlap across 2–4 portfolios |
GET /api/v1/13f/filings?since= |
Newly disclosed 13F-HR filings |
GET /api/v1/usage |
Quota, usage and estimated charges |
Cite this data (standard format)
When using HoldingsHub data in articles, papers or visualizations, credit us with one of these formats:
Plain text:
HoldingsHub (2026). 13F holdings data [Dataset]. https://holdingshub.top
HTML:
<a href="https://holdingshub.top">Data: HoldingsHub</a> (SEC 13F filings)
Every data page embeds schema.org Dataset structured data, so machine crawlers can pick up authorship, license and update time automatically.
Open data downloads
Entity Mapping
Symbol → company name, GICS sector for 26,195 securities; searchable online, full CSV download.
Data Dictionary
Field definitions, quarterly conventions, weight math and known limitations.
Changelog
New institutions per quarter, data fixes and methodology changes.