Complete API Documentation
GET
/api/rates
Get current forex rates between currencies
Response:
{ "base": "USD", "rates": { "EUR": 0.85, "GBP": 0.73, "JPY": 110.0, "BTC": 0.00001 } }GET
/api/convert
Convert amount between currencies
Response:
{ "amount": 100, "from": "USD", "to": "EUR", "result": 85.0 }GET
/api/historical/rates
Get historical forex rates for a specific date
Response:
{ "date": "2024-01-01", "base": "USD", "rates": { "EUR": 0.90, "GBP": 0.79, "JPY": 148.5 } }GET
/api/historical/timeseries
Get time series data for a date range (max 5 years)
Response:
{ "start_date": "2024-01-01", "end_date": "2024-01-03", "base": "USD", "data": { "2024-01-01": {"EUR": 0.90}, "2024-01-02": {"EUR": 0.89}, "2024-01-03": {"EUR": 0.88} } }GET
/api/currencies
List all available currencies
Response:
{ "currencies": [ "USD", "EUR", "GBP", "JPY", "BTC", "ETH", "AUD", "CAD" ], "count": 593 }GET
/api/historical/limits
Get historical data availability per currency
Response:
{ "currencies": { "EUR": { "earliest_date": "1999-01-01", "latest_date": "2025-12-31", "total_days": 9664 } }, "total_currencies": 170 }GET
/api/vat/rates
Get current VAT rates for EU countries
Response:
{ "vat_rates": { "DE": { "country_code": "DE", "country_name": "Germany", "vat_rate": 19.0 }, "FR": { "country_code": "FR", "country_name": "France", "vat_rate": 20.0 } } }