Index Chart - NGN Market API

Historical index values

curl --request GET \
  --url https://api.ngnmarket.com/v1/indices/{symbol}/chart \
  --header 'Authorization: Bearer <token>'

{
  "success": true,
  "data": {
    "symbol": "NGX30",
    "format": "detailed",
    "period": "30d",
    "count": 3,
    "statistics": {
      "start_date": "2026-04-15",
      "end_date": "2026-04-17",
      "start_value": 2819.3,
      "end_value": 2841.45,
      "change": 22.15,
      "change_percent": 0.79,
      "min_value": 2819.3,
      "max_value": 2841.45,
      "return_1m": 3.42,
      "return_3m": 8.17,
      "return_1y": 24.55,
      "return_ytd": 11.83
    },
    "data": [
      {
        "date": "2026-04-15",
        "timestamp": 1744675200000,
        "index_value": 2819.3,
        "normalized_value": 100,
        "daily_change": 0,
        "daily_change_percent": 0
      },
      {
        "date": "2026-04-16",
        "timestamp": 1744761600000,
        "index_value": 2829.88,
        "normalized_value": 100.38,
        "daily_change": 10.58,
        "daily_change_percent": 0.38
      },
      {
        "date": "2026-04-17",
        "timestamp": 1744848000000,
        "index_value": 2841.45,
        "normalized_value": 100.79,
        "daily_change": 11.57,
        "daily_change_percent": 0.41
      }
    ]
  },
  "meta": {
    "plan": "starter",
    "calls_used": 4823,
    "calls_remaining": 95177,
    "reset_at": "2026-05-01T00:00:00.000Z"
  }
}

GET

indices

{symbol}

chart

Historical index values

curl --request GET \
  --url https://api.ngnmarket.com/v1/indices/{symbol}/chart \
  --header 'Authorization: Bearer <token>'

{
  "success": true,
  "data": {
    "symbol": "NGX30",
    "format": "detailed",
    "period": "30d",
    "count": 3,
    "statistics": {
      "start_date": "2026-04-15",
      "end_date": "2026-04-17",
      "start_value": 2819.3,
      "end_value": 2841.45,
      "change": 22.15,
      "change_percent": 0.79,
      "min_value": 2819.3,
      "max_value": 2841.45,
      "return_1m": 3.42,
      "return_3m": 8.17,
      "return_1y": 24.55,
      "return_ytd": 11.83
    },
    "data": [
      {
        "date": "2026-04-15",
        "timestamp": 1744675200000,
        "index_value": 2819.3,
        "normalized_value": 100,
        "daily_change": 0,
        "daily_change_percent": 0
      },
      {
        "date": "2026-04-16",
        "timestamp": 1744761600000,
        "index_value": 2829.88,
        "normalized_value": 100.38,
        "daily_change": 10.58,
        "daily_change_percent": 0.38
      },
      {
        "date": "2026-04-17",
        "timestamp": 1744848000000,
        "index_value": 2841.45,
        "normalized_value": 100.79,
        "daily_change": 11.57,
        "daily_change_percent": 0.41
      }
    ]
  },
  "meta": {
    "plan": "starter",
    "calls_used": 4823,
    "calls_remaining": 95177,
    "reset_at": "2026-05-01T00:00:00.000Z"
  }
}

This endpoint returns a time series of daily closing values for a specific NGX market index. Narrow the result set with from and to date parameters, or use period (7d, 30d, 90d, 1y, 5y, all) to request a named time window. In detailed format, each data point includes a normalized_value field that rebases the index to 100 at the start of the requested period — useful for comparing two indices on the same scale in a single chart. The statistics block now also includes return_1m, return_3m, return_1y, and return_ytd — percentage returns versus fixed historical reference points, computed independently of the period you requested. Use format=chart for compact [timestamp, value] arrays suited for line charting libraries. For example, to fetch one year of NGX 30 closes in chart-ready format:

curl "https://api.ngnmarket.com/v1/indices/NGX30/chart?period=1y&format=chart" \
  -H "Authorization: Bearer ngm_live_YOUR_KEY"

Authorizations

Authorization

string

header

required

Pass your API key as a Bearer token: Authorization: Bearer ngm_live_YOUR_KEY. Generate keys at ngnmarket.com/dashboard/developer.

Path Parameters

symbol

string

required

Index symbol (e.g. NGX30). Case-insensitive.

Example:

"NGX30"

Query Parameters

period

enum<string>

default:30d

Preset lookback window. Ignored when from/to are supplied.

Available options:

7d,

30d,

90d,

1y,

5y,

all

from

string<date>

Start date in YYYY-MM-DD format (inclusive). Takes priority over period.

Example:

"2026-01-01"

string<date>

End date in YYYY-MM-DD format (inclusive). Use with from.

Example:

"2026-04-17"

format

enum<string>

default:detailed

Response shape. detailed returns objects; chart returns compact [timestamp, value] pairs.

Available options:

detailed,

chart

Response

Index chart data retrieved successfully.

success

boolean

required