开发者 · AI 数据 API

把 HoldingsHub 的 13F 持仓数据接进你的 Agent、研究流程或产品。每个响应都带 SEC EDGAR 原始申报链接,答案可审计;免费层无需注册,付费层按调用计量。

9251 家机构 · 68 13F 个季度 (2000-Q4 → 2026-Q3) · 27,532,135 行持仓 · 更新于 2026-11-15

三种接入方式

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 的机器可读说明书。

定价

API 与 MCP 的调用额度已包含在会员中——没有单独的 API 合同。 你的 key 自动跟随账号等级(Free),升级会员即升级全部 key。
当前

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
等级 每月调用 超额 超额封顶
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

登录后创建 key

端点

Endpoint说明
/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.

统一响应结构:{data, meta, provenance, usage, attribution}; 错误为 {"error": {...}, "status": 4xx};429=超配额,402=需付费。

MCP

Tool作用
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.

远程接入(Claude / Cursor):

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

本地 stdio(数据不出本机):

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

数据边界

详见 数据字典、完整 API 参考 与 变更日志。