v1 REST API & Model Context Protocol

The Data API for the Nigerian Exchange

Audited company fundamentals, regulatory filing indexes, and macroeconomic indicators. Every figure carries its original PDF source citation, arithmetic verification check, and normalized naira value.

Get Developer API Key Download OpenAPI Spec API Status

Arithmetic Audit Checks

Figures are verified against statement math (`checks = "ok"`). Unchecked or failed lines are never passed off as authoritative.

Complete Provenance

Every figure links directly to the filing PDF, page number, and original printed table row.

Unit Standardisation

Values are converted into standard naira alongside the original unit, preventing kobo vs naira scale errors.

Agent-Native (MCP)

Connect Claude Desktop, Cursor, or AI frameworks directly over stdio via the Model Context Protocol.

Quickstart Integration

Pass your secret token in the `Authorization: Bearer` header.

# 1. Get audited income statement for GTCO
curl -H "Authorization: Bearer tk_live_YOUR_KEY" \
  "https://tickerng.com/api/v1/companies/GTCO/financials?statement=income"

# 2. Screen for banking stocks with P/E < 10
curl -H "Authorization: Bearer tk_live_YOUR_KEY" \
  "https://tickerng.com/api/v1/screener?sector=FINANCIAL+SERVICES&pe_max=10"

Interactive Sandbox

Test Live Endpoints

Select an endpoint or customize the path below. Test against local or production data.

GET

Auth:

Response:

Click "Send Request" to test this endpoint

Endpoints Reference

Base URL: https://tickerng.com/api/v1

GET/api/v1/companiesList NGX Equities

Returns a paged directory of equities listed on the Nigerian Exchange with sector, board, and share counts.

Parameter	Type	Required	Description
q	string	No	Search by ticker symbol, alias, or company name
sector	string	No	Filter by exact NGX sector (e.g. 'FINANCIAL SERVICES')
limit	number	No	Number of records (1-200, default 50)
offset	number	No	Pagination offset (default 0)

GET/api/v1/companies/{symbol}Company Profile & Key Ratios

Returns issuer master data, latest valuation multiples (P/E, P/B, ROE), and data quality report.

Parameter	Type	Required	Description
symbol	string	Yes	Official NGX ticker symbol (e.g. 'GTCO', 'MTNN')

GET/api/v1/companies/{symbol}/financialsExtracted Financial Statements

Returns audited statement lines with arithmetic verification (`checks = 'ok'`), standardized naira conversion, and page provenance.

Parameter	Type	Required	Description
symbol	string	Yes	Official NGX ticker symbol
statement	string	No	Filter by 'income', 'balance', 'cashflow', or 'all'
period	string	No	Match specific period (e.g. '2025', 'Jun-2026')
scope	string	No	'group' (consolidated, default) or 'company' (standalone)
includeUnverified	boolean	No	Include lines that failed arithmetic checks (default false)

GET/api/v1/companies/{symbol}/filingsRegulatory Filings Directory

Historical filings index with document kind, fiscal year, page count, and direct links to official documents on NGX.

Parameter	Type	Required	Description
symbol	string	Yes	Official NGX ticker symbol
kind	string	No	Filter by 'annual', 'q1', 'q2', 'q3', 'half-year'
year	number	No	Filter by fiscal year (e.g. 2025)

GET/api/v1/screenerEquity Multi-Criteria Screener

Filter and sort Nigerian equities across precomputed valuation multiples and fundamentals.

Parameter	Type	Required	Description
sector	string	No	Filter by sector (supports multiple)
pe_min / pe_max	number	No	P/E ratio bounds
roe_min	number	No	Minimum Return on Equity (%)
dividendYield_min	number	No	Minimum Dividend Yield (%)
sort	string	No	Sort by 'marketCap', 'pe', 'roe', 'close', etc.
dir	string	No	'asc' or 'desc'

GET/api/v1/qualityExchange-Wide Quality Report

Reports coverage percentages, extracted vs unextracted filings, and common PDF parsing failure reasons.

GET/api/v1/macroMacro & Monetary Policy Indicators

Official Central Bank of Nigeria (CBN) policy rates (MPR), inflation metrics, and Treasury Bill auction stop rates.

Parameter	Type	Required	Description
series	string	No	Specific series ('usdNgn', 'mpr', 'inflationHeadline', 'bills')

Using the Model Context Protocol (MCP) Server

Connect external AI agents (Claude, Cursor, custom LangChain agents) directly to live NGX fundamentals.

# Run the local MCP server over stdio:

npx tsx scripts/mcp-server.ts

Provides agent tools: find_company, get_financials, and get_data_quality. Read the MCP Server Guide for desktop setup instructions.