Currency Converter

FREEMIUM
Verified
Por Geo API | Atualizado 4 days ago | Finance
Popularidade

9.9 / 10

Latência

142ms

Nível de serviço

100%

Health Check

N/A

LEIA-ME

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.
Seguidores: 152
Recursos:
Site do produto Termos de uso
API Creator:
Rapid account: Geo API
Geo API
natkapral
Efetuar login para classificar API
Avaliação: 2.7 - Votos: 6