已暴露为 MCP 工具:sec_13f_list_ticker_holders —— 在 Claude / Cursor / 任意 MCP 客户端中直接调用。详见 MCP Server 60 秒配置。
已上线
每次 1 credit
它做什么
查”谁持有某只美股”。传 ticker + 可选的 year + quarter,返回那一季 Top 1000 机构里持有这只票的列表 —— 每条带这家机构当季的持仓市值、股数,加上这家机构本身在 Top 1000 里的排名和规模。默认按持仓市值倒序。
BRK.B 这类带点的 ticker 服务端会自动改写成 BRK-B;查不到的 ticker 返回空列表(不是 404)。本工具是参数化查询,不是语义搜索。覆盖范围只到 Top 1000 机构,不是全市场所有持有该股票的 13F 申报人 —— 长尾小机构、零售投资人都不在里面。
返回值
data
TickerHoldersResult
required
Show TickerHoldersResult 字段
归一化后的 ticker(如 BRK.B → BRK-B)。
所对应的季末日期(YYYY-MM-DD),= 你传入的 (year, quarter) 对应季末。
Top 1000 内持有该 ticker 的机构数(≤ 1000)。用它判断 cohort 规模再决定下一步。
所有 in-scope 持有人的 value_usd 之和。
默认按 value_usd 倒序。
manager_period_reportable_value_usd
该 manager 在 ranking_period 这季的 13F reportable value(AUM proxy)。如果该季 ranking 暂不可用,会是 null(持仓行仍会返回,但 ranking metadata 缺失)。
上一字段对应的季度;ranking 缺失时为 null。
该 manager 在 ranking_period 这季的排名;ranking 缺失时为 null。
200 OK · sec_13f_list_ticker_holders
{
"data": {
"ticker": "NVDA",
"ranking_period": "2025-12-31",
"total_holders_in_scope": 187,
"aggregate_value_usd": 123456789000,
"holders": [
{
"manager_cik": "1067983",
"manager_name": "BERKSHIRE HATHAWAY INC",
"manager_period_reportable_value_usd": 302459211458,
"manager_period_of_report": "2025-12-31",
"manager_period_rank": 7,
"sec_13f_filing_id": "uuid",
"accession_number": "0000950123-26-001234",
"cusip": "67066G104",
"title_of_class": "COM",
"value_usd": 1234567890,
"shares": 9000000,
"shares_type": "SH"
}
]
},
"meta": {
"creditsUsed": 1,
"scope": {
"managers_seeded": 1000,
"universe_period": "2025-12-31",
"available_ranking_periods": [
"2025-03-31",
"2025-06-30",
"2025-09-30",
"2025-12-31"
],
"selection_basis": "latest quarter 13F reportable value desc",
"is_top_1000_only": true
},
"scope_notice": "Holders list is restricted to the Top 1,000 smart-money universe; not full-market ownership. 13F coverage: Top 1,000 managers selected from quarter 2025-12-31. Ranking data available for 4 quarters: 2025-03-31 … 2025-12-31. Reportable value is an AUM proxy excluding fixed income, options, non-U.S. holdings, and shorts."
}
}
canonical 工作流:本反向查询与 sec_13f_list_top_managers(确定 universe 规模)以及 sec_13f_list_manager_holdings(钻进单只基金的全部持仓)配合使用。本工具回答 “谁持有 X?“,正向工具回答 “这只基金在持什么?”。
用 manager_period_rank 和 manager_period_reportable_value_usd 在客户端做过滤 —— 比如只展示持有人中 Top 30 的机构,避免大量长尾小持仓干扰。
典型 agent 问法:本工具只返回单季持有人名单,跨季度变化需要 agent 自己调两次再对比。注意覆盖范围仅 Top 1000 smart-money universe,不是全市场持有人;某机构两季的可见性差异也可能来自”它本季掉出 Top 1000”而不是真的”退出该股”,agent 解读时要小心。
仅 Top 1000 机构 scope,不是全市场持有人。覆盖范围之外的基金(以及零售 / 直接持有人)不在结果里。
如果 ticker 不在任何 Top 1000 manager 的已覆盖季度持仓中,工具返回 200 OK + 空 holders + scope_notice。
暂不支持 confidential / 延迟披露持仓。
直接调用
{
"method": "tools/call",
"params": {
"name": "sec_13f_list_ticker_holders",
"arguments": { "ticker": "NVDA", "year": 2025, "quarter": 4, "limit": 100 }
}
}
完整参数参考
sec_13f_list_ticker_holders — 请求参数
美股 ticker(如 NVDA、TSLA、AAPL)。大小写不敏感,服务端自动归一化(BRK.B → BRK-B)。
要查询的季度所在年(如 2025)。范围 [2013, 2030]。必须与 quarter 同传或同省;省略则默认 = 最新已覆盖季度。
要查询的季度 1-4(Q1=Jan-Mar,Q4=Oct-Dec)。必须与 year 同传或同省。
最多返回的持有人数。默认 100,最大 1000 —— 如需 Top 1000 全量再客户端按 manager AUM proxy 裁剪,可调到上限。
相关接口
13F 按机构查持仓
正向方向 —— 列出某只基金某季度的全部持仓。
13F 头部机构枚举
枚举本季度 smart money universe,给持有人 cohort 定大小或做过滤。
MCP Server 接入
60 秒接入 Claude / Cursor / 任意 agent harness。