Access a list of all available currencies.
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.
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
OPTIONAL – Comma separated list of ISO 4217 codes. This will limit the data returned to only those currencies that are specified. If this parameter is omitted, this endpoint will return results for all currencies.
It is a prefix match; you can provide it with one, two, or three characters and it will return a list of all the currencies with ISO 4217 codes that match.
A list of acceptable ISO 4217 currency codes can be found here: http://www.xe.com/iso4217.php
OPTIONAL – If 'true' then endpoint will display currencies that are obsolete but for which historical data is available
OPTIONAL – Default is en. Specified as an RFC-1766-compliant language tag.
Languages available: ar, de, en, es, fr, it, ja, pt, sv, zh-CN, zh-HK.
OPTIONAL - If 'symbol' then returns 'currency_symbol' and 'currency_symbol_on_right' in response
OPTIONAL – If 'true' then this endpoint will return data for the following crypto currencies: ADA, ARB, AVAX, BCH, BNB, BTC, DAI, DOGE, DOT, ETH, EURC, LINK, LTC, LUNA, POL, SOL, TRX, UNI, USDC, USDP, USDT, XLM and XRP.
Response Body
application/json
application/json
application/json
application/json
text/plain
curl -X GET "https://example.com/v1/currencies"{ "terms": "https://www.xe.com/legal", "privacy": "https://www.xe.com/privacy", "currencies": [ { "iso": "EUR", "currency_name": "Euro", "is_obsolete": false, "currency_symbol": "€", "currency_symbol_on_right": false }, { "iso": "USD", "currency_name": "US Dollar", "is_obsolete": false, "currency_symbol": "$", "currency_symbol_on_right": false } ]}{ "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 exchange rates from currency of central bank to one or multiple counter currencies, provided by specified central bank. GET
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](https://developers.xe.com/docs/currency-data-api/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](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.*
Access currency lifecycle metadata. GET
This endpoint returns lifecycle metadata for every currency the API carries - when the currency was introduced and withdrawn, the first and last date rates are available for it, the currency that replaced it, the peg used to convert between the two, and whether the code belongs to ISO 4217. Use it to map a date to the correct code before requesting a rate. This endpoint takes no parameters, and always includes obsolete currencies - unlike `/v1/currencies`, it needs no `obsolete` parameter. Also available as XML and CSV by appending `.xml` or `.csv` to the path. A peg exists to keep a long series continuous across a currency transition. Values derived from one are arithmetic, not observed market rates.