# Price history (OHLCV)

> Daily open, high, low, close and volume for one NGX stock, from May 2000 to today.

```http
GET https://koboterminal.com/api/ngxdata/prices/{symbol}
```

**Plan:** Free and above (free key, no card). Free keys get the last 7 days. Starter and above get the full daily history back to May 2000.

Daily OHLCV bars for a single stock. Use `days` for the most recent N sessions, or `from`/`to` for a date range. Rows come back oldest first, ready to chart. This is one of the deepest NGX histories available anywhere: more than 25 years for the older listings.

## Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `symbol` | path | string | yes | NGX ticker (e.g. `DANGCEM`) |
| `days` | query | integer | no | Most recent N trading days (e.g. `30`) |
| `from` | query | string | no | Start date, YYYY-MM-DD (e.g. `2020-01-01`) |
| `to` | query | string | no | End date, YYYY-MM-DD (e.g. `2026-11-18`) |

## Request

```bash
curl "https://koboterminal.com/api/ngxdata/prices/GTCO?days=2" \
  -H "X-API-Key: $KOBO_API_KEY"
```

```python
import os, requests

r = requests.get(
    "https://koboterminal.com/api/ngxdata/prices/GTCO",
    params={"days": "2"},
    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/prices/GTCO?days=2", {
  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,
  "symbol": "GTCO",
  "prices": [
    {
      "symbol": "GTCO",
      "trade_date": "2026-11-17",
      "open_price": 117.8,
      "high_price": 118,
      "low_price": 117,
      "close_price": 117,
      "volume": 9701642
    },
    {
      "symbol": "GTCO",
      "trade_date": "2026-11-18",
      "open_price": 117,
      "high_price": 117,
      "low_price": 115.8,
      "close_price": 116,
      "volume": 19238323
    }
  ],
  "count": 2
}
```

## Fields

| Field | Type | Description |
|---|---|---|
| `prices[].trade_date` | string | Session date, YYYY-MM-DD |
| `prices[].open_price / high_price / low_price / close_price` | number | NGN |
| `prices[].volume` | integer | Shares traded |
| `count` | integer | Number of rows returned |

## Use it from an AI assistant

This endpoint is available as the `get_price_history` 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).
