Back to explore

finance

Currency

Credits: 0.000001

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"
        }
    ]
}

Credits: 0.000001

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
}

Credits: 0.000001

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
    }
}

Credits: 0.000001

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
    }
}