Examples
Copy-paste ready examples. Keep your key in an environment variable (CURRENCYREST_KEY).
Simple conversion
Convert 100 EUR to USD.
curl "https://api.currencyrest.com/v1/convert?from=EUR&to=USD&amount=100" \
-H "X-API-Key: your_api_key"Choosing / comparing a source
Force a specific source and list a pair’s sources.
# Force a specific source (no silent fallback)
curl "https://api.currencyrest.com/v1/convert?from=USD&to=JPY&amount=1&source=boj" \
-H "X-API-Key: your_api_key"
# Which sources are available for a pair?
curl "https://api.currencyrest.com/v1/rates/sources?from=EUR&to=USD"Historical data
Fetch a time series for a pair.
curl "https://api.currencyrest.com/v1/historical?from=EUR&to=USD&startDate=2026-01-01&limit=100" \
-H "X-API-Key: your_api_key"