Quickstart
Your first call in under 5 minutes
Source-traced SEC & market data over REST and MCP. Try it keyless with?demo=true, then grab a free key for higher limits.
1curl
The fastest check -- a real response, no signup.
TerminalFree - no key needed
curl "https://api.ko.io/api/v1/stocks/AAPL?demo=true"Terminal (your key)With your API key
curl -H "Authorization: Bearer ko_live_YOUR_KEY" \
"https://api.ko.io/api/v1/stocks/AAPL"2MCP (Claude, Cursor, any agent)
Connect the MCP server so your agent can pull data directly.
Add the MCP serverFree - no key needed
claude mcp add ko-sec-data --transport http https://mcp.ko.io/mcpWith your key (your plan + limits)With your API key
claude mcp add ko-sec-data --transport http "https://mcp.ko.io/mcp?api_key=ko_live_YOUR_KEY"3Python
Three lines with requests.
pythonFree - no key needed
import requests
r = requests.get("https://api.ko.io/api/v1/stocks/AAPL", params={"demo": "true"})
print(r.json()["data"])python (your key)With your API key
import requests
headers = {"Authorization": "Bearer ko_live_YOUR_KEY"}
r = requests.get("https://api.ko.io/api/v1/institutions/1067983", headers=headers)
print(r.json()["data"]) # Berkshire Hathaway 13F holdingsWhat needs a paid plan?
- Free -- core SEC data (13F, insiders, Congress, crypto, stocks), 200 calls/day, 500 rows.
- Pro $29/mo -- + macro (Treasury/Fed/economic), short-interest, full history, EDGAR source filings; 20,000 calls/day, 5,000 rows.
- Team $99/mo -- + bulk CSV/JSON export; 50,000 rows.
Full endpoint list with plan gates: API Reference · Pricing