Financial statement growth
Company Endpoints
Financial Statement Growth
Year-over-year growth rates for income statement, cash flow, and balance sheet line items.
GET
Financial statement growth
This endpoint returns period-over-period growth rates for revenue, profit, cash flow, and balance sheet line items, for every reporting period available.
By default, growth is computed year-over-year against the same period label, FY 2025 vs FY 2024, Q2 2025 vs Q2 2024, not sequentially. Sequential quarter-over-quarter comparison is noisy for seasonal businesses, so year-over-year is the safer default. Pass
To compare each quarter against the one right before it instead of the same quarter last year:
compare=sequential if you specifically want each period compared against the one immediately before it instead.
A growth rate comes back as null rather than a number in two situations: when there’s no comparable prior period (the oldest period on file has nothing to compare against), and when the prior period’s value was negative or zero. “Percent growth” from a loss or from zero isn’t a meaningful figure, a company swinging from a ₦164B loss to a ₦105B profit isn’t “growing 164%”, so we don’t pretend it is. The one exception is dividends_paid_growth, which is compared by magnitude rather than signed value, since dividends_paid is stored as a negative outflow by accounting convention, not because a company is in distress.
Use periodType (annual or quarterly) to restrict to one reporting cadence, omit it to get both together. year filters to a specific fiscal year, and limit caps the number of records returned. This endpoint requires a Pro plan or higher.
Depth depends on plan. Pro gets the last 3 years, annual only, periodType and year are ignored at this tier. Business and Enterprise get the full history, both annual and quarterly. Note that compare=sequential is only meaningfully different from the year-over-year default once quarterly data is available, comparing one annual period to the one right before it lands on the same result as comparing it to the same period last year, so this parameter mostly matters once you’re on Business.
For example, to fetch the last 3 years of annual growth for Nestlé Nigeria:
Authorizations
Pass your API key as a Bearer token: Authorization: Bearer ngm_live_YOUR_KEY.
Generate keys at ngnmarket.com/dashboard/developer.
Path Parameters
NGX ticker symbol (e.g. GTCO). Case-insensitive.
Example:
"NESTLE"
Query Parameters
Restrict to one reporting cadence. Omit to get both annual and quarterly periods together.
Available options:
annual, quarterly Filter by calendar year (e.g. 2025).
Example:
2025
Comparison basis for the growth calculation.
Available options:
yoy, sequential Maximum number of periods to return (1–100).
Required range:
1 <= x <= 100