Historical rates API
Historical Exchange Rates API
Look up the exchange rates of any day back to 1999 with one call, or get whole series and averages: daily, weekly and month-end rates from the range endpoint, and monthly, quarterly or yearly averages with lows and highs.
Example request and response
The rates of 1 January 2022 against USD, the example from the /v3/historical documentation.
curl "https://api.currencyapi.com/v3/historical?date=2022-01-01¤cies=AED,AFN" \
-H "apikey: YOUR-API-KEY"
{
"meta": {
"last_updated_at": "2022-01-01T23:59:59Z"
},
"data": {
"AED": { "code": "AED", "value": 3.67306 },
"AFN": { "code": "AFN", "value": 91.80254 }
}
}
Historical endpoints
- /v3/historical
- All rates of one day (at least one day in the past), back to 1999.
- /v3/range
- A series between two dates: daily (up to 366 days per call), week-end, month-end or intraday. Medium plan and up.
- /v3/average
- Monthly, quarterly or yearly average, low and high rates, from market data or the ECB.
- /v3/fluctuation
- Start rate, end rate and change between two dates.
- /v3/official
- The official rates of 35 central banks, exactly as published, with their history.
Use cases
Accounting and tax
Book foreign-currency transactions at the rate of their date, or at a monthly average where the rules allow it.
Reports and audits
Recalculate past figures with the rates that applied then, and keep the source of each rate.
Analysis and charts
Download long series as CSV for spreadsheets, BI tools and models.
Start on the free plan
The free plan includes historical rates, fluctuation and averages (300 requests a month). The range endpoint is part of the Medium plan and above.
Frequently asked questions
How far back does the historical data go?
Can I get a whole series in one request?
Do you have official central bank rates?
Can I get monthly or yearly averages?
Related
More currency data
Free tools: currency converter · historical converter · bulk converter · converter widget