KoboTerminalNGX API DocsGet a free API key

Market summary

NGX All-Share Index level and daily change, market capitalisation, volume, value, deals and breadth (advancers, decliners, unchanged).

http
GET https://koboterminal.com/api/ngxdata/market

Plan: Free and above (free key, no card).

The headline numbers for the Nigerian stock market today. The ASI change is the real market-cap-weighted index move from the NGX snapshot, not an average of stock moves. Every response carries as_of and stale_after so you know exactly how fresh it is.

Request

bash
curl "https://koboterminal.com/api/ngxdata/market" \
  -H "X-API-Key: $KOBO_API_KEY"
python
import os, requests

r = requests.get(
    "https://koboterminal.com/api/ngxdata/market",
    headers={"X-API-Key": os.environ["KOBO_API_KEY"]},
    timeout=30,
)
r.raise_for_status()
data = r.json()
javascript
const res = await fetch("https://koboterminal.com/api/ngxdata/market", {
  headers: { "X-API-Key": process.env.KOBO_API_KEY },
});
if (!res.ok) throw new Error(`Kobo API ${res.status}`);
const data = await res.json();

Response

Real response from the live API on 18 November 2026, trimmed to the first item of each list:

json
{
  "success": true,
  "data": {
    "asi": 248329.65,
    "pct_change": -0.4,
    "volume": 451141250,
    "deals": 32572,
    "value": 26608704718.61,
    "market_cap": 161238118228226.2,
    "advancers": 30,
    "decliners": 33,
    "unchanged": 83,
    "trade_date": "2026-11-18T00:00:00",
    "updated_at": "2026-11-18T22:38:18.439Z",
    "as_of": "2026-11-18T22:38:18.439Z",
    "stale_after": "2026-11-19T08:00:00.000Z",
    "market_status": "closed",
    "market_status_source": "mansaapi-calendar",
    "source": "NGX"
  }
}

Fields

FieldTypeDescription
data.asinumberNGX All-Share Index level
data.pct_changenumberASI change today, percent
data.market_capnumberTotal equity market capitalisation, NGN
data.volume / value / dealsnumberShares traded, naira value traded and number of deals today
data.advancers / decliners / unchangedintegerMarket breadth
data.as_of / stale_afterISO 8601When the numbers were fetched and when to treat them as stale
data.market_statusstringopen, closed or pre_market

Use it from an AI assistant

This endpoint is available as the get_market_summary tool on the Kobo Terminal MCP server (https://koboterminal.com/mcp). See MCP server.

Errors

Standard errors apply: see Rate limits and errors.