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.

EndpointDescription
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:

EndpointDescription
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.