Skip to main content
Form 13F 是 SEC Filing 家族下的独立子产品。采用 seed-only pure cache 模式：latest-quarter Top 1000 机构 × 最近 4 季度预填，cache miss 直接返回空，不回源上游。

​
接口

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

​
参数

manager_cik 与 manager_name 至少传一个。
​
manager_cik
string
机构 SEC CIK 号（如 Berkshire Hathaway 的 1067983）。两者同时传时，manager_cik 优先。
​
manager_name
string
机构名称自由文本（如 Bridgewater、Berkshire Hathaway）。服务端走 exact → alias → 轻量 fuzzy resolver 解析。
​
period
string
季末日期 YYYY-MM-DD（如 2025-12-31）。省略则返回该机构最新已 seed 季度。
​
limit
integer
default:200
最多返回的持仓数（最大 500）。一份 13F 通常 50–500 条。

​
返回值

​
data
object

​
错误处理

场景状态码返回
manager_name 解析不到404{ "error": "manager_not_found" }
manager_name 解析出多个候选409{ "error": "manager_name_ambiguous", "candidates": [...] }
manager_cik 合法但不在 Top 1000200空 data + meta.scope_notice
period 超出 seed 窗口（最近 4 季度）200空 data + meta.scope_notice
manager_cik 与 manager_name 都传且不一致400—

​
缓存

  • Seed-only pure cache：cache miss 不调用上游 sec-api.io
  • 缓存键：filing 级 accession_number，holdings 级 (filing_id, cusip, title_of_class)
  • Amendment 通过 isAmendment=true upsert 覆盖

​
数据范围（Coverage Scope）

每次响应的 meta.scope 都会显式声明： 
{
  "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": "13F data covers the latest-quarter top 1,000 institutional managers ranked by 13F reportable value (an AUM proxy, not true firmwide AUM) across the last 4 quarters. This ranking excludes fixed income, options, non-U.S. holdings, and shorts."
  }
}

​
代码示例

from __future__ import annotations

import requests

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


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


def main() -> None:
    data = fetch_manager_holdings("Berkshire Hathaway", "2025-12-31")
    manager = data["manager"]
    holdings = data["holdings"]

    print(f"{manager['manager_name']} -- {len(holdings)} holdings")

    for holding in holdings[:10]:
        label = holding["ticker"] or holding["cusip"]
        print(f"  {label}: ${holding['value_usd']:,}")


if __name__ == "__main__":
    main()

​
响应示例

{
  "data": {
    "manager": {
      "manager_cik": "1067983",
      "manager_name": "BERKSHIRE HATHAWAY INC",
      "match_type": "alias",
      "latest_reportable_value_usd": 302459211458,
      "latest_reportable_value_period": "2025-12-31",
      "current_scope_rank": 7
    },
    "filing": {
      "sec_13f_filing_id": "uuid",
      "filing_type": "13F-HR",
      "accession_number": "0000950123-26-001234",
      "filed_at": "2026-02-14",
      "period_of_report": "2025-12-31",
      "is_amendment": false,
      "table_entry_total": 110,
      "table_value_total": 302459211458
    },
    "holdings": [
      {
        "cusip": "025816109",
        "ticker": "AXP",
        "name_of_issuer": "AMERICAN EXPRESS CO",
        "title_of_class": "COM",
        "value_usd": 55145133598,
        "shares": 149061045,
        "shares_type": "SH",
        "investment_discretion": "SOLE",
        "voting_sole": 149061045,
        "voting_shared": 0,
        "voting_none": 0,
        "put_call": null
      }
    ]
  }
}

​
当前限制

  • 仅 Top 1000 机构（按最近季度 13F reportable value 排序）
  • 仅最近 4 季度
  • 不做跨季度 diff（客户端调两次自行 diff）
  • 不覆盖长尾机构
  • 不支持 confidential / 延迟披露持仓