Currency Converter

FREEMIUM
Verified
By Geo API | Updated 4 months ago | Finance
Popularity

9.8 / 10

Latency

119ms

Service Level

100%

Currency Converter Overview

Followers: 65
Resources:
Product Website Terms of use
API Creator:
avatar
Geo API
natkapral
Rate API:
Log In to Rate API

README

This API supports 160+ currencies and is based on the data provided by National Central Banks.
Rates are updated once an hour.
Historical data starts from 2010.

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.
Rating: 4 - Votes: 10