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.
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
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
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
Diamond
$19.90 / mo
30,000 API calls / month
- 30,000 API calls/month (REST + MCP)
- Everything in Gold
- CSV downloads of every table
- 13F filing webhooks
- Priority support
| 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
Endpoints
| Endpoint | What it returns |
|---|---|
/api/v1/meta | Coverage, 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-share | Active Share vs S&P 500 / QQQ. |
/api/v1/stocks/{symbol}/holders | Everyone 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/usage | Your 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
| Tool | What it does |
|---|---|
getFundHoldings | One filer's disclosed book for a quarter. |
getStockHolders | Institutions holding a ticker. |
compareFunds | Overlap / divergence across 2–4 funds. |
getActiveShare | Active Share vs S&P 500 or QQQ. |
getHistoricalChanges | Quarter-over-quarter buys and sells. |
watch13FFiling | New 13F filings as they hit EDGAR. |
searchFunds | Resolve names and tickers to slugs. |
getFundProfile | Filer 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
- 13F covers long US-listed equity only — no shorts, no derivatives, no non-US listings.
-
Filings land up to 45 days after quarter end, so a quarter is complete
~2 months later;
filers_in_periodandperiod_completetell you where you are. -
weight_pctis a share of the disclosed long book, not of firm AUM. -
Sourced from public SEC EDGAR filings and cleared for commercial use —
please keep the
provenance.sec_edgar_urlcitation.
See the data dictionary, the full API reference and the changelog.