Economy

Economy In Africa API

Economic data is exposed through the shared indicator and data endpoints.

Use:

• GET /v1/indicators?category=economy
• GET /v1/data?category=economy
• GET /v1/countries/{country_code}/signals
• GET /v1/indicators/{metric_key}/rankings

Useful Metrics

• gdp_current_usd
• gdp_per_capita_usd
• inflation_cpi_pct
• inflation_cpi_latest_yoy_pct
• policy_rate_pct
• treasury_bill_91d_rate_pct
• overnight_interbank_rate_pct
• official_exchange_rate_latest_lcu_per_usd
• petrol_price_local_per_liter
• diesel_price_local_per_liter
• kerosene_price_local_per_liter
• maize_retail_price_local_per_kg
• maize_wholesale_price_local_per_kg
• foreign_reserves_import_cover_latest_months
• unemployment_pct
• unemployment_rate_latest_pct
• youth_unemployment_pct
• merchandise_exports_latest_usd_mn
• merchandise_imports_latest_usd_mn
• trade_balance_usd
• current_account_balance_pct_gdp

Use the *_latest_* metrics when you want fresher monthly operational signals rather than the historical annual backbone.

Where a country-specific central-bank source exists, Africa API can expose that current signal in the same product surface without changing the endpoint family.

If you also want benchmark commodity context for current macro conditions, use the commodity_benchmarks block returned by /v1/countries/{country_code}/signals.

Where official country sources publish current local prices, /signals can include those price points as location-tagged observations. Kenya fuel prices currently appear that way with location_name set to Nairobi, South Africa fuel prices now use the official DMRE Gauteng reference zone and carry fuel-grade and scope details in context, and Kenya maize prices use the World Bank Kenya market feed with location_name set to Market Average.

Example Query

curl "https://api.africa-api.com/v1/data?country_codes=ng,ke,za&metric_key=gdp_current_usd&year=2024" \
  -H "Authorization: Bearer $AFRICA_API_KEY"

curl "https://api.africa-api.com/v1/countries/ke/signals" \
  -H "Authorization: Bearer $AFRICA_API_KEY"