# 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](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](https://koboterminal.com/docs/plans).

## 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](https://koboterminal.com/docs#endpoints)
- Let your AI assistant call the API: [MCP server](https://koboterminal.com/docs/mcp) or [agent skill](https://koboterminal.com/docs/agent-skill)
- See [Rate limits and errors](https://koboterminal.com/docs/errors)
