KoboTerminalNGX API DocsGet a free API key

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