Skip to main content
GET
Historical price series
The chart endpoint returns daily price history for a company, going back as far as records exist for that symbol. Each data point includes a timestamp and date, plus close price. Where available, it also includes the full OHLCV fields, VWAP (volume-weighted average price), trade count, and daily change. Use from and to (YYYY-MM-DD) to narrow results to a specific date range, or use the period parameter to request a named time window (7d, 30d, 90d, 1y, 5y, all). Three format options let you pick the shape that fits your charting library:
  • detailed (default) — full objects per day. Includes price as an alias for close for backward compatibility, plus open, high, low, close, volume, value_traded, vwap, trade_count, change, change_percent.
  • chart — compact [timestamp, close] arrays. Backward-compatible with the previous API behaviour, suited for line charts.
  • ohlcv — compact [timestamp, open, high, low, close, volume] arrays. Pass this directly to TradingView Lightweight Charts, ApexCharts, or Highcharts candlestick series.
close is the only field guaranteed to be present on every data point. Depending on the company and date, open, high, low, volume, value_traded, vwap, trade_count, change, and change_percent may come back as null.This means no intraday range data is available for that specific day. It does not mean the day itself is missing or that the value is zero. This applies in both detailed (named fields) and ohlcv (positional array, where a null appears in place of the missing element) formats.When rendering a candlestick chart, check for null before drawing the candle body and fall back to a marker or line segment on the close price for those points. See the candlestick chart guide to understand better.
A statistics block summarises the full range — first/last price, min, max, and total change — so you can render a summary card without extra computation. For example, to fetch one year of DANGCEM data in candlestick format:

Build a candlestick chart

Step-by-step guide showing how to fetch OHLCV data and render it as an interactive candlestick chart with TradingView Lightweight Charts. Includes a live demo, vanilla JS, and a React component.

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

NGX ticker symbol (e.g. DANGCEM). Case-insensitive.

Example:

"DANGCEM"

Query Parameters

period
enum<string>

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"

to
string<date>

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

Example:

"2026-04-17"

format
enum<string>
default:detailed

Response shape for data points.

  • detailed (default): full objects with OHLCV, VWAP, and change fields. Includes price as an alias for close for backward compatibility.
  • chart: compact [timestamp, close] arrays — backward-compatible line chart format.
  • ohlcv: compact [timestamp, open, high, low, close, volume] arrays — use this for candlestick charts.
Available options:
detailed,
chart,
ohlcv

Response

Price chart data retrieved successfully.

success
boolean
required
meta
object

Quota and plan metadata included on every authenticated response.

data
object