Historical Exchange Rates API

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&currencies=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. Pro 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. compare=market adds the market rate of the publication day and the difference in percent next to each official rate.

/v3/official/range

Every publication of a central bank between two dates (up to 366 days apart), or only the week-end or month-end rates, as JSON, CSV or Excel, or as an import file for DATEV, ERPNext or Odoo (format=datev, erpnext or odoo). Pro plan and up.

/v3/official/compare

One currency pair as every central bank published it, side by side, with the highest and lowest value and the spread between them.

/v3/official/sources

The central banks you can use, with the currencies, publication schedule and stored history of each. Free: it does not count against your quota.

Use cases

Other currency APIs from Everapi

currencyapi.com is made by Everapi GmbH. Two sister products may fit your project better:

Frequently asked questions