> ## 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 头部机构枚举

> 按指定季度的 13F reportable value（AUM proxy）枚举该季 SEC Form 13F Top 1000 机构集合中的 Top N 机构投资人 —— 每个季度有各自的 Top 1000，支持跨季度名单与排名对比。

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

<Badge color="green" icon="circle-check">已上线</Badge>
 
<Badge color="gray" size="sm">免费 · ranked list</Badge>

## 它做什么

按你指定的季度，列出该季 13F 申报金额最大的前 N 家机构（最多 1000 家）。rank `1` 是那季 13F 申报金额最大的一家。每个季度有各自的 Top 1000，旧季度的结果在新季度发布后保持稳定。

### 两个"季度"字段，现在指向同一季

* **`manager_set_period`** — "这次返回的 Top 1000 是哪一季的"。**等于你查询的那一季**（`year + quarter`）；两个都不传就默认取覆盖到的最新一季。
* **`ranking_period`** — "这次返回的排名和金额是哪一季算的"。**等于 `manager_set_period`** —— 每一季都用它自己的 Top 1000 来返回。

换不同的 `(year, quarter)` 会拿到那一季各自的名单；机构跨季度有进有出，所以名单对比是真实有意义的，而且旧季度的名单在新季度发布后保持稳定。传超出覆盖范围的季度会返回 200 + 空列表 + `meta.notice` 说明。

## 返回值

<ResponseField name="data" type="TopManagersResult" required>
  <Expandable title="TopManagersResult 字段">
    <ResponseField name="manager_set_period" type="string" nullable>
      这次返回的 Top 1000 机构集合所属的季度（YYYY-MM-DD）；等于你查询的那一季（两个都省略时 = 覆盖到的最新一季），且 = `ranking_period`。
    </ResponseField>

    <ResponseField name="ranking_period" type="string" nullable>
      本次响应排名/数值所属的季度（YYYY-MM-DD）。等于你传入的 (year, quarter) 对应的季末日期，且 = `manager_set_period`。
    </ResponseField>

    <ResponseField name="managers" type="TopManager[]" required>
      机构数组，按 `period_rank` 升序。

      <Expandable title="TopManager 字段">
        <ResponseField name="manager_cik" type="string" required>SEC CIK。</ResponseField>
        <ResponseField name="manager_name" type="string" required>规范化的机构名称。</ResponseField>

        <ResponseField name="aliases" type="string[]" required>
          已知别名 / DBA 名称（可能为空数组）。可用于把自然语言里提到的机构名映射回 `manager_cik`。
        </ResponseField>

        <ResponseField name="period_rank" type="integer" required>
          在 `ranking_period` 这季内的排名（`1` = 该季度 13F reportable value 最大）。
        </ResponseField>

        <ResponseField name="period_reportable_value_usd" type="number" required>
          `ranking_period` 这季的 13F reportable value（USD）。**AUM proxy，不是真实的全公司 AUM** —— 不含固收、期权、海外、空头。
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="meta.creditsUsed" type="number">固定 `0` —— 本接口免费。</ResponseField>
<ResponseField name="meta.remainingCredits" type="number">本次调用后的剩余 credits。</ResponseField>

<ResponseField name="meta.notice" type="string">
  数据范围说明；当传入超出覆盖范围的 (year, quarter) 时附加 "has no ranking data"。
</ResponseField>

