Upcoming Dividends - NGN Market API

Upcoming dividends

curl --request GET \
  --url https://api.ngnmarket.com/v1/dividends/upcoming \
  --header 'Authorization: Bearer <token>'

{
  "success": true,
  "data": {
    "dividends": [
      {
        "symbol": "DANGCEM",
        "company_name": "Dangote Cement Plc",
        "sector": "Industrial Goods",
        "ex_dividend_date": "2026-06-17",
        "dividend": 45,
        "type": "Cash",
        "payment_date": "2026-07-01",
        "yield": 4.14
      },
      {
        "symbol": "GTCO",
        "company_name": "Guaranty Trust Holding Company Plc",
        "sector": "Financial Services",
        "ex_dividend_date": "2026-06-24",
        "dividend": 3,
        "type": "Cash",
        "payment_date": "2026-07-08",
        "yield": 5.3
      }
    ],
    "page": 1,
    "total": 38,
    "total_pages": 2
  },
  "meta": {
    "plan": "starter",
    "calls_used": 15,
    "calls_remaining": 99985,
    "reset_at": "2026-06-01T00:00:00.000Z"
  }
}

GET

dividends

upcoming

Upcoming dividends

curl --request GET \
  --url https://api.ngnmarket.com/v1/dividends/upcoming \
  --header 'Authorization: Bearer <token>'

{
  "success": true,
  "data": {
    "dividends": [
      {
        "symbol": "DANGCEM",
        "company_name": "Dangote Cement Plc",
        "sector": "Industrial Goods",
        "ex_dividend_date": "2026-06-17",
        "dividend": 45,
        "type": "Cash",
        "payment_date": "2026-07-01",
        "yield": 4.14
      },
      {
        "symbol": "GTCO",
        "company_name": "Guaranty Trust Holding Company Plc",
        "sector": "Financial Services",
        "ex_dividend_date": "2026-06-24",
        "dividend": 3,
        "type": "Cash",
        "payment_date": "2026-07-08",
        "yield": 5.3
      }
    ],
    "page": 1,
    "total": 38,
    "total_pages": 2
  },
  "meta": {
    "plan": "starter",
    "calls_used": 15,
    "calls_remaining": 99985,
    "reset_at": "2026-06-01T00:00:00.000Z"
  }
}

This endpoint returns a paginated list of NGX-listed companies whose ex-dividend date falls on or after today, ordered chronologically by ex-dividend date. Use it to build a dividend calendar, screen for near-term income opportunities, or alert users before key dates. Use page and limit for pagination (up to 100 records per page). For example, to fetch the first page of upcoming dividends:

curl "https://api.ngnmarket.com/v1/dividends/upcoming?limit=20&page=1" \
  -H "Authorization: Bearer ngm_live_YOUR_KEY"

If no upcoming dividends are scheduled, dividends will be an empty array and total will be 0. 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.

Query Parameters

page

integer

default:1

Page number (1-based).

Required range: x >= 1

limit

integer

default:20

Records per page (1–100).

Required range: 1 <= x <= 100

Response

Upcoming dividends retrieved successfully.

success

boolean

required