API ReferenceCentral bank exchange rates

Central bank exchange rates from currency of central bank to one or multiple counter currencies, provided by specified central bank.

GET
/v1/central_bank_rate

Included with the Intermediate, Prime and Enterprise plans. Core and the free trial do not include this endpoint: on Core, add the Central bank exchange & interest rates add-on and use /v2/central_bank instead. See Data plans.

In the example below, the endpoint converts from CAD to all available currencies for the Bank of Canada (the asterisk * represents ALL currencies). https://xecdapi.xe.com/v1/central_bank_rate.csv/?central_bank=CAN&to=*&amount=1

Note on Central Bank Data Coverage: Some Central Banks may experience temporary data gaps due to source website changes or access restrictions. For these banks, we continue to provide historical data and are working to restore full coverage.

Authorization

AuthorizationBearer <token>

API key created on your Xe Currency Data account's API page, sent as a Bearer token in the Authorization header.

In: header

Query Parameters

central_bank*string

REQUIRED – Three letter codes representing the specific central bank you are querying for. The time(s) specified below highlights the time rates published by each respective central bank updates within the API service.

CodeCountryNamePostsAvailable at (UTC)Effective forBid/Ask
AFGAfghanistanThe Afghanistan BankDaily13:00Same day✓
AGOAngolaNational Bank of AngolaDaily14:00Same day
ALBAlbaniaBank of AlbaniaDaily13:00Same day✓
ALBBAlbaniaBank of Albania (Bi-Weekly)MonthlyMid and End of MonthPrevious Week
ARMArmeniaCentral Bank of ArmeniaDaily13:00Same day
AUSAustraliaReserve Bank of AustraliaDaily08:00Same day
AZEAzerbaijanThe Central Bank of the Republic of AzerbaijanDaily07:00Same day
BEACCentral African StatesThe Bank Of Central African States (Banque des États de l'Afrique Centrale)Daily09:00Same day✓
BGDBangladeshCentral Bank of BangladeshDaily06:00Same day✓
BGRBulgariaBulgarian National BankDaily17:00Same day
BHRBahrainCentral Bank of BahrainDaily05:00Same day
BHSBahamasCentral Bank of The BahamasDaily06:00Same day✓
BIHBosnia and HerzegovinaThe Central Bank of Bosnia and HerzegovinaDaily02:00Same day✓
BLZBelizeCentral Bank of BelizeDaily17:00Same day✓
BOLBoliviaCentral Bank of BoliviaDaily22:00Same day
BRABrazilCentral Bank of BrazilDaily18:00Same day✓
CANCanadaBank of CanadaDaily23:00Same day
CAREastern Caribbean StatesEastern Caribbean Central BankDaily13:00Same day
CHESwitzerlandSwiss National BankDaily13:00Same day
CHLChileCentral Bank of ChileDaily04:00Same day
CHNChinaChina Foreign Exchange Trade SystemHourlyHourlySame day✓
COLColombiaBank of the Colombian Republic (Banco de la República)Daily17:00Same day✓
CRICosta RicaCentral Bank of Costa Rica (Banco Central de Costa Rica)Daily01:00Same day✓
CZECzechiaCzech National BankDaily15:00Same day
DNKDenmarkNational Bank of Denmark (Danmarks Nationalbank)Daily16:00Same day
DOMDominican RepublicCentral Bank of the Dominican Republic (Banco Central de la República Dominicana)Daily22:00Same day
DZAAlgeriaBank of Algeria (Last seen 2026-09-16)DailySame day✓
ECBEuropean UnionEuropean Central BankDaily16:00Same day
EGYEgyptCentral Bank of EgyptDaily14:00Same day✓
FJIFijiReserve Bank of FijiDaily22:00Same day
GBRUnited Kingdom of Great Britain and Northern IrelandBank of EnglandDaily11:00Same day
GEOGeorgiaNational Bank of GeorgiaDaily14:00Same day
GHAGhanaBank of GhanaDaily18:00Same day✓
GTMGuatemalaBank of GuatemalaDaily16:00Same day✓
GUYGuyanaBank of GuyanaDaily17:00Same day✓
HKGHong KongHong Kong Monetary AuthorityDaily01:00Same day✓
HNDHondurasCentral Bank of HondurasDaily01:00Same day✓
HUNHungaryHungarian National Bank (Magyar Nemzeti Bank)Daily12:00Same day
IDNIndonesiaBank IndonesiaDaily02:00Same day✓
INDIndiaReserve Bank of IndiaDaily09:00Same day
IRQIraqCentral Bank of IraqDaily08:00Same day
ISLIcelandCentral Bank of IcelandDaily17:00Same day
ISRIsraelBank of IsraelDaily00:00Same day
JAMJamaicaBank of JamaicaDaily18:00Same day✓
JPNJapanBank of JapanDaily09:00Same day✓
KAZKazakhstanNational Bank of KazakhstanDaily16:00Same day
KENKenyaCentral Bank of KenyaDaily08:00Same day
KORKoreaSeoul Money Brokerage ServicesDaily01:00Same day
LAOLao People's Democratic RepublicBank of the Lao P.D.RDaily03:00Same day✓
LBNLebanonBank of Lebanon (Banque du Liban) (Last seen 2024-10-21)Every 6 weeksSame day
LKASri LankaThe Central Bank of Sri LankaDaily04:00Same day
MARMoroccoCentral Bank of the Kingdom of Morocco (Bank Al-Maghrib)Daily17:00Same day
MDAMoldovaNational Bank of MoldovaDaily02:00Same day
MEXMexicoBank of MexicoDaily20:00Same day
MEXMMexicoBank of Mexico (Monthly)MonthlyEnd of MonthSame Month
MMRMyanmarCentral Bank of MyanmarDaily14:00Same day
MNGMongoliaCentral Bank of MongoliaDaily11:00Same day
MOZMozambiqueBank of Mozambique (Banco de Moçambique)Daily14:00Same day✓
MRTMauritaniaCentral Bank of Mauritania (Banque Centrale de Mauritanie)Weekly13:00Same day
MYSMalaysiaBank Negara MalaysiaDaily10:00Same day✓
NAMNamibiaBank of NamibiaDaily08:00Same day
NGANigeriaCentral Bank of NigeriaDaily18:00Previous Day✓
NICNicaraguaCentral Bank of Nicaragua (Banco Central De Nicaragua)Daily16:00Same day✓
NORNorwayCentral Bank of Norway (Norges Bank)Daily16:00Same day
NZLNew ZealandReserve Bank of New ZealandDaily03:00Same day
OMNOmanCentral Bank of OmanDaily07:00Same day✓
PAKPakistanState Bank of PakistanDaily12:00Same day
PERPeruCentral Reserve Bank of Peru (Banco Central de Reserva del Perú)Daily20:00Previous Day✓
PHLPhilippinesCentral Bank of the Philippines (Bangko Sentral ng Pilipinas)Daily02:00Same day
PNGPapua New GuineaBank of Papua New Guinea (Last seen 2025-10-23)DailySame day
POLPolandNational Bank of PolandDaily12:00Same day
POLWPolandNational Bank of Poland (Table B)WeeklyWednesdaySame Week
PRYParaguayCentral Bank of Paraguay (Last seen 2025-05-26)DailySame day
QATQatarQatar Central BankDaily09:00Same day
ROURomaniaNational Bank of RomaniaDaily12:00Same day
RUSRussian FederationCentral Bank of the Russian FederationDaily16:00Previous Day
SAUSaudi ArabiaSaudi Central BankDaily22:00Same day
SGPSingaporeMonetary Authority of SingaporeDaily10:00Same day
SRBSerbiaNational Bank of SerbiaDaily08:00Same day✓
SSDSouth SudanBank of South Sudan (Last seen 2025-11-12)DailySame day✓
SVNSloveniaBank of SloveniaDaily16:00Same day
SWESwedenSweden's Central Bank (Sveriges Riksbank)Daily17:00Same day
SYCSeychellesCentral Bank of SeychellesDaily14:00Same day✓
SYRSyrian Arab RepublicCentral Bank of Syria (Last seen 2025-02-05)DailySame day✓
THAThailandBank of ThailandDaily12:00Same day✓
TJKTajikistanNational Bank of TajikistanDaily13:00Same day
TKMTurkmenistanCentral Bank of TurkmenistanDaily13:00Same day
TUNTunisiaCentral Bank of TunisiaDaily10:00Same day
TURTurkeyCentral Bank of the Republic of TurkeyDaily13:00Same day✓
TWNTaiwanCentral Bank of the Republic of China (Taiwan)Daily10:00Same day
TZATanzania, United Republic ofBank of TanzaniaDaily22:00Same day✓
UAEUnited Arab EmiratesCentral Bank of the UAEDaily16:00Same day
UGAUgandaBank of UgandaDaily08:00Same day✓
UKRUkraineNational Bank of UkraineDaily02:00Same day
URYUruguayCentral Bank of UruguayDaily22:00Same day
USAUnited States of AmericaUS Federal Reserve Bank of New YorkWeeklyMondayPrevious Week
UZBUzbekistanThe Central Bank of the Republic of UzbekistanDaily13:00Same day
VENVenezuelaCentral Bank of Venezuela (Banco Central de Venezuela)Daily22:00Same day✓
VNMVietnamState Bank of VietnamDaily17:00Same day✓
YEMYemenCentral Bank of Yemen (Last seen 2025-04-29)DailySame day✓
ZAFSouth AfricaSouth African Reserve BankDaily10:00Same day
ZMBZambiaBank of ZambiaDaily09:00Same day✓
ZWEZimbabweReserve Bank of ZimbabweDaily01:00Same day✓
to*string

Comma separated list of to currencies ISO 4217 codes. This will limit the data returned to only those currencies you are interested in. Use an asterisk * to convert all currencies.

amount?number

OPTIONAL – This parameter can be used to specify the amount you want to convert, if an amount is not specified then 1 is assumed.

Default1
date?string

OPTIONAL – YYYY-MM-DD format - request rates for a particular past date. Rates are often not posted on weekends and holidays. bid and ask are not available yet for past rates

use_bank_date?boolean

OPTIONAL – If ‘true’, the timestamp field of a current rate is the issuing bank’s own local calendar date in YYYY-MM-DD format, rather than a UTC instant that reads as the previous day west of the bank. Example: a European Central Bank rate returned as 2026-08-26T22:00:00Z is dated 2026-08-27 by the bank; requests that specify a date already return YYYY-MM-DD, so the parameter has no effect there.

Defaultfalse
inverse?boolean

OPTIONAL – If ‘true’, the endpoint will include inverse rates. An inverse rate is a quote for which the base currency and counter currency are switched. An inverse is calculated by dividing one by the exchange rate. Example: If the exchange rate for 1 USD to EUR = 0.874852, then the inverse rate would be 1/0.874852 = 1.14305, meaning that US$1.14305 would buy 1 euro.

Defaultfalse
decimal_places?number

OPTIONAL – This parameter can be used to specify the number of decimal places included in the output. Example: if 1 USD to EUR = 0.874852, adding decimal_places=3 to the query will result in the endpoint returning EUR = 0.875

Default20
margin?number

OPTIONAL – This parameter can be used to add a margin (+/-) to the exchange rate. Example: adding margin=2.05 to the query will result in the endpoint returning the current exchange rates with a +2.05% margin

Default0
fields?string

Comma separated list of fields. One or more of "mid", "bid" or "ask". Bid and ask are only available when requesting the current bank rate.

Default"mid"

Response Body

application/json

application/json

application/json

application/json

text/plain

curl -X GET "https://example.com/v1/central_bank_rate?central_bank=string&to=string"
{  "centralBankCode": "BRA",  "centralBankName": "Central Bank of Brazil",  "terms": "https://www.xe.com/legal",  "privacy": "https://www.xe.com/privacy",  "from": "BRL",  "amount": 1,  "timestamp": "2026-09-23T03:00:00Z",  "to": [    {      "quotecurrency": "EUR",      "mid": 0.1707358716,      "inverse": 5.857,      "bid": 0.170718383,      "ask": 0.1707533638    },    {      "quotecurrency": "USD",      "mid": 0.1945109023,      "inverse": 5.1411,      "bid": 0.1944995527,      "ask": 0.1945222533    }  ]}
Empty
{  "code": 34,  "message": "Invalid central_bank ZZZ",  "documentation_url": "https://developers.xe.com/docs/currency-data-api"}
{  "code": 1,  "message": "Bad credentials",  "documentation_url": "https://developers.xe.com/docs/currency-data-api"}
{  "code": 3,  "message": "Monthly rate limit exceeded.",  "documentation_url": "https://developers.xe.com/docs/currency-data-api"}
{  "code": 4,  "message": "Current interval rate limit exceeded.",  "documentation_url": "https://developers.xe.com/docs/currency-data-api"}
"An unexpected error occurred"

Central bank interest rates and exchange rates for one or more central banks. GET

Returns each requested central bank's policy interest rate and its exchange rates in one response, grouped by bank. To request one side only, use `/v2/central_bank/interest_rate` or `/v2/central_bank/exchange_rate`. Requires the Central bank exchange & interest rates add-on. See [Data plans](https://developers.xe.com/docs/currency-data-api/data-plans). A bank appears with an `interestRate` object only if it publishes a policy interest rate, and with an `exchangeRates` object only if it has exchange rates for the date. Use `/v2/central_bank/metadata` to see which banks publish what. The European Central Bank sets the policy rate for the euro area, so the code of a euro area national bank (for example SVN) returns that bank's exchange rates under its own code and the European Central Bank's interest rate under `ECB`. Exchange rates keep the direction the bank publishes them in, so `fromCurrency` is not always the bank's own currency. Exchange rates are returned once their effective date has arrived in the bank's local time zone. Some banks publish the next day's rate in advance (for example RUS): `/v1/central_bank_rate` returns it as soon as it is published, this endpoint from the date it is effective for. Each interest rate and each exchange rate pair returned counts as one rate request. Also available as XML and CSV by appending `.xml` or `.csv` to the path. [https://xecdapi.xe.com/v2/central_bank.csv?bank_code=ECB&iso=*](https://xecdapi.xe.com/v2/central_bank.csv?bank_code=ECB&iso=*)

Access a list of all available currencies. GET

This endpoint will return a list of all currencies, active and obsolete, available via the XE Currency Data Feed API. If the obsolete optional parameter is included, then the list will contain both active and obsolete currencies.

Get help