This page explains each Exchange Rate API endpoint with an example request and response. Depending on your subscription plan, some endpoints and options may not be available.
Latest Rates
Get real-time exchange rates for all or selected currencies.
https://api.apilayer.net/exchangerate/latest?access_key=YOUR_ACCESS_KEY&base=EUR&symbols=USD,GBP,JPY| Parameter | Description |
|---|---|
| access_key | [Required] Your API Access Key. |
| base | [Optional] Base currency. Default EUR. |
| symbols | [Optional] Comma-separated currency codes to return. Leave out for all currencies. |
Example response:
{
"success": true,
"timestamp": 1790917745,
"base": "EUR",
"date": "2026-10-02",
"rates": {
"USD": 1.12537,
"GBP": 0.851832,
"JPY": 177.604168
}
}Historical Rates
Get end-of-day rates for one past date. Put the date in the URL in YYYY-MM-DD format.
https://api.apilayer.net/exchangerate/2024-01-15?access_key=YOUR_ACCESS_KEY&base=EUR&symbols=USD,GBP,JPY| Parameter | Description |
|---|---|
| YYYY-MM-DD | [Required] The date, in the URL path. |
| base | [Optional] Base currency. Default EUR. |
| symbols | [Optional] Comma-separated currency codes to return. |
Example response:
{
"success": true,
"timestamp": 1705363199,
"historical": true,
"base": "EUR",
"date": "2024-01-15",
"rates": {
"USD": 1.094547,
"GBP": 0.860916,
"JPY": 159.570169
}
}The response adds "historical": true.
Convert Currency
Convert any amount from one currency to another, at the latest rate or at a past date's rate.
https://api.apilayer.net/exchangerate/convert?access_key=YOUR_ACCESS_KEY&from=USD&to=EUR&amount=10&date=2024-01-15| Parameter | Description |
|---|---|
| from | [Required] Currency to convert from. |
| to | [Required] Currency to convert to. |
| amount | [Required] Amount to convert. Must be greater than 0. |
| date | [Optional] Use this past date's rate (YYYY-MM-DD). Leave out for the latest rate. |
Example response:
{
"success": true,
"query": {
"from": "USD",
"to": "EUR",
"amount": 10
},
"info": {
"timestamp": 1705363199,
"rate": 0.91362
},
"date": "2024-01-15",
"historical": true,
"result": 9.1362
}info.rate is the rate used and result is the converted amount.
Time-Series Data
Get daily rates for every day between two dates. The maximum time frame is 365 days.
https://api.apilayer.net/exchangerate/timeseries?access_key=YOUR_ACCESS_KEY&start_date=2024-01-01&end_date=2024-01-07&symbols=USD,GBP,JPY| Parameter | Description |
|---|---|
| start_date | [Required] First day (YYYY-MM-DD). |
| end_date | [Required] Last day (YYYY-MM-DD). Max 365 days after start_date. |
| base | [Optional] Base currency. Default EUR. |
| symbols | [Optional] Comma-separated currency codes to return. |
Example response (shortened):
{
"success": true,
"timeseries": true,
"start_date": "2024-01-01",
"end_date": "2024-01-07",
"base": "EUR",
"rates": {
"2024-01-01": {
"USD": 1.103769,
"GBP": 0.867209,
"JPY": 155.775486
},
"2024-01-02": {
"USD": 1.09414,
"GBP": 0.866822,
"JPY": 155.539094
},
[...]
}
}Fluctuation Data
See how rates changed between two dates. Send both start_date and end_date, or neither to compare yesterday with today. Sending only one returns error 501.
https://api.apilayer.net/exchangerate/fluctuation?access_key=YOUR_ACCESS_KEY&start_date=2024-01-01&end_date=2024-01-07&symbols=USD,GBP,JPYExample response:
{
"success": true,
"fluctuation": true,
"start_date": "2024-01-01",
"end_date": "2024-01-07",
"base": "EUR",
"rates": {
"USD": {
"start_rate": 1.103769,
"end_rate": 1.094182,
"change": -0.0096,
"change_pct": -0.8686
},
"GBP": {
"start_rate": 0.867209,
"end_rate": 0.860486,
"change": -0.0067,
"change_pct": -0.7752
},
"JPY": {
"start_rate": 155.775486,
"end_rate": 158.369119,
"change": 2.5936,
"change_pct": 1.665
}
}
}| Object | Description |
|---|---|
| start_rate | Rate on start_date. |
| end_rate | Rate on end_date. |
| change | end_rate minus start_rate. |
| change_pct | Change in percent. |
Supported Symbols
Get all supported currency codes and their full names.
https://api.apilayer.net/exchangerate/symbols?access_key=YOUR_ACCESS_KEYExample response (shortened):
{
"success": true,
"symbols": {
"AED": "United Arab Emirates Dirham",
"AFN": "Afghan Afghani",
"ALL": "Albanian Lek",
"AMD": "Armenian Dram",
[...]
}
}Changing the Base Currency
Rates are relative to EUR by default. Set base to any supported currency to change this on /latest, /{YYYY-MM-DD}, /timeseries and /fluctuation. This option is available on selected plans.
https://api.apilayer.net/exchangerate/latest?access_key=YOUR_ACCESS_KEY&base=USDBid and Ask Prices (Spread)
Set spread=1 on /latest, /{YYYY-MM-DD} or /timeseries to get the bid price, ask price and spread with each rate. This option is available on selected plans.
https://api.apilayer.net/exchangerate/latest?access_key=YOUR_ACCESS_KEY&symbols=USD&spread=1