Use Cases
African Market Data API
Access African exchanges, tickers, historical market data, and FX rates with Africa API.
Use Africa API market routes when your application needs exchange metadata, ticker coverage, historical prices, or FX rates tied to African markets.
This is the best fit for:
- market dashboards
- watchlists and portfolio tools
- exchange lookup tools
- FX monitoring
- country products that need market context alongside broader economic data
Market coverage is currently narrower than the broader country and indicator surfaces. Use this page to understand the main routes, then check the reference docs for current coverage details.
Start With These Endpoints
List exchanges
Use /v1/markets/exchanges for exchange metadata and latest trade dates.
Browse tickers
Use /v1/markets/tickers to list exchange instruments.
Ticker detail
Use /v1/markets/tickers/{exchange_code}/{ticker_symbol} for one instrument.
FX rates
Use /v1/markets/fx-rates for currency pairs and related history routes.
Example: List Exchanges
curl "https://api.africa-api.com/v1/markets/exchanges" \
-G \
-d "country_code=ng" \
-H "Authorization: Bearer $AFRICA_API_KEY"This is a good entry point when you need to understand which exchanges and countries are currently covered.
Example: Browse Tickers
curl "https://api.africa-api.com/v1/markets/tickers" \
-G \
-d "exchange_code=NGX" \
-d "limit=20" \
-H "Authorization: Bearer $AFRICA_API_KEY"Use this when you need ticker search, watchlist setup, or exchange-specific instrument lists.
Example: Get Historical Prices For One Ticker
curl "https://api.africa-api.com/v1/markets/tickers/NGX/MTNN/history" \
-G \
-d "start_date=2025-01-01" \
-d "end_date=2025-12-31" \
-H "Authorization: Bearer $AFRICA_API_KEY"This is the route to use for charting and historical price analysis.
Example: Query FX Rates
curl "https://api.africa-api.com/v1/markets/fx-rates" \
-G \
-d "base_currency=USD" \
-d "quote_currency=NGN" \
-H "Authorization: Bearer $AFRICA_API_KEY"Use FX routes when your application needs currency conversion context or exchange-rate history for African markets.
Coverage Notes
Current reference coverage includes:
- exchange metadata and tickers for supported African exchanges
- historical price data for supported instruments
- FX coverage including broad USD-based daily rates
- official BCEAO-published XOF rates for WAEMU-related workflows
Use the market reference docs for the most current coverage details and supported parameters.
Related Docs
Markets reference
Full route reference for exchanges, tickers, history, and FX rates.
Countries API
Combine market data with country records and country snapshots.
Signals reference
Add compact market context to country-level operational views.
Trade API
Pair market data with trade context for broader country analysis.