Quickstart
Get a key, make a request, chart a stock. Under two minutes.
1. Get a free key
Go to https://koboterminal.com/api#get-key, enter your name and email, and choose Personal / Learning. Your key is issued straight away (you may be asked to confirm your email first) and looks like kobo_xxxxxxxxxxxxxxxx. Older keys from our NGX Pulse days start with ngxpulse_ and keep working.
Store it in an environment variable:
bash
export KOBO_API_KEY="kobo_your_key_here"2. Fetch every NGX stock
bash
curl "https://koboterminal.com/api/ngxdata/stocks" -H "X-API-Key: $KOBO_API_KEY"You get the full NGX daily price list: about 150 stocks with price, change, volume, value and market cap.
3. Get a price history and chart it (Python)
python
import os, requests
import matplotlib.pyplot as plt
r = requests.get(
"https://koboterminal.com/api/ngxdata/prices/GTCO",
params={"from": "2025-01-01"}, # Starter plan: full history back to 2000
headers={"X-API-Key": os.environ["KOBO_API_KEY"]},
timeout=30,
)
r.raise_for_status()
rows = r.json()["prices"] # oldest first
plt.plot([x["trade_date"] for x in rows], [x["close_price"] for x in rows])
plt.title("GTCO close, NGN")
plt.show()Free keys can request the last 7 days (?days=7). Longer ranges need Starter.
4. JavaScript / Node.js
javascript
const res = await fetch("https://koboterminal.com/api/ngxdata/market", {
headers: { "X-API-Key": process.env.KOBO_API_KEY },
});
const { data } = await res.json();
console.log(`ASI ${data.asi} (${data.pct_change}%)`);5. Check your usage
bash
curl "https://koboterminal.com/api/keys/info" -H "X-API-Key: $KOBO_API_KEY"Next steps
- Browse all endpoints
- Let your AI assistant call the API: MCP server or agent skill
- See Rate limits and errors