> ## Documentation Index
> Fetch the complete documentation index at: https://docs.llmquantdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 13F 按机构查持仓

> 列出某个机构投资人某季度的完整 SEC Form 13F 持仓 —— "这只基金在持什么？"的正向查询。

<Note icon="sparkles">
  **已暴露为 MCP 工具**：`sec_13f_list_manager_holdings` —— 在 Claude / Cursor / 任意 MCP 客户端中直接调用。详见 [MCP Server](/zh-CN/integration/mcp-server) 60 秒配置。
</Note>

<Badge color="green" icon="circle-check">已上线</Badge>
 
<Badge color="blue" size="sm">每次 1 credit</Badge>

## 它做什么

查一只基金某一季的全部 13F-HR 持仓。传 `manager_cik`（机构 SEC 编号）或 `manager_name`（机构名）+ 可选的 `year` + `quarter`，返回该机构那一季每条持仓的详细信息：股票编号（CUSIP）、ticker、持仓市值、股数、投票权、是不是期权。

`manager_name` 只是简单匹配（精确 → 别名 → 前缀模糊），**不是**自然语言搜索，不接受长句。匹配不到返回 200 OK + 空 `data` + `meta.notice`；匹配出多个返回 `400 invalid_request`，需要传 `manager_cik` 消歧。

覆盖范围是被查那一季的 Top 1000 机构（每个季度有各自的 Top 1000）；该季范围之外的 `manager_cik` 或 `(year, quarter)` 返回空数据 + `meta.notice` 说明。

## 返回值

<ResponseField name="data" type="ManagerHoldingsResult" required>
  <Expandable title="ManagerHoldingsResult 字段">
    <ResponseField name="ranking_period" type="string" nullable>
      本次响应数据所属的季度（YYYY-MM-DD），= 你传入的 (year, quarter) 对应的季末日期。
    </ResponseField>

    <ResponseField name="manager" type="object" required>
      解析后的机构身份与 AUM proxy。

      <Expandable title="manager 字段">
        <ResponseField name="manager_cik" type="string" required>SEC CIK。</ResponseField>
        <ResponseField name="manager_name" type="string" required>规范化的机构名称。</ResponseField>
        <ResponseField name="match_type" type="string" required>解析方式：`cik` / `exact` / `alias` / `fuzzy`。</ResponseField>
        <ResponseField name="latest_reportable_value_usd" type="number" required>**Manager 整体最新规模**（与请求季度无关）；最新一季 13F reportable value（AUM proxy）。</ResponseField>
        <ResponseField name="latest_reportable_value_period" type="string" required>上一字段对应的季度。</ResponseField>
        <ResponseField name="period_rank" type="integer" nullable>该机构在 `ranking_period` 这季的排名（无该季 ranking 时为 null）。</ResponseField>
        <ResponseField name="period_reportable_value_usd" type="number" nullable>该机构在 `ranking_period` 这季的 reportable value（USD）。</ResponseField>
        <ResponseField name="is_in_covered_manager_set" type="boolean" required>是否在 `ranking_period` 这季覆盖的 Top 1000 机构集合内 —— 按季判断，因为每个季度有各自的 Top 1000。</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="filing" type="object" required>
      命中的 13F-HR filing 标识。

      <Expandable title="filing 字段">
        <ResponseField name="filing_type" type="string" required>`13F-HR` 或 `13F-HR/A`（修订）。</ResponseField>
        <ResponseField name="accession_number" type="string" required>SEC 受理号。</ResponseField>
        <ResponseField name="filed_at" type="string" required>提交日期（`YYYY-MM-DD`）。</ResponseField>
        <ResponseField name="period_of_report" type="string" required>报告期季末。</ResponseField>
        <ResponseField name="is_amendment" type="boolean" required>是否修订件。</ResponseField>
        <ResponseField name="table_entry_total" type="integer" required>原 filing 持仓总条数。</ResponseField>
        <ResponseField name="table_value_total" type="number" required>原 filing 持仓总市值。</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="holdings" type="Holding[]" required>
      持仓数组，按 `value_usd` 倒序。

      <Expandable title="Holding 字段">
        <ResponseField name="cusip" type="string" required>CUSIP。</ResponseField>
        <ResponseField name="ticker" type="string" nullable>映射到的美股 ticker（现金、期权、未上市可能为 null）。</ResponseField>
        <ResponseField name="name_of_issuer" type="string" required>发行人名称（原文）。</ResponseField>
        <ResponseField name="title_of_class" type="string" required>证券类别（如 `COM`）。</ResponseField>
        <ResponseField name="value_usd" type="number" required>持仓市值（USD）。</ResponseField>
        <ResponseField name="shares" type="number" required>股数（或本金）。</ResponseField>
        <ResponseField name="shares_type" type="string" required>`SH`（股）或 `PRN`（本金）。</ResponseField>
        <ResponseField name="investment_discretion" type="string" required>`SOLE` / `SHARED` / `NONE` / `DFND`。</ResponseField>
        <ResponseField name="voting_sole" type="number" required>独立投票权股数。</ResponseField>
        <ResponseField name="voting_shared" type="number" required>共享投票权股数。</ResponseField>
        <ResponseField name="voting_none" type="number" required>无投票权股数。</ResponseField>
        <ResponseField name="put_call" type="string" nullable>`PUT` / `CALL`，非期权时为 `null`。</ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="meta.creditsUsed" type="number">本次调用消耗的 credit（固定 `1`）。</ResponseField>
<ResponseField name="meta.remainingCredits" type="number">本次调用后的剩余 credits。</ResponseField>
<ResponseField name="meta.notice" type="string">需要说明覆盖范围或空结果时返回的人话说明。</ResponseField>

