Reference
Markets
Query African exchanges, tickers, historical market data, and FX rates from Africa API.
List Exchanges
GET
/v1/markets/exchangesReturns exchange records with ticker counts and latest trade dates.
country_codestringFilter to one country
limitintegerMaximum rows to return (1-500)
curl "https://api.africa-api.com/v1/markets/exchanges" \
-G \
-d "country_code=ng" \
-H "Authorization: Bearer $AFRICA_API_KEY"{
"data": [
{
"code": "NGX",
"name": "Nigerian Exchange",
"country_code": "ng",
"currency": "NGN",
"timezone": "Africa/Lagos",
"primary_index_name": "NGX All-Share Index",
"ticker_count": 189,
"latest_trade_date": "2026-03-06"
}
]
}List Tickers
GET
/v1/markets/tickersReturns exchange-backed instruments.
exchange_codestringFilter to one exchange, such as
NGX or JSEcountry_codestringFilter to one country
instrument_typestringFilter by type such as
EQUITY, INDEX, BOND, or ETPqstringSearch by symbol or security name
limitintegerMaximum rows to return (1-500)
curl "https://api.africa-api.com/v1/markets/tickers" \
-G \
-d "exchange_code=JSE" \
-d "instrument_type=EQUITY" \
-d "limit=2" \
-H "Authorization: Bearer $AFRICA_API_KEY"{
"data": [
{
"exchange_code": "JSE",
"symbol": "AGL",
"security_name": "Anglo American plc",
"instrument_type": "EQUITY",
"sector": "Basic Materials",
"industry": "Metals & Mining",
"country_code": "za",
"latest_trade_date": "2026-03-06",
"latest_close_price": 512.35,
"latest_change_percent": 1.27
}
]
}Get Ticker Detail
GET
/v1/markets/tickers/{exchange_code}/{symbol}curl "https://api.africa-api.com/v1/markets/tickers/NGX/MTNN" \
-H "Authorization: Bearer $AFRICA_API_KEY"Get Ticker History
GET
/v1/markets/tickers/{exchange_code}/{symbol}/historycurl "https://api.africa-api.com/v1/markets/tickers/NGX/MTNN/history" \
-G \
-d "start_date=2026-02-01" \
-d "end_date=2026-03-06" \
-H "Authorization: Bearer $AFRICA_API_KEY"List Latest FX Rates
GET
/v1/markets/fx-ratesReturns the latest known FX rates for the requested base currency.
base_currencystringBase currency, default
USDquote_currenciesstringComma-separated quote currencies
country_codestringFilter by associated country
limitintegerMaximum rows to return (1-500)
curl "https://api.africa-api.com/v1/markets/fx-rates" \
-G \
-d "base_currency=USD" \
-d "quote_currencies=NGN,ZAR,KES" \
-H "Authorization: Bearer $AFRICA_API_KEY"{
"data": [
{
"source_code": "fx_usd_daily",
"base_currency": "USD",
"quote_currency": "NGN",
"country_codes": ["ng"],
"rate_date": "2026-03-07",
"rate": 1538.12,
"created_at": "2026-03-07T01:05:00Z"
}
]
}Get FX History
GET
/v1/markets/fx-rates/{base_currency}/{quote_currency}/historycurl "https://api.africa-api.com/v1/markets/fx-rates/USD/NGN/history" \
-G \
-d "start_date=2026-02-01" \
-d "end_date=2026-03-07" \
-H "Authorization: Bearer $AFRICA_API_KEY"