Access currency lifecycle metadata.
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.
API key created on your Xe Currency Data account's API page, sent as a Bearer token in the Authorization header.
In: header
Response Body
application/json
application/json
application/json
application/json
text/plain
curl -X GET "https://example.com/v2/currencies"{ "terms": "https://www.xe.com/legal", "privacy": "https://www.xe.com/privacy", "currencies": [ { "currency_code": "ADA", "currency_name": "Cardano", "is_iso_4217": false, "asset_class": "crypto", "status": "active", "rates_from": "2021-03-19", "currency_symbol": "₳", "currency_symbol_on_right": false }, { "currency_code": "AED", "currency_name": "Emirati Dirham", "is_iso_4217": true, "asset_class": "fiat", "status": "active", "rates_from": "1998-11-30", "peg": { "type": "hard_peg", "from": { "amount": 3.6725, "currency": "AED" }, "to": { "amount": 1, "currency": "USD" } }, "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"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.
Convert from one base currency to one or multiple counter currencies. GET
In the example below, the Convert FROM API query endpoint is to convert from GBP to all available currencies (the asterisk * represents ALL currencies). [https://xecdapi.xe.com/v1/convert_from.csv/?from=GBP&to=*&amount=1](https://xecdapi.xe.com/v1/convert_from.csv/?from=GBP&to=*&amount=1)