Skip to main content
GET
Financial ratios
This endpoint returns just the computed financial ratios for every reporting period available, ordered from most recent to oldest. It’s the same data you’d find under ratios in the combined financials endpoint, returned on its own so you’re not paying for the income statement, balance sheet, and cash flow sections when you only need margins, returns, and per-share figures. Some ratios (gross margin, operating margin, net profit margin, return on equity, return on assets) are stored directly from the filed statements. The rest (current ratio, debt to equity, interest coverage, free cash flow margin, book value per share, free cash flow per share, revenue per share) are computed at request time from the underlying statements. A ratio comes back as null when one of its inputs isn’t available for that period. Use periodType (annual or quarterly) to filter by statement type, year to limit results to a specific fiscal year, and limit to control the maximum number of records returned. This endpoint requires a Starter plan or higher. Depth depends on plan. Starter gets the most recent annual period only, essentially the current year. Pro extends that to the last 3 years, annual only. On both of these tiers, periodType and year are ignored since the response is already capped to a fixed, recent window. Business and Enterprise get the full history, both annual and quarterly, with periodType and year fully respected. For example, to fetch GTCO’s quarterly ratios for 2025:

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:

"DANGCEM"

Query Parameters

periodType
enum<string>

Filter by reporting period type.

Available options:
annual,
quarterly
year
integer

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

Example:

2025

limit
integer
default:10

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

Required range: 1 <= x <= 100

Response

Financial ratios retrieved successfully.

success
boolean
required
meta
object

Quota and plan metadata included on every authenticated response.

data
object