Developers — AI Data API

Plug HoldingsHub 13F holdings data into your agent, research stack or product. Every response carries the originating SEC EDGAR filing URL, so answers are auditable. Free tier needs no signup; paid tiers meter per call.

9251 institutions · 68 13F quarters (2000-Q4 → 2026-Q3) · 27,532,135 position rows · updated 2026-11-15

Three ways to connect

REST JSON API

Read-only /api/v1/* — plain GET + JSON, works from any language or RAG pipeline.

MCP Server

Native tool calling in Claude / Cursor / Codex: POST https://holdingshub.top/mcp or local stdio.

llms.txt

/llms.txt · /llms-full.txt · dataset.jsonld — the machine-readable brief for crawlers and agents.

Pricing

API and MCP calls are included in your membership — there is no separate API contract. Your keys follow your account tier (Free) automatically, so upgrading the membership upgrades every key you own.
You

Free

$0 / mo

3,000 API calls / month

  • 3,000 API calls/month after signup (API key required)
  • Full quarter history
  • REST + MCP read access
Sign up free

Gold

$9.90 / mo

10,000 API calls / month

  • 10,000 API calls/month (REST + MCP)
  • Everything in Free
  • Full holdings pages & holder lists
  • Unlimited compare, screener & backtests
Tier Calls / month Overage Overage cap
Free 3,000 stops at allowance —
Gold 10,000 $0.01/call $30/mo
Diamond 30,000 $0.01/call $100/mo

Every call needs an API key — register, then create one on this page; without a key the API answers 401. Free members get 3,000 calls/month; paid tiers keep serving past the allowance and bill at $0.01 per call — every key carries a monthly overage cap that stops the meter (HTTP 402) rather than running up an open-ended bill.

API keys

Log in to create a key

Endpoints

EndpointWhat it returns
/api/v1/metaCoverage, pricing, endpoint index.
/api/v1/search?q=Resolve a fund name or ticker.
/api/v1/funds/{slug}Filer profile + quarter history.
/api/v1/funds/{slug}/holdings?quarter=Full position list.
/api/v1/funds/{slug}/changes?from=&to=New / exit / add / reduce diff.
/api/v1/funds/{slug}/active-shareActive Share vs S&P 500 / QQQ.
/api/v1/stocks/{symbol}/holdersEveryone holding a ticker.
/api/v1/compare/funds?funds=Overlap between 2–4 portfolios.
/api/v1/13f/filings?since=New 13F-HR disclosures feed.
/api/v1/usageYour quota, usage and charges.

One response shape everywhere: {data, meta, provenance, usage, attribution}. Errors are {"error": {...}, "status": 4xx}; 429 = over quota, 402 = payment required.

MCP

ToolWhat it does
getFundHoldingsOne filer's disclosed book for a quarter.
getStockHoldersInstitutions holding a ticker.
compareFundsOverlap / divergence across 2–4 funds.
getActiveShareActive Share vs S&P 500 or QQQ.
getHistoricalChangesQuarter-over-quarter buys and sells.
watch13FFilingNew 13F filings as they hit EDGAR.
searchFundsResolve names and tickers to slugs.
getFundProfileFiler identity, CIK, covered quarters.

Remote (Claude / Cursor):

{
  "mcpServers": {
    "holdingshub": {
      "type": "http",
      "url": "https://holdingshub.top/mcp"
    }
  }
}

Local stdio (data never leaves your machine):

{
  "mcpServers": {
    "holdingshub": {
      "command": "python",
      "args": ["/path/to/usstocktools/mcp_server.py", "--stdio"]
    }
  }
}

Data boundaries

See the data dictionary, the full API reference and the changelog.