By apilayer
Updated a year ago

currencylayer API Documentation

Currencylayer provides an easy-to-integrate REST API with real-time and historical exchange rates for 168 world currencies and precious metals, delivered in lightweight and highly portable JSON format and compatible with any application, framework or language.

Sign up for your free API Access Key at

Learn more about this API
GET"live" endpoint - request the most recent exchange rates
GET"historical" endpoint - request exchange rates for a specific date
GET"convert" endpoint - convert any amount from one currency to another
GET"timeframe" endpoint - request exchange rates for a specified timeframe
GET"change" endpoint - request a currency's change parameters
GET"list" endpoint - obtain a JSON list of all supported currencies
GET"live" endpoint - request the most recent exchange rates

Making a request to the API's "live" endpoint will return the most recent exchange rate data available.


Access the currencylayer API by appending your unique Access Key.

Header Parameters
Required Parameters
REQUIREDThis is your unique API Access Key
Optional Parameters
OPTIONAL"source" - the currency to which all other exchange rates are relative ("Source Currency")
OPTIONAL"currencies" - request only specific currencies (e.g. EUR,CAD,GBP)
Code Snippet
Install SDK
Response Example

Install SDK for (Node.js)Unirest

OAuth2 Authentication
Client ID
Client Secret
OAuth2 Authentication