Quickstart · 5 minutes

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.

Step 1: curl

~1 min

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"

2
Step 2: MCP (Claude, Cursor, any agent)
~2 min
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"
```

Step 3: Python

~2 min

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

Responses are enveloped

Every response is { data, meta } on success and { error } on failure. data is an array for lists and an object for single resources.

What needs a paid plan?

Daily call limit and maximum rows per response.

Plan	Calls / day	Rows	Includes
Free	200	500	Core SEC data: 13F, insiders, Congress, crypto, stocks
Pro $29/mo	20,000	5,000	+ macro (Treasury/Fed/economic), short interest, full history, EDGAR source filings
Team $99/mo	—	50,000	+ bulk CSV/JSON export

Full endpoint list with plan gates: API ReferenceCompare plans: Pricing

Step 1: curl

Step 2: MCP (Claude, Cursor, any agent)

Step 3: Python

What needs a paid plan?