Skip to main content
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 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:
To compare each quarter against the one right before it instead of the same quarter last year:

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. GTCO). Case-insensitive.

Example:

"NESTLE"

Query Parameters

periodType
enum<string>

Restrict to one reporting cadence. Omit to get both annual and quarterly periods together.

Available options:
annual,
quarterly
year
integer

Filter by calendar year (e.g. 2025).

Example:

2025

compare
enum<string>
default:yoy

Comparison basis for the growth calculation.

Available options:
yoy,
sequential
limit
integer

Maximum number of periods to return (1–100).

Required range: 1 <= x <= 100

Response

Growth metrics retrieved successfully.

success
boolean
required
meta
object

Quota and plan metadata included on every authenticated response.

data
object