# 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

| Field | Type | Description |
|---|---|---|
| `data.asi` | number | NGX All-Share Index level |
| `data.pct_change` | number | ASI change today, percent |
| `data.market_cap` | number | Total equity market capitalisation, NGN |
| `data.volume / value / deals` | number | Shares traded, naira value traded and number of deals today |
| `data.advancers / decliners / unchanged` | integer | Market breadth |
| `data.as_of / stale_after` | ISO 8601 | When the numbers were fetched and when to treat them as stale |
| `data.market_status` | string | open, 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](https://koboterminal.com/docs/mcp).

## Errors

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