数据与 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 结构化标记,机器抓取可自动识别作者、许可与更新时间。

开放数据下载

实体映射

26,223 只美股证券的代码 → 公司名、GICS 板块映射, 支持在线检索与全量 CSV 下载。

数据字典

字段定义、季度口径、weight 计算方式与已知数据局限。

变更日志

每季新增机构、数据修复与口径变更记录。