Currency Converter

FREE
By natkapral
Updated 10 days ago
Finance
9.6/10
Popularity Score
154ms
Latency
92%
Success Rate

Currency Converter API Overview

This API lets you convert between currencies and provides historical data from 2010.

Contact API Provider
star-blueRate

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.

Install SDK for (Node.js)Unirest

OAuth2 Authentication
Client ID
Client Secret
OAuth2 Authentication