```json title="200 OK · sec_13f_list_manager_holdings" expandable theme={null}
{
  "data": {
    "ranking_period": "2025-12-31",
    "manager": {
      "manager_cik": "1067983",
      "manager_name": "BERKSHIRE HATHAWAY INC",
      "match_type": "alias",
      "latest_reportable_value_usd": 302459211458,
      "latest_reportable_value_period": "2025-12-31",
      "period_rank": 7,
      "period_reportable_value_usd": 302459211458,
      "is_in_covered_manager_set": true
    },
    "filing": {
      "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
      }
    ]
  },
  "meta": {
    "creditsUsed": 1,
    "remainingCredits": 999,
    "notice": "13F coverage: Top 1,000 managers for quarter 2025-12-31 (each quarter has its own Top 1,000). 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."
  }
}
```

## 说明

<Tip>
  **canonical 工作流**：本工具与 `sec_13f_list_top_managers`（取 Top N 基金池）和 `sec_13f_list_ticker_holders`（"谁持有 X？"反向查询）配合使用。Consensus / overlap 分析的标准模式是：先枚举 top manager → 对每个 manager 调一次本工具 → 客户端聚合。
</Tip>

<Tip>
  **典型 agent 问法**：本工具只返回单季持仓，跨季度变化需要 agent 自己调两次再对比。下面这类问题 agent 可以自然处理：

  <Prompt description="某 manager 的某季持仓">
    Berkshire 2025 Q4 的 13F 持仓是什么？前 10 大持仓是哪些？
  </Prompt>

  <Prompt description="同 manager 跨季度持仓变化">
    Berkshire 这两季 13F 持仓对比一下，加仓最多的是哪只票？清仓了哪些？新进了哪些？
  </Prompt>
</Tip>

<Warning>
  **仅 Top 1000 范围**。超出覆盖范围的 `manager_cik` 返回 200 OK + 空 `data` + `meta.notice`。
</Warning>

<Warning>
  错误：`manager_name` 解析不到 → 200 OK + 空 `data` + `meta.notice`。`manager_name` 解析出多个候选 → `400 invalid_request`；请传 `manager_cik` 消歧。
</Warning>

<Warning>
  暂不支持 confidential / 延迟披露持仓。
</Warning>

## 直接调用

<Accordion title="HTTP / SDK 示例" icon="terminal">
  <CodeGroup>
    ```typescript MCP (Claude / Cursor) theme={null}
    {
      "method": "tools/call",
      "params": {
        "name": "sec_13f_list_manager_holdings",
        "arguments": {
          "manager_name": "Berkshire Hathaway",
          "year": 2025,
          "quarter": 4,
          "limit": 200
        }
      }
    }
    ```

    ```python Python (HTTP) theme={null}
    import os, requests

    resp = requests.get(
        "https://api.llmquantdata.com/api/filings/13f/by-manager",
        headers={"Authorization": f"Bearer {os.environ['LLMQUANT_API_KEY']}"},
        params={"manager_name": "Berkshire Hathaway", "year": 2025, "quarter": 4},
    ).json()
    manager = resp["data"]["manager"]
    for h in resp["data"]["holdings"][:10]:
        label = h["ticker"] or h["cusip"]
        print(f"{label:<8} ${h['value_usd']:>15,}")
    ```

    ```bash cURL theme={null}
    curl "https://api.llmquantdata.com/api/filings/13f/by-manager?manager_name=Berkshire%20Hathaway&year=2025&quarter=4" \
      -H "Authorization: Bearer $LLMQUANT_API_KEY"
    ```
  </CodeGroup>
</Accordion>

## 完整参数参考

<Accordion title="sec_13f_list_manager_holdings — 请求参数" icon="sliders">
  <ParamField query="manager_cik" type="string">
    机构 SEC CIK 号（如 Berkshire Hathaway 的 `1067983`）。两者同时传时 `manager_cik` 优先；不一致返回 `400`。
  </ParamField>

  <ParamField query="manager_name" type="string">
    机构名称自由文本（如 `Bridgewater`、`Berkshire Hathaway`）。服务端走 `exact → alias → 轻量 fuzzy` 解析。
  </ParamField>

  <ParamField query="year" type="integer">
    要查询的季度所在年（如 `2025`）。范围 `[2013, 2030]`。**必须与 `quarter` 同传或同省**；省略则返回该机构最新已覆盖季度。
  </ParamField>

  <ParamField query="quarter" type="integer">
    要查询的季度 `1-4`（Q1=Jan-Mar，Q4=Oct-Dec）。**必须与 `year` 同传或同省**。
  </ParamField>

  <ParamField query="limit" type="integer" default={200}>
    最多返回的持仓数。默认 `200`，最大 `500`。
  </ParamField>

  <Warning>
    `manager_cik` 与 `manager_name` 至少传一个。
  </Warning>
</Accordion>

## 相关接口

<Columns cols={3}>
  <Card title="13F 按 Ticker 查持有人" icon="rotate" href="/zh-CN/api/filings/13f-by-ticker">
    反向查询 —— Top 1000 中谁持有这只 ticker？
  </Card>

  <Card title="13F 头部机构枚举" icon="ranking-star" href="/zh-CN/api/filings/13f-top-managers">
    枚举覆盖的 Top 1000 机构集合，作为 fund pool 起点。
  </Card>

  <Card title="MCP Server 接入" icon="plug" href="/zh-CN/integration/mcp-server">
    60 秒接入 Claude / Cursor / 任意 agent harness。
  </Card>
</Columns>