Angola X FX Data API
The Angola X FX Data API provides programmatic access to exchange rate data, historical time series, and market indicators for the Angolan kwanza. Designed for institutional users, fintech applications, and research teams, the API delivers the same data that powers the Angola X platform in a machine-readable format.
Available Endpoints
| Endpoint | Method | Description |
|---|---|---|
/api/v1/rates/latest | GET | Current BNA reference rates for all published currency pairs |
/api/v1/rates/{pair} | GET | Current rate for a specific pair (e.g., USD-AOA, EUR-AOA) |
/api/v1/rates/history | GET | Historical daily rates with date range parameters |
/api/v1/rates/cross | GET | Cross rate calculator (any supported pair via USD triangulation) |
/api/v1/auction/latest | GET | Most recent BNA FX auction results |
/api/v1/auction/history | GET | Historical auction data (volume, weighted-average rate, bid range) |
/api/v1/reserves/latest | GET | Current FX reserve level and import cover ratio |
/api/v1/reserves/history | GET | Historical reserve data |
/api/v1/spread | GET | Current official vs. parallel market spread estimate |
/api/v1/indicators | GET | Macro indicators (inflation, policy rate, oil price, production) |
Supported Currency Pairs
The API covers all major pairs against the kwanza:
- USD/AOA — US Dollar (primary reference)
- EUR/AOA — Euro
- GBP/AOA — British Pound
- BRL/AOA — Brazilian Real
- ZAR/AOA — South African Rand
- CNY/AOA — Chinese Yuan
- JPY/AOA — Japanese Yen
- CHF/AOA — Swiss Franc
Authentication
All API requests require an API key passed in the request header:
Authorization: Bearer YOUR_API_KEY
API keys are issued upon registration. Free tier keys are available for evaluation and non-commercial research.
Rate Limits
| Plan | Requests per Minute | Historical Depth | Auction Data |
|---|---|---|---|
| Free | 10 | 30 days | Latest only |
| Professional | 120 | 5 years | Full history |
| Enterprise | 600 | Full archive | Full history + real-time |
Response Format
All endpoints return JSON. A sample response from /api/v1/rates/latest:
{
"timestamp": "2026-02-23T10:00:00Z",
"source": "BNA",
"base": "USD",
"rates": {
"AOA": 914.60,
"EUR_AOA": 970.50,
"GBP_AOA": 1160.00,
"BRL_AOA": 160.20,
"ZAR_AOA": 50.10,
"CNY_AOA": 127.50,
"JPY_AOA": 6.10,
"CHF_AOA": 1030.00
}
}
Use Cases
- Treasury systems. Automate daily rate ingestion for corporate treasury and accounting platforms operating in Angola.
- Fintech applications. Power remittance comparison tools, FX calculators, and portfolio valuation engines.
- Research and analytics. Build models of oil-FX correlation, REER estimation, and depreciation forecasting using historical time series.
- Risk management. Monitor the official-parallel spread and BNA auction dynamics for early warning of FX stress.
Data Sources and Methodology
Rate data is sourced from the BNA’s published reference rates (see how BNA rates are set). Cross rates are derived through USD triangulation using international market rates from tier-1 data providers. Auction data is sourced from BNA auction result publications. All data undergoes quality checks before publication.
Getting Started
Register for an API key on the Angola X platform. For technical support, integration guidance, or enterprise pricing inquiries, contact the Angola X data team. For interactive use of the same underlying data, see our currency converter and export calculator.