NGX dividend history API: tracking Nigerian corporate actions programmatically
How to access ex-dividend dates, dividend-per-share amounts, and corporate action history for any NGX-listed stock via the Mansa API.
Tracking dividends and corporate actions for Nigerian stocks usually means scraping NGX announcements or paying for an expensive terminal. The Mansa API exposes dividend history for NGX-listed stocks as a clean REST endpoint — ex-dividend dates, record dates, payment dates, and dividend-per-share amounts.
The dividends endpoint
curl https://mansaapi.com/api/v1/markets/exchanges/NGX/dividends/GTCO \
-H "Authorization: Bearer YOUR_API_KEY"{
"success": true,
"symbol": "GTCO",
"count": 8,
"latest_ex_dividend_date": "2025-03-14",
"history": [
{
"ex_dividend_date": "2025-03-14",
"record_date": "2025-03-15",
"pay_date": "2025-04-01",
"dividend_per_share": 3.00,
"currency": "NGN"
}
]
}Using the Node.js SDK
import { MansaAPI } from "mansaapi";
const mansa = new MansaAPI({ apiKey: "mansa_live_sk_..." });
const dividends = await mansa.markets.getDividends("NGX", "GTCO");
console.log(dividends.latest_ex_dividend_date); // "2025-03-14"
for (const d of dividends.history) {
console.log(`${d.ex_dividend_date}: ₦${d.dividend_per_share}`);
}Computing dividend yield
Combine the dividend history with the live price endpoint to compute trailing yield:
const [quote, dividends] = await Promise.all([
mansa.markets.getStock("NGX", "GTCO"),
mansa.markets.getDividends("NGX", "GTCO"),
]);
const ttmDividend = dividends.history
.filter(d => new Date(d.ex_dividend_date) > oneYearAgo)
.reduce((sum, d) => sum + (d.dividend_per_share ?? 0), 0);
const yield = (ttmDividend / quote.data.price) * 100;
console.log(`Trailing yield: ${yield.toFixed(2)}%`);What you can build
Dividend calendars, income-portfolio trackers, yield screeners, and corporate-action alerts for Nigerian equities. The data justifies the Starter tier — it's the kind of structured corporate data that's otherwise locked behind expensive terminals.
See the full markets suite docs or the pricing page for tier details.