# 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

| Field | Type | Description |
|---|---|---|
| `data.is_open` | boolean | True while the market is in session |
| `data.status` | string | Open, Pre-Open, Closed, or "Closed — <holiday name>" |
| `data.holiday` | string|null | Holiday 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](https://koboterminal.com/docs/mcp).

## Errors

Standard errors apply: see [Rate limits and errors](https://koboterminal.com/docs/errors).
