Historical data is provided from 2010-01-01.

Currencies List

It returns the list of available currencies

Endpoint:

GET: /currency/list?format={format}

Parameters:

• format: json or xml

Example Response:

{
    "status":"success",
    "currencies":[
        "AUD":"Australian Dollar",
        "BGN":"Bulgarian Lev",
        [ ... ]
    ]
}

Currency Conversion

Currency Conversion Lookup converts one currency to another.

Endpoint:

GET: /currency/convert?&from={from}&to={to}&amount={amount}&format={format}

Parameters

• from: the code of the base currency.The default base currency is EUR.
• to: the code of the currency to convert to. If the value is not provided then the list of all supported currencies will be returned. You can provide several currencies using comma (to=GBP,EUR,AUD)
• amount: amount that needs to be converted
• format: json or xml

Example response:

{
    "status":"success",
    "updated_date":"2018-12-27",
    "base_currency_code":"EUR",
    "amount":10,"
    "base_currency_name":"Euro",
    rates":{
        "GBP":{
            "currency_name":"Pound Sterling",
            "rate":"0.9007",
            "rate_for_amount":"9.0070"
        }
    }
}

Historical Currency

Provides currency exchange rate on the specific day.

Endpoint:

GET: /currency/historical/{YYYY-MM-DD}?from={from}&to={to}&amount={amount}&format={format} 

Parameters:

• YYYY-MM-DD: required date in the format YYYY-MM-DD
• from: the code of the base currency.The default base currency is EUR.
• to: the code of the currency to convert to. If the value is not provided then the list of all supported currencies will be returned. You can provide several currencies using comma (to=GBP,EUR,AUD)
• amount: amount that needs to be converted
• format: json or xml

Example response:

{
    "status":"success",
    "updated_date":"2018-10-12",
    "base_currency_code":"EUR",
    "amount":10,"
    "base_currency_name":"Euro",
    rates":{
        "GBP":{
            "currency_name":"Pound Sterling",
            "rate":"0.8764",
            "rate_for_amount":"8.7640"
        }
    }
}

Errors

In case the request fails or the resource is not available the error will be returned in JSON or XML format.

Error response:

{
    "status":"failed",
    "error":{
        "message":"Invalid key.",
        "code":"403"
    }
}

Error Codes:

• 400 : Bad request.
• 403 : Authentication failed
• 404 : Resource is not found or requested format is incorrect
• 405 : Method is not allowed.
• 500 : Server error. We hope you will never see this error.