开发者 · AI 数据 API
把 HoldingsHub 的 13F 持仓数据接进你的 Agent、研究流程或产品。每个响应都带 SEC EDGAR 原始申报链接,答案可审计;免费层无需注册,付费层按调用计量。
三种接入方式
REST JSON API
只读 /api/v1/*,GET + JSON,适合任何语言与 RAG 管道。
MCP Server
Claude / Cursor / Codex 原生工具调用:POST https://holdingshub.top/mcp
或本地 stdio。
llms.txt
/llms.txt · /llms-full.txt · dataset.jsonld ——给爬虫与 Agent 的机器可读说明书。
定价
Free
$0 / 月
3,000 次调用 / 月
- 3,000 API calls/month after signup (API key required)
- Full quarter history
- REST + MCP read access
Gold
$9.90 / 月
10,000 次调用 / 月
- 10,000 API calls/month (REST + MCP)
- Everything in Free
- Full holdings pages & holder lists
- Unlimited compare, screener & backtests
Diamond
$19.90 / 月
30,000 次调用 / 月
- 30,000 API calls/month (REST + MCP)
- Everything in Gold
- CSV downloads of every table
- 13F filing webhooks
- Priority support
| 等级 | 每月调用 | 超额 | 超额封顶 |
|---|---|---|---|
| Free | 3,000 | 到额度即暂停 | — |
| Gold | 10,000 | $0.01/次 | $30/月 |
| Diamond | 30,000 | $0.01/次 | $100/月 |
每一次调用都需要 API key——先注册会员,再到本页创建 key;没有 key 一律返回 401。 免费会员每月 3,000 次,付费档超出套餐不阻断,按 $0.01/次 计费; 每个 key 默认带每月超额封顶,触顶返回 402 停表,不会产生开放式账单。
API Keys
端点
| Endpoint | 说明 |
|---|---|
/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. |
统一响应结构:{data, meta, provenance, usage, attribution};
错误为 {"error": {...}, "status": 4xx};429=超配额,402=需付费。
MCP
| Tool | 作用 |
|---|---|
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. |
远程接入(Claude / Cursor):
{
"mcpServers": {
"holdingshub": {
"type": "http",
"url": "https://holdingshub.top/mcp"
}
}
}
本地 stdio(数据不出本机):
{
"mcpServers": {
"holdingshub": {
"command": "python",
"args": ["/path/to/usstocktools/mcp_server.py", "--stdio"]
}
}
}
数据边界
- 13F 只含美股多头持仓:不含空头、多数衍生品与非美股证券。
- 申报最晚在季末 45 天后提交,一个季度约两个月后才完整;响应中的
filers_in_period与period_complete会告诉你当前是否完整。 weight_pct是占「已披露多头组合」的比例,不是占 AUM。- 数据来自 SEC EDGAR 公开申报,可商用;请保留
provenance.sec_edgar_url溯源。