africaAPI

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

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.

On this page