Talk to a currency expertRegister for a free trial
API ReferenceCentral bank exchange and interest rates

Central bank policy interest rates for one or more central banks.

GET
/v2/central_bank/interest_rate

Returns the policy interest rate for each requested central bank: the interestRate side of /v2/central_bank. Only some central banks publish one; interestRates.published in /v2/central_bank/metadata shows which.

Requires the Central bank exchange & interest rates add-on. See Data plans.

The European Central Bank sets the policy rate for the euro area, so the code of a euro area national bank returns the European Central Bank's rate, under ECB.

Each interest rate 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/interest_rate.csv?bank_code=*

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

bank_code*string

REQUIRED - One or more central bank codes, comma-separated (for example CAN,ECB), or an asterisk * for every bank that publishes a policy interest rate. Codes are case-insensitive. A bank that does not publish one returns 400.

date?string

OPTIONAL - YYYY-MM-DD format - request the interest rate in force on a past date. A future date returns 400. interestRates.ratesFrom in /v2/central_bank/metadata is the earliest date available.

Response Body

application/json

application/json

application/json

application/json

application/json

text/plain

curl -X GET "https://example.com/v2/central_bank/interest_rate?bank_code=string"
{  "terms": "https://www.xe.com/legal",  "privacy": "https://www.xe.com/privacy",  "centralBanks": [    {      "bankCode": "CAN",      "name": "Bank of Canada",      "currency": "CAD",      "timezone": "America/Toronto",      "interestRate": {        "currentRate": 2.25,        "decisionDate": "2026-09-02",        "lastBasisPointChange": 0,        "decisionType": "HOLD",        "nextMeetingDate": "2026-10-28"      }    },    {      "bankCode": "ECB",      "name": "European Central Bank",      "currency": "EUR",      "timezone": "Europe/Berlin",      "interestRate": {        "currentRate": 2.5,        "decisionDate": "2026-09-16",        "lastBasisPointChange": 25,        "decisionType": "HIKE",        "nextMeetingDate": "2026-10-29"      }    }  ]}

{  "code": 34,  "message": "Unsupported bank code 'BRA'",  "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": 16,  "message": "Endpoint not authorized. Feature missing: central-bank-rates-v2",  "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 exchange rates for one or more central banks. GET

Returns the exchange rates each requested central bank publishes: the `exchangeRates` side of `/v2/central_bank`. Rates keep the direction the bank publishes them in, so `fromCurrency` is not always the bank's own currency. Requires the Central bank exchange & interest rates add-on. See [Data plans](https://developers.xe.com/docs/currency-data-api/data-plans). 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 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/exchange_rate.csv?bank_code=CAN&iso=*](https://xecdapi.xe.com/v2/central_bank/exchange_rate.csv?bank_code=CAN&iso=*)

List the central banks and what each one publishes. GET

Returns every central bank the V2 endpoints support: its code, name, home currency and the countries it covers, whether it publishes a policy interest rate, and how it publishes exchange rates. Use the `bankCode` values as `bank_code` on the other V2 central bank endpoints. This endpoint takes no parameters. It works with any valid credentials and does not count towards your rate requests. Also available as XML and CSV by appending `.xml` or `.csv` to the path. [https://xecdapi.xe.com/v2/central_bank/metadata.csv](https://xecdapi.xe.com/v2/central_bank/metadata.csv)

Get help