Company News - NGN Market API

Company news by ticker symbol

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

{
  "success": true,
  "data": {
    "company": "Dangote Cement Plc",
    "data": [
      {
        "title": "Dangote Cement reports record Q1 revenue amid price hike",
        "link": "https://businessday.ng/markets/article/dangote-cement-q1-revenue",
        "source": "BusinessDay",
        "pub_date": "Thu, 17 Apr 2026 10:30:00 GMT",
        "days_old": 4,
        "time_ago": "4 days ago",
        "guid": "https://businessday.ng/markets/article/dangote-cement-q1-revenue"
      }
    ],
    "total": 1
  },
  "meta": {
    "plan": "starter",
    "calls_used": 4823,
    "calls_remaining": 95177,
    "reset_at": "2026-05-01T00:00:00.000Z"
  }
}

GET

companies

{symbol}

news

Company news by ticker symbol

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

{
  "success": true,
  "data": {
    "company": "Dangote Cement Plc",
    "data": [
      {
        "title": "Dangote Cement reports record Q1 revenue amid price hike",
        "link": "https://businessday.ng/markets/article/dangote-cement-q1-revenue",
        "source": "BusinessDay",
        "pub_date": "Thu, 17 Apr 2026 10:30:00 GMT",
        "days_old": 4,
        "time_ago": "4 days ago",
        "guid": "https://businessday.ng/markets/article/dangote-cement-q1-revenue"
      }
    ],
    "total": 1
  },
  "meta": {
    "plan": "starter",
    "calls_used": 4823,
    "calls_remaining": 95177,
    "reset_at": "2026-05-01T00:00:00.000Z"
  }
}

This endpoint returns recent news articles for a specific NGX-listed company, identified by its NGX ticker symbol. Articles are sourced in real time from Nigerian financial news outlets. Use limit to control how many articles are returned (default 5, max 10), and maxAge to set the maximum article age in days (default 90). Each article includes pub_date, days_old, and time_ago fields for convenient age display. News is fetched live on each request, so response times may be slightly higher than data endpoints. For example, to fetch the 10 most recent DANGCEM articles from the last 30 days:

curl "https://api.ngnmarket.com/v1/companies/DANGCEM/news?limit=10&maxAge=30" \
  -H "Authorization: Bearer ngm_live_YOUR_KEY"

If no articles are found within the configured age window, the data array is empty. 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

limit

integer

default:10

Maximum number of articles to return (1–50). Defaults to 10.

Required range: 1 <= x <= 50

maxAge

integer

default:90

Maximum age of articles in days (1–365). Defaults to 90.

Required range: 1 <= x <= 365

Response

News articles retrieved successfully.

success

boolean

required