Skip to main content
与 /filings/13f/by-manager 共享同一份 Top 1000 seed window 的反向索引。返回结果不是全市场所有持有该 ticker 的 13F 申报人，仅限已 seed 的 Top 1000。

​
接口

​
GET
string
https://api.llmquantdata.com/filings/13f/by-ticker

​
参数

​
ticker
string
required
美股 ticker（如 NVDA）。大小写不敏感，服务端自动归一化（BRK.B → BRK-B）。
​
period
string
季末日期 YYYY-MM-DD。省略返回最新已 seed 季度。
​
limit
integer
default:100
最多返回的持有人数（最大 1000）。如消费方需要 Top 1000 全量再按 manager AUM proxy 客户端裁剪，可调高 limit。

​
返回值

​
data
object

​
缓存

  • 复用 canonical.sec_13f_holdings 的本地索引做反向查询
  • 永久缓存（seed-only 模式，无上游 refresh）
  • Cache miss（ticker 不在任何 Top 1000 manager 的任何 seed 季度持仓中）返回空 holders + meta.scope_notice

​
数据范围

{
  "meta": {
    "creditsUsed": 1,
    "scope": {
      "managers_seeded": 1000,
      "latest_period": "2025-12-31",
      "earliest_period": "2025-03-31",
      "selection_basis": "latest quarter 13F reportable value desc",
      "is_top_1000_only": true
    },
    "scope_notice": "Holders list is restricted to the latest-quarter top 1,000 managers ranked by 13F reportable value, not full-market ownership."
  }
}

​
代码示例

from __future__ import annotations

import requests

API_URL = "https://api.llmquantdata.com/filings/13f/by-ticker"
HEADERS = {"X-API-KEY": "your_api_key_here"}


def fetch_ticker_holders(ticker: str, period: str, limit: int = 100) -> dict:
    response = requests.get(
        API_URL,
        params={
            "ticker": ticker,
            "period": period,
            "limit": limit,
        },
        headers=HEADERS,
        timeout=30,
    )
    response.raise_for_status()
    return response.json()["data"]


def main() -> None:
    data = fetch_ticker_holders("NVDA", "2025-12-31", limit=50)
    holders = data["holders"]

    print(
        f"{data['ticker']} -- {data['total_holders_in_scope']} holders, "
        f"aggregate ${data['aggregate_value_usd']:,}"
    )

    for holder in holders[:10]:
        print(
            f"  #{holder['manager_scope_rank']:>4} "
            f"{holder['manager_name']}: ${holder['value_usd']:,}"
        )


if __name__ == "__main__":
    main()

​
响应示例

{
  "data": {
    "ticker": "NVDA",
    "period_of_report": "2025-12-31",
    "total_holders_in_scope": 187,
    "aggregate_value_usd": 123456789000,
    "holders": [
      {
        "manager_cik": "1067983",
        "manager_name": "BERKSHIRE HATHAWAY INC",
        "manager_reportable_value_usd": 302459211458,
        "manager_reportable_value_period": "2025-12-31",
        "manager_scope_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"
      }
    ]
  }
}

​
当前限制

  • 仅 Top 1000 机构 scope，非全市场持有人
  • 不做聚合排名（如”本季 net buy 排名”）
  • 不覆盖长尾机构
  • 不支持 confidential 持仓