Dividend History - NGN Market API

Dividend history

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

{
  "success": true,
  "data": {
    "symbol": "DANGCEM",
    "dividends": [
      {
        "ex_dividend_date": "2024-05-20",
        "dividend": 20,
        "type": "Cash",
        "payment_date": "2024-06-14",
        "yield": 5.2
      },
      {
        "ex_dividend_date": "2023-05-15",
        "dividend": 16,
        "type": "Cash",
        "payment_date": "2023-06-09",
        "yield": 4.8
      }
    ],
    "count": 2
  },
  "meta": {
    "plan": "starter",
    "calls_used": 42,
    "calls_remaining": 99958,
    "reset_at": "2026-06-01T00:00:00.000Z"
  }
}

GET

companies

{symbol}

dividends

Dividend history

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

{
  "success": true,
  "data": {
    "symbol": "DANGCEM",
    "dividends": [
      {
        "ex_dividend_date": "2024-05-20",
        "dividend": 20,
        "type": "Cash",
        "payment_date": "2024-06-14",
        "yield": 5.2
      },
      {
        "ex_dividend_date": "2023-05-15",
        "dividend": 16,
        "type": "Cash",
        "payment_date": "2023-06-09",
        "yield": 4.8
      }
    ],
    "count": 2
  },
  "meta": {
    "plan": "starter",
    "calls_used": 42,
    "calls_remaining": 99958,
    "reset_at": "2026-06-01T00:00:00.000Z"
  }
}

This endpoint returns the complete dividend history for an NGX-listed company, ordered from most recent to oldest. Each record includes the ex-dividend date, dividend amount (in NGN per share), dividend type, payment date, and trailing yield at time of declaration. Use from and to to filter by date range, or limit to cap the number of records returned (max 100). Omitting all parameters returns the full history. For example, to fetch DANGCEM’s last 10 dividends:

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

To fetch all dividends declared between two dates:

curl "https://api.ngnmarket.com/v1/companies/ZENITHBANK/dividends?from=2020-01-01&to=2024-12-31" \
  -H "Authorization: Bearer ngm_live_YOUR_KEY"

If a company has no dividend history on record, dividends will be an empty array and count 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.

Path Parameters

symbol

string

required

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

Example:

"DANGCEM"

Query Parameters

from

string<date>

Return dividends with an ex-dividend date on or after this date (YYYY-MM-DD).

Example:

"2020-01-01"

string<date>

Return dividends with an ex-dividend date on or before this date (YYYY-MM-DD).

Example:

"2024-12-31"

limit

integer

Maximum number of records to return (1–100). Omit to return all available records.

Required range: 1 <= x <= 100

Example:

10

Response

Dividend history retrieved successfully.

success

boolean

required