数据与 API
HoldingsHub 的全部数据支持程序化访问:只读 JSON API(免费层每日 100 次)、 可下载的证券实体映射、字段级数据字典和公开变更日志。数据来自 SEC EDGAR 13F 公开申报。
覆盖范围
9281 家机构 · 68 13F 个季度 (2000-Q4 → 2026-Q3) · 27,992,453 行持仓 · 26,223 只证券
JSON API v1
免费层每日 100 次请求,无需注册;Gold 每日 1,000 次;
Diamond 不限量(会员权益)。
超出配额返回 HTTP 429(JSON 响应含升级链接)。响应自带
Cache-Control: max-age=3600,建议客户端按此缓存。
| Endpoint | 说明 |
|---|---|
GET /api/v1/meta |
覆盖范围、更新时间与端点列表 |
GET /api/v1/funds |
全部机构及最新季度汇总 |
GET /api/v1/funds/{slug} |
单机构档案与可用季度列表 |
GET /api/v1/funds/{slug}/holdings?quarter=2026-Q2 |
持仓明细(quarter 缺省为最新季;limit≤5000、offset 分页) |
GET /api/v1/stocks/{symbol} |
单只证券与最新季前 25 大持有机构 |
GET /api/v1/stats |
全市场季度统计(申报数、总市值、新建仓/清仓、板块流向),配合 统计页 |
示例:
curl "https://holdingshub.top/api/v1/funds/berkshire-hathaway/holdings?quarter=2026-Q2"
错误统一返回 JSON:{"error": "...", "status": 404}。
给 AI Agent 使用
本站 13F 数据已封装为 AI-ready 接口:每个响应都带 SEC EDGAR 原始申报链接
(可审计)、统一 {data, meta, provenance, usage} 结构与 schema.org
标注。三种接入方式:
Developers
API key 自助申请、用量与账单。 调用额度含在会员中:需注册并创建 key,Free 3,000 次/月、 Gold 10,000 次/月、Diamond 30,000 次/月,溢出 $0.01/次(有封顶)。
MCP Server
Claude / Cursor / Codex 原生工具:getFundHoldings、getStockHolders、 compareFunds、getActiveShare、getHistoricalChanges、watch13FFiling。
/llms.txt
机器可读的接口说明书(完整版、 dataset.jsonld)。
新增端点:
| Endpoint | 说明 |
|---|---|
GET /api/v1/search?q= |
按名称/代码解析机构或证券 |
GET /api/v1/funds/{slug}/changes?from=&to= |
季度间新建仓/清仓/加仓/减仓 |
GET /api/v1/funds/{slug}/active-share |
相对标普 500 / QQQ 的 Active Share |
GET /api/v1/stocks/{symbol}/holders |
持有该证券的全部机构 |
GET /api/v1/compare/funds?funds= |
2–4 家组合的持仓重合度 |
GET /api/v1/13f/filings?since= |
最新 13F-HR 披露推送 |
GET /api/v1/usage |
配额、用量与预估费用 |
引用本数据(统一格式)
在文章、论文或可视化中使用本站数据时,请使用以下任一格式注明出处:
纯文本:
HoldingsHub (2026). 13F holdings data [Dataset]. https://holdingshub.top
HTML:
<a href="https://holdingshub.top">Data: HoldingsHub</a> (SEC 13F filings)
每个数据页均已内嵌 schema.org Dataset 结构化标记,机器抓取可自动识别作者、许可与更新时间。