跳到正文

开发文档

通过 REST 或 MCP 查询 13F 持仓、内部人交易、国会议员交易、财务数据和宏观数据。你可以先发一个请求，也可以接入 AI 智能体，或直接查阅 API 参考。

REST 基础 URL: https://api.ko.io

发出第一个请求

在演示模式下请求 Berkshire Hathaway 最新的 13F 持仓：无需密钥，无需注册。下方附有这条记录所来自的申报文件。
curl "https://api.ko.io/api/v1/holdings/1067983?per_page=1&demo=true"
响应

以下为 2026年9月23日 采集的响应（节选，季末 2026年6月30日）。点击运行可获取实时响应，无需密钥或注册；实时结果可能已是更新的季度。

{
  "data": [
    {
      "cik": "1067983",
      "quarter_date": "2026-06-30",
      "ticker": "AAPL",
      "name_of_issuer": "APPLE INC",
      "shares_held": "227917808",
      "holding_value": "65950296923",
      "total_portfolio_value": "299253556246",
      "portfolio_weight_pct": 22.04,
      "action": "UNCHANGED",
      "share_change": "0",
      "prev_shares": "227917808"
    }
  ]
}
申报机构
Berkshire Hathaway
股票代码
AAPL
股数
227,917,808
合并的申报行数
12
来源SEC EDGAR13F-HR0001193125-26-352200 ↗季末 2026-06-30申报于 2026-08-14

这条记录本身不带申报编号。它所解析自的 13F-HR（季末 2026年6月30日，采集于 2026年9月23日）可以通过 GET /api/v1/filings/1067983?form=13F-HR 查到。季度更新后，会返回更新的申报文件。

下一步，注册免费账户，并在控制台 → API 密钥中创建密钥，然后按下文方式放在 Authorization 请求头中，以 Bearer 令牌发送。分页使用 page 和 per_page。快速开始提供同一请求的 curl、Python 和 MCP 写法；API 调试台可以用你的密钥直接发请求。

身份验证

在 Authorization 请求头中以 Bearer 令牌发送 API 密钥。密钥以 ko_live_ 开头，可在控制台中创建。
curl "https://api.ko.io/api/v1/holdings/1067983" \
  -H "Authorization: Bearer ko_live_your_key_here"

演示模式

在免费版接口后加上 ?demo=true，无需密钥即可调用。演示模式按 IP 限制调用频率；Pro 版和团队版接口会返回 403 PLAN_REQUIRED。
网站登录接口 （供网站会话登录使用，不适用于 API 密钥）
  • POST/api/auth/google · /api/auth/login · /api/auth/register · /api/auth/logout
  • GET/api/auth/me · /api/auth/profile

响应格式​与数据来源

数据接口成功时返回 { data, meta }，失败时返回 { error: { code, message } }。列表接口的 data 是数组，单个资源是对象；文件和文档类接口的格式见 API 参考。
列表响应200 OK
{
  "data": [ ... ],
  "meta": {
    "page": 1,
    "per_page": 50,
    "total_count": 1234,
    "query_time_ms": 3.1
  }
}
对象响应200 OK
{
  "data": { ... },
  "meta": {
    "query_time_ms": 2.1
  }
}

数据来源

SEC 数据由公开申报文件标准化整理而来。13F、Form 4 等 REST 数据行不包含申报编号（accession number）；如需定位原始文件，请使用申报文件查询接口：先用 /api/v1/filings/:cik 列出申报人的申报文件，再用 /api/v1/filings/:cik/:accession 打开其中一份。数值字段常以字符串返回（例如 "holding_value": "65950296923"），计算前请先转换。

接入 AI 智能体

24 个工具
MCP 服务器 https://mcp.ko.io/mcp 为 Claude Code、Codex、Cursor、Grok（xAI API）、Gemini CLI 及其他 MCP 客户端提供与 REST API 相同的数据。MCP 工具调用与 REST 请求共用同一份每日额度。
Claude Code
claude mcp add ko-sec-data --transport http https://mcp.ko.io/mcp

各客户端的配置、演示模式与 API 密钥的接入方式，以及全部 24 个工具（可搜索，含所需套餐）都在 MCP 页面。完整示例请看搭建 SEC 数据智能体。

接口分组

打开 API 参考

核心数据接口按分组列出，每个接口一行，点击即可打开它在 API 参考中的条目。参数、响应格式和可运行的请求都在 API 参考中；加密货币 ETF、N-PORT、Reg SHO 和申报文件网关等接口也只在那里列出。未标注套餐的接口在免费版和演示模式下均可使用。

17 个分组，共 44 个核心接口

机构

4

持仓

1

股票与公司

7

股票持有结构

2

内部人交易

2

国会议员交易

4

其他 SEC 申报

6

美国国债

3

美联储

3

经济指标

1

市场结构

2

能源

1

银行

3

金融压力

1

批量导出

1

看板

2

套餐与​调用频率限制

限制按账户计算，每日额度在 00:00 UTC 重置。
套餐
每日调用次数
每次请求行数
价格
免费版
200
500
$0
Pro 版
20,000
5,000
$29/月
团队版
200,000
50,000
$99/月
企业版
1,000,000
不限
$499/月

以上为按月付费价格；按年付费更优惠，详见定价页面，其中也列出了各套餐包含的内容。免费版仅含最近一个季度和最新数据；完整历史需 Pro 版或更高套餐。MCP 工具调用与 REST 请求共用同一份额度。响应头中包含 X-RateLimit-Limit、X-RateLimit-Remaining 和 X-RateLimit-Reset。

错误码

400
请求有误
检查查询参数和路径格式。
401
缺少密钥或密钥无效
发送有效的 API 密钥，或在免费版接口上使用 ?demo=true。
403
需要更高套餐
你的套餐不包含该接口或该功能。
404
未找到
检查路径和标识符（CIK、股票代码、slug）。
429
超出调用频率限制
查看调用频率相关的响应头。如果每日额度已用完，请等到 00:00 UTC，或升级套餐。
500
服务器错误
几秒后重试。
错误响应401
{
  "error": {
    "code": "INVALID_API_KEY",
    "message": "Missing or invalid API key. Get one at https://ko.io/console/keys"
  }
}
错误响应403
{
  "error": {
    "code": "PLAN_REQUIRED",
    "message": "This endpoint requires a paid plan. Upgrade at https://ko.io/pricing"
  }
}