logo
theme
Currency Converter
FREE
By natkapral
Updated a month ago
Currency Converter Overview

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

provider
rating
Followers on API
Follow this API
resourcesProvider WebsiteTerms of Service
More Details

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.
Have a question about this API?Ask the API Provider.
More by natkapral
Developers who viewed Currency Converter also viewed

Install SDK for (Node.js)Unirest

OAuth2 Authentication
Client ID
Client Secret
OAuth2 Authentication