```json title="200 OK · sec_13f_list_top_managers" expandable theme={null}
{
  "data": {
    "manager_set_period": "2025-12-31",
    "ranking_period": "2025-12-31",
    "managers": [
      {
        "manager_cik": "0001364742",
        "manager_name": "BLACKROCK INC.",
        "aliases": ["BLACKROCK", "BLACKROCK FUND ADVISORS"],
        "period_rank": 1,
        "period_reportable_value_usd": 4521893245678
      },
      {
        "manager_cik": "0000102909",
        "manager_name": "VANGUARD GROUP INC",
        "aliases": ["VANGUARD"],
        "period_rank": 2,
        "period_reportable_value_usd": 4123456789012
      }
    ]
  },
  "meta": {
    "creditsUsed": 0,
    "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 工作流 —— Smart Money Consensus 池**：

  1. `sec_13f_list_top_managers?limit=30` —— 拿 Top 30 基金池
  2. 对池里每个 `manager_cik` 调一次 `sec_13f_list_manager_holdings` 拿持仓
  3. 客户端聚合算 consensus / overlap 榜

  本工具 **不返回** 持仓数据 —— 需要扇出。
</Tip>

<Tip>
  **典型 agent 问法**：每个季度有各自的 Top 1000，排名也是按季各自算 —— agent 可以根据下面这类问题自己决定调几次本工具、对比哪几个季度。

  <Prompt description="Top 30 smart money 名单跨季度对比">
    本季和上一季的 13F Top 30 smart money manager 对比一下，谁新进了？谁掉出去了？谁排名变化最大？
  </Prompt>

  <Prompt description="某季 Top N 基金池">
    给我 2025 Q4 13F reportable value 排名前 30 的机构，按 AUM proxy 倒序。
  </Prompt>
</Tip>

<Tip>
  调 `sec_13f_list_manager_holdings` 之前，先用本工具的 `aliases` 把自然语言里提到的 "BlackRock"、"Vanguard" 映射到 canonical `manager_cik`，可以省掉一次走 `manager_name` resolver 的来回。
</Tip>

<Warning>
  **每个季度有各自的 Top 1000 机构集合**：传不同 (year, quarter) 会返回那一季自己的名单 —— 机构跨季度有进有出，所以名单对比是真实有意义的。某个机构会出现在它当季进了 Top 1000 的每一个季度的结果里，而且旧季度的名单在新季度发布后保持稳定。
</Warning>

<Warning>
  **仅 Top 1,000**，按 13F reportable value 排序（AUM proxy，**不是**真实 AUM）。不含固收、期权、海外、空头。
</Warning>

<Warning>
  **不是** semantic / keyword search —— 不支持自然语言 manager 过滤。需要按 manager 名找持仓时用 `sec_13f_list_manager_holdings` 的 `manager_name` 参数。
</Warning>

## 直接调用

<Accordion title="HTTP / SDK 示例" icon="terminal">
  <CodeGroup>
    ```typescript MCP (Claude / Cursor) theme={null}
    // 1) 取 latest 季度的 Top 30 基金池
    {
      "method": "tools/call",
      "params": {
        "name": "sec_13f_list_top_managers",
        "arguments": { "limit": 30 }
      }
    }

    // 2) 取 prev 季度的 Top 30，做名单 diff
    {
      "method": "tools/call",
      "params": {
        "name": "sec_13f_list_top_managers",
        "arguments": { "limit": 30, "year": 2025, "quarter": 3 }
      }
    }
    ```

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

    base = "https://api.llmquantdata.com"
    headers = {"Authorization": f"Bearer {os.environ['LLMQUANT_API_KEY']}"}

    # latest 季度 Top 30
    latest = requests.get(
        f"{base}/api/filings/13f/managers",
        headers=headers,
        params={"limit": 30},
    ).json()["data"]["managers"]

    # 显式指定季度
    prev = requests.get(
        f"{base}/api/filings/13f/managers",
        headers=headers,
        params={"limit": 30, "year": 2025, "quarter": 3},
    ).json()["data"]["managers"]
    ```

    ```bash cURL theme={null}
    # latest 季度 Top 30
    curl "https://api.llmquantdata.com/api/filings/13f/managers?limit=30" \
      -H "Authorization: Bearer $LLMQUANT_API_KEY"

    # 显式指定季度
    curl "https://api.llmquantdata.com/api/filings/13f/managers?limit=30&year=2025&quarter=3" \
      -H "Authorization: Bearer $LLMQUANT_API_KEY"
    ```
  </CodeGroup>
</Accordion>

## 完整参数参考

<Accordion title="sec_13f_list_top_managers — 请求参数" icon="sliders">
  <ParamField query="limit" type="integer" default={30}>
    返回的机构数量，按 `period_rank` 升序。默认 `30`。范围 `[1, 1000]`；服务端 clamp 越界值。
  </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>
</Accordion>

## 相关接口

<Columns cols={3}>
  <Card title="13F 按机构查持仓" icon="briefcase" href="/zh-CN/api/filings/13f-by-manager">
    正向方向 —— 取出一只基金完整持仓（本工具最自然的扇出目标）。
  </Card>

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

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