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",
    "company_name": "Dangote Cement Plc",
    "format": "detailed",
    "period": "30d",
    "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": {
      "first_price": 295,
      "last_price": 302.5,
      "min_price": 295,
      "max_price": 302.5,
      "price_change": 7.5,
      "price_change_percent": 2.54,
      "start_date": "2026-04-10",
      "end_date": "2026-04-21"
    }
  },
  "meta": {
    "plan": "starter",
    "calls_used": 4822,
    "calls_remaining": 95178,
    "reset_at": "2026-05-01T00:00:00.000Z"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.ngnmarket.com/llms.txt

Use this file to discover all available pages before exploring further.

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): 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