Exchange rate API

Exchange Rate API

currencyapi returns the current exchange rates of 171 fiat currencies, 16 cryptocurrencies and 4 precious metals against any base currency, as JSON. Rates update daily on the free plan, hourly on Small and every 60 seconds from the Medium plan.

Example request and response

The /v3/latest endpoint, with the example response from the documentation. Leave out currencies to get every currency.

curl "https://api.currencyapi.com/v3/latest?base_currency=USD&currencies=EUR,AED,AFN" \
  -H "apikey: YOUR-API-KEY"
{
  "meta": {
    "last_updated_at": "2023-06-23T10:15:59Z"
  },
  "data": {
    "AED": { "code": "AED", "value": 3.67306 },
    "AFN": { "code": "AFN", "value": 91.80254 },
    "EUR": { "code": "EUR", "value": 0.918456 }
  }
}

Response fields

meta.last_updated_at
When the returned rates were last updated (UTC).
data.{CODE}.code
The ISO 4217 code of the currency (or the crypto or metal code).
data.{CODE}.value
How much of the currency one unit of base_currency buys.

Use cases

Prices in local currency

Show prices, carts and invoices in your customers' currency, with rates that refresh as often as your plan allows.

Accounting and reporting

Convert revenue and costs into one reporting currency, and look up the rate of any past day back to 1999.

Dashboards and spreadsheets

Feed rates into BI tools, Google Sheets or Excel with one HTTPS call; the range endpoint also returns CSV.

Start on the free plan

The free plan includes 300 requests a month with latest and historical rates, updated daily, for private use. Paid plans start at $9.99 a month for commercial use and hourly updates; Medium and up update every 60 seconds.

Frequently asked questions

How often are the exchange rates updated?

Daily on the free plan, hourly on the Small plan and every 60 seconds on the Medium plan and above.

Which currencies does the API cover?

171 fiat currencies, 16 cryptocurrencies (Bitcoin, Ethereum and others) and gold, silver, platinum and palladium. The /v3/currencies endpoint lists all of them with their symbols and decimals.

Can I choose the base currency?

Yes. Set base_currency to any supported currency; it defaults to USD.

Do you have historical exchange rates?

Yes, back to 1999, through /v3/historical for one day and /v3/range for a span of days.

How do I authenticate?

Send your API key in the apikey header or as the apikey query parameter. Every request needs HTTPS.

Related

More currency data

Free tools: currency converter · historical converter · bulk converter · converter widget

Get your free currency API key

Start with 300 free requests a month