Exchange Rate
Get live currency exchange rates and convert amounts between currencies. Rates are sourced from the European Central Bank via Frankfurter and cached for up to one hour.
Overview
Use Cases
- E-commerce multi-currency pricing
- Fintech apps and payment processors
- Travel and expense management tools
- Financial dashboards and reporting
- Invoice generation in foreign currencies
Features
180+ currencies supported (ECB data via Frankfurter)
Rates cached for 1 hour β fast responses, minimal latency
Combined convert endpoint returns rate and converted amount in one call
ISO 4217 three-letter currency codes (USD, EUR, GBP, JPY, etc.)
API Endpoints
Get Exchange Rate
Returns the current exchange rate between two currencies.
GET
https://api.requiems.xyz/v1/finance/exchange-rate
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| from | string |
Required | ISO 4217 source currency code (3 letters, e.g. USD) |
| to | string |
Required | ISO 4217 target currency code (3 letters, e.g. EUR) |
Try it out
Live DemoRequest
ISO 4217 source currency code (3 letters, e.g. USD)
ISO 4217 target currency code (3 letters, e.g. EUR)
Sending request...
Response Fields
| Field | Type | Description |
|---|---|---|
| from | string |
Source currency code (uppercased) |
| to | string |
Target currency code (uppercased) |
| rate | number |
Exchange rate β how many units of `to` equal 1 unit of `from` |
| timestamp | string |
Date the rate was published by the ECB (ISO 8601) |
Code Examples
curl "https://api.requiems.xyz/v1/finance/exchange-rate?from=USD&to=EUR" \
-H "requiems-api-key: YOUR_API_KEY"import requests
url = "https://api.requiems.xyz/v1/finance/exchange-rate"
headers = {"requiems-api-key": "YOUR_API_KEY"}
params = {"from": "USD", "to": "EUR"}
response = requests.get(url, headers=headers, params=params)
data = response.json()["data"]
print(data["rate"]) # 0.92const params = new URLSearchParams({ from: 'USD', to: 'EUR' });
const response = await fetch(
`https://api.requiems.xyz/v1/finance/exchange-rate?${params}`,
{ headers: { 'requiems-api-key': 'YOUR_API_KEY' } }
);
const { data } = await response.json();
console.log(data.rate); // 0.92require 'net/http'
require 'json'
uri = URI('https://api.requiems.xyz/v1/finance/exchange-rate')
uri.query = URI.encode_www_form(from: 'USD', to: 'EUR')
request = Net::HTTP::Get.new(uri)
request['requiems-api-key'] = 'YOUR_API_KEY'
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
http.request(request)
end
data = JSON.parse(response.body)['data']
puts data['rate'] # 0.92Error Responses
bad_request
A required parameter is missing or the currency code is not exactly 3 alphabetic characters.
invalid_currency
One or both currency codes are not recognised by the upstream data source.
upstream_error
The exchange rate data source is temporarily unavailable.
Convert Currency
Converts an amount from one currency to another and returns the rate alongside the converted value.
GET
https://api.requiems.xyz/v1/finance/convert
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| from | string |
Required | ISO 4217 source currency code (3 letters, e.g. USD) |
| to | string |
Required | ISO 4217 target currency code (3 letters, e.g. EUR) |
| amount | number |
Required | Amount to convert. Must be greater than 0. |
Try it out
Live DemoRequest
ISO 4217 source currency code (3 letters, e.g. USD)
ISO 4217 target currency code (3 letters, e.g. EUR)
Amount to convert. Must be greater than 0.
Sending request...
Response Fields
| Field | Type | Description |
|---|---|---|
| from | string |
Source currency code (uppercased) |
| to | string |
Target currency code (uppercased) |
| rate | number |
Exchange rate used for the conversion |
| amount | number |
The original amount passed in the request |
| converted | number |
Result of amount Γ rate, rounded to 2 decimal places |
| timestamp | string |
Date the rate was published by the ECB (ISO 8601) |
Code Examples
curl "https://api.requiems.xyz/v1/finance/convert?from=USD&to=EUR&amount=100" \
-H "requiems-api-key: YOUR_API_KEY"import requests
url = "https://api.requiems.xyz/v1/finance/convert"
headers = {"requiems-api-key": "YOUR_API_KEY"}
params = {"from": "USD", "to": "EUR", "amount": 100}
response = requests.get(url, headers=headers, params=params)
data = response.json()["data"]
print(data["converted"]) # 92.0
print(data["rate"]) # 0.92const params = new URLSearchParams({ from: 'USD', to: 'EUR', amount: 100 });
const response = await fetch(
`https://api.requiems.xyz/v1/finance/convert?${params}`,
{ headers: { 'requiems-api-key': 'YOUR_API_KEY' } }
);
const { data } = await response.json();
console.log(data.converted); // 92
console.log(data.rate); // 0.92require 'net/http'
require 'json'
uri = URI('https://api.requiems.xyz/v1/finance/convert')
uri.query = URI.encode_www_form(from: 'USD', to: 'EUR', amount: 100)
request = Net::HTTP::Get.new(uri)
request['requiems-api-key'] = 'YOUR_API_KEY'
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
http.request(request)
end
data = JSON.parse(response.body)['data']
puts data['converted'] # 92.0
puts data['rate'] # 0.92Error Responses
bad_request
A required parameter is missing, the currency code is not 3 alphabetic characters, or the amount is 0 or negative.
invalid_currency
One or both currency codes are not recognised by the upstream data source.
upstream_error
The exchange rate data source is temporarily unavailable.
Frequently Asked Questions
Rates come from the European Central Bank and are published on business days, typically around 16:00 CET. The API caches each rate pair for 1 hour, so responses are fast and the cache stays fresh.
All currencies supported by the ECB via Frankfurter β approximately 170 currencies. If you pass an unsupported code you will receive a 422 invalid_currency error.
Yes β the converted field is rounded to 2 decimal places. The rate itself is returned at full precision as provided by the ECB.
Yes. Any from/to combination is supported as long as both codes are in the ECB dataset.
The Frankfurter upstream service is temporarily unavailable. Rates are cached for 1 hour, so a 503 typically means the cache expired and the upstream could not be reached. Retry after a short delay.