KoboTerminalNGX API DocsGet a free API key

Market status

Is the NGX open right now? Weekend and Nigerian public-holiday aware.

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

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

Use this before polling. NGX trades 10:00 to 14:30 WAT on weekdays, and the calendar includes Nigerian public holidays (for example Eid, Democracy Day, Christmas).

Request

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

r = requests.get(
    "https://koboterminal.com/api/ngxdata/market-status",
    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-status", {
  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": {
    "status": "Closed",
    "raw_status": "AFTER_HOURS",
    "is_open": false,
    "holiday": null,
    "source": "mansaapi-calendar"
  }
}

Fields

FieldTypeDescription
data.is_openbooleanTrue while the market is in session
data.statusstringOpen, Pre-Open, Closed, or "Closed — <holiday name>"
data.holidaystring|nullHoliday name when closed for a holiday

Use it from an AI assistant

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

Errors

Standard errors apply: see Rate limits and errors.