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/mcp
With 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 holdings

What 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