get_institution_holdings

MCP REST

按 CIK 与季度返回单个机构投资者的 13F 持仓。

工具 · v1· 更新于 2026-05-20· 生产中

端点

协议	端点
MCP	get_institution_holdings(cik, quarter, limit)
REST	GET https://api.ko.io/v1/institutions/{cik}/holdings

参数

名称	类型	必填	说明
`cik`	string	是	10 位 CIK 标识(前导补零)。例:`"0001067983"`(伯克希尔)。
`quarter`	string	是	`YYYYQq` 格式的季度。例:`"2025Q4"`。
`limit`	integer	否	返回的最大行数(1–1000),默认 `100`。
`offset`	integer	否	分页偏移量,默认 `0`。
`sort_by`	enum	否	排序字段,默认 `value_usd`。可选 `value_usd` / `shares` / `change_pct`。
`include_amendments`	boolean	否	是否并入 13F/A 修正,默认 `true`(推荐)。

一个 JSON 对象,含机构元信息、持仓数组(每行带 source 引用)与分页。

RESPONSE SCHEMA · JSON

{
  "institution": {
    "cik": "0001067983",
    "name": "Berkshire Hathaway Inc.",
    "filer_type": "13F"
  },
  "quarter": "2025Q4",
  "holdings": [
    {
      "ticker":      "AAPL",
      "cusip":       "037833100",
      "issuer_name": "Apple Inc.",
      "shares":      905600000,
      "value_usd":   173600000000,
      "pct_portfolio": 55.1,
      "change_pct_qoq": 0.0,
      "share_class": "COM",
      "source": {
        "form":             "13F-HR",
        "accession_number": "0001067983-26-000009",
        "filed_at":         "2026-02-14T00:00:00Z",
        "url":              "https://www.sec.gov/Archives/..."
      }
    }
  ],
  "total_value_usd":  315000000000,
  "total_positions": 42,
  "page": { "limit": 100, "offset": 0, "total": 42 }
}

示例

EXAMPLE · MCP

> 列出伯克希尔 2025 Q4 前 10 大持仓

工具调用: get_institution_holdings
  cik:     "0001067983"
  quarter: "2025Q4"
  limit:   10

→ 返回 10 行 · 总市值 $315B · 4.1ms · 命中缓存

$ curl -H "Authorization: Bearer ko_live_..." \
    "https://api.ko.io/v1/institutions/0001067983/holdings?quarter=2025Q4&limit=10"

import requests

r = requests.get(
    "https://api.ko.io/v1/institutions/0001067983/holdings",
    params={"quarter": "2025Q4", "limit": 10},
    headers={"Authorization": "Bearer ko_live_..."},
)
holdings = r.json()["holdings"]

for h in holdings:
    print(h["ticker"], h["value_usd"], h["source"]["accession_number"])

错误码

状态	符号	说明
400	`INVALID_CIK`	CIK 不是合法的 10 位前导补零标识。
400	`INVALID_QUARTER`	季度不符合 `YYYYQq` 格式。
404	`NOT_FOUND`	该 CIK 与季度下不存在 13F 申报。
429	`RATE_LIMITED`	超出当前档位速率限制,见 `Retry-After` 头。
500	`UPSTREAM_ERROR`	数据层内部问题(罕见)。