Skip to main content
GET
/
v1
/
companies
/
{symbol}
/
chart
Historical price series
curl --request GET \
  --url https://api.ngnmarket.com/v1/companies/{symbol}/chart \
  --header 'Authorization: Bearer <token>'
{ "success": true, "data": { "symbol": "DANGCEM", "companyName": "Dangote Cement Plc", "format": "detailed", "count": 3, "data": [ { "timestamp": "1744243200000", "date": "2026-04-10", "price": 295, "source": "historical" }, { "timestamp": "1744502400000", "date": "2026-04-13", "price": 300, "source": "historical" }, { "timestamp": "1745241000000", "date": "2026-04-21", "price": 302.5, "source": "current" } ], "statistics": { "firstPrice": 295, "lastPrice": 302.5, "minPrice": 295, "maxPrice": 302.5, "priceChange": 7.5, "priceChangePercent": 2.54, "startDate": "2026-04-10", "endDate": "2026-04-21" } }, "meta": { "plan": "starter", "calls_used": 4822, "calls_remaining": 95178, "reset_at": "2026-05-01T00:00:00.000Z" } }
The chart endpoint returns the complete price history for a company from its earliest available data point up to the most recent session. Each data point includes a Unix timestamp, a calendar date, the closing price, and a source flag indicating whether the point is historical or from the current session’s live price. You can choose between a detailed object format or a compact two-element array format suited for charting libraries. A statistics block summarises the full range so you can display min, max, and total change without extra computation. This endpoint requires a Starter plan or higher.

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

​
format
enum<string>
default:detailed

Response shape for data points.

  • detailed (default) — objects with timestamp, date, price, source.
  • chart — compact [timestamp, price] arrays.
Available options:
detailed,
chart

Response

Price chart data retrieved successfully.

​
success
boolean
required
​
meta
object

Quota and plan metadata included on every authenticated response.

​
data
object