finance

Currency

0.000001 credits per request

Codes

POST /v1/currency/Codes

Codes returns the supported currency codes for the API

Request

{}

Response

codesarray

Request

Response

{
    "codes": [
        {
            "name": "AED",
            "currency": "UAE Dirham"
        },
        {
            "name": "AFN",
            "currency": "Afghan Afghani"
        },
        {
            "name": "ALL",
            "currency": "Albanian Lek"
        },
        {
            "name": "AMD",
            "currency": "Armenian Dram"
        },
        {
            "name": "ANG",
            "currency": "Netherlands Antillian Guilder"
        }
    ]
}

0.000001 credits per request

Convert

POST /v1/currency/Convert

Convert returns the currency conversion rate between two pairs e.g USD/GBP

Request

amountnumber

optional amount to convert e.g 10.0

fromstring

base code to convert from e.g USD

tostring

target code to convert to e.g GBP

Response

amountnumber

converted amount e.g 7.10

fromstring

the base code e.g USD

ratenumber

conversion rate e.g 0.71

tostring

the target code e.g GBP

Request

Response

{
    "from": "USD",
    "to": "GBP",
    "rate": 0.7104
}

0.0001 credits per request

History

POST /v1/currency/History

Returns the historic rates for a currency on a given date

Request

codestring

currency code e.g USD

datestring

date formatted as YYYY-MM-DD

Response

codestring

The code of the request

datestring

The date requested

ratesobject

The rate for the day as code:rate

Request

Response

{
    "code": "USD",
    "date": "2020-05-30",
    "rates": {
        "AED": 3.672,
        "ARS": 68.3238,
        "AUD": 1.5017,
        "BGN": 1.7573,
        "BRL": 5.372,
        "BSD": 1,
        "CAD": 1.3758,
        "CHF": 0.9625,
        "CLP": 810.6932,
        "CNY": 7.1408,
        "COP": 3711.2273,
        "CZK": 24.2592,
        "DKK": 6.7076,
        "DOP": 55.3539,
        "EGP": 15.8108,
        "EUR": 0.9004,
        "FJD": 2.2202,
        "GBP": 0.8108,
        "GTQ": 7.6924,
        "HKD": 7.753,
        "HRK": 6.8175,
        "HUF": 313.7167,
        "IDR": 14536.6684,
        "ILS": 3.5082,
        "INR": 75.5508,
        "ISK": 135.7104,
        "JPY": 107.4223,
        "KRW": 1236.3642,
        "KZT": 412.3586,
        "MXN": 22.1514,
        "MYR": 4.3465,
        "NOK": 9.7236,
        "NZD": 1.61,
        "PAB": 1,
        "PEN": 3.4361,
        "PHP": 50.5076,
        "PKR": 160.0922,
        "PLN": 4.0015,
        "PYG": 6803.9167,
        "RON": 4.361,
        "RUB": 70.561,
        "SAR": 3.7548,
        "SEK": 9.4421,
        "SGD": 1.4125,
        "THB": 31.8255,
        "TRY": 6.8228,
        "TWD": 30.0096,
        "UAH": 26.8391,
        "USD": 1,
        "UYU": 43.0401,
        "ZAR": 17.5029
    }
}

0.00001 credits per request

Rates

POST /v1/currency/Rates

Rates returns the currency rates for a given code e.g USD

Request

codestring

The currency code to get rates for e.g USD

Response

codestring

The code requested e.g USD

ratesobject

The rates for the given code as key-value pairs code:rate

Request

Response

{
    "code": "usd",
    "rates": {
        "AED": 3.6725,
        "AFN": 79.0514,
        "ALL": 101.6054,
        "AMD": 515.68,
        "ANG": 1.79,
        "AOA": 646.8737,
        "ARS": 95.3433,
        "AUD": 1.2998,
        "AWG": 1.79,
        "AZN": 1.7013
    }
}