发出第一个 API 请求
选择 REST 或 MCP，任选一种即可。可以在免费版接口后加 ?demo=true，以演示模式免密钥试用；也可以创建免费的 API 密钥，获得每天 200 次调用额度（REST 与 MCP 共用）。
免费版仅含最近一个季度和最新数据；完整历史需 Pro 版或更高套餐。
curl
用演示模式请求一只股票的实时概况。
Shell免费 · 无需密钥
curl "https://api.ko.io/api/v1/stocks/AAPL?demo=true"Shell使用你的 API 密钥
curl -H "Authorization: Bearer ko_live_YOUR_KEY" \
"https://api.ko.io/api/v1/stocks/AAPL"MCP（Claude Code、Codex、Cursor 或任意 MCP 客户端）
接入 MCP 服务器后，你的智能体就能直接查询数据。下面的命令适用于 Claude Code；Codex、Cursor、Grok 和 Gemini 的配置见 MCP 页面。
添加 MCP 服务器免费 · 无需密钥
claude mcp add ko-sec-data --transport http https://mcp.ko.io/mcp使用你的 API 密钥（按你的套餐和额度计）使用你的 API 密钥
claude mcp add ko-sec-data --transport http "https://mcp.ko.io/mcp?api_key=ko_live_YOUR_KEY"Python
用 requests，三行代码。
Python免费 · 无需密钥
import requests
r = requests.get("https://api.ko.io/api/v1/stocks/AAPL", params={"demo": "true"})
print(r.json()["data"])Python（使用你的 API 密钥）使用你的 API 密钥
import requests
headers = {"Authorization": "Bearer ko_live_YOUR_KEY"}
r = requests.get("https://api.ko.io/api/v1/holdings/1067983", headers=headers, params={"per_page": 5})
print(r.json()["data"]) # Berkshire Hathaway's latest 13F positions响应格式
本指南中的数据请求成功时返回{ data, meta }，失败时返回 { error: { code, message } }。列表接口的 data 是数组，单个资源是对象；各接口的数据结构见 API 参考。套餐与数据权限
调用限制与可访问的数据。价格按月付费计。
免费版
每天 200 次调用 · 每次 500 行
13F、Form 4、国会议员交易、加密货币 ETF、股票与财务数据；未交割（FTD）与 Reg SHO 阈值名单；N-PORT 基金持仓、Form 144、高管薪酬。仅含最近一个季度和最新数据。
Pro 版 $29/月
每天 20,000 次调用 · 每次 5,000 行
包含免费版的全部内容，另加：完整历史；宏观：美国国债、美联储、BLS、CFTC、FDIC、EIA 和 OFR；13D / 13G、Form D 和 8-K 回购数据集；PDF 持仓报告（机构 13F）；SEC 申报文件正文。
团队版 $99/月
每天 200,000 次调用 · 每次 50,000 行
包含 Pro 版的全部内容，另加：批量导出 CSV / JSON。