Currency Exchange Rate API
Docs
Standard Requests

Standard Requests

Documentation for the Standard Currency Exchange Rate API API endpoint.

Overview

Our Standard API endpoint is the easiest and fastest way to access our exchange rate data. It's available on all plans including Free.

Choose your base currency and the Standard endpoint will simply return the conversion rates from your base currency code to all the others we support in an easy to parse JSON format.

Usage Guide

To use our Standard endpoint simply make the two substitutions explained below and then send a GET request.

• Substitute YOUR-API-KEY with the API key displayed in your dashboard.

• Substitute USD with the code you want to use as a base currency.

We use ISO 4217 Three Letter Currency Codes - e.g. USD for US Dollars, EUR for Euro etc. Here are the codes we support.

GET https://api.currencyexchangerate-api.com/v1/YOUR-API-KEY/latest/USD

This will return the exchange rates from your base code to all the other currencies we support:

{
    "result": "success",
    "base_code": "USD",
    "qouta": 100,
    "remining": 81,
    "conversion_rates": {
        "USD": 1,
        "AED": 3.6725,
        "AFN": 71.3023,
        "ALL": 93.9532,
        "AMD": 387.9516,
        "ANG": 1.79,
        "AOA": 864.5035,
        "ARS": 902.67,
        "AUD": 1.512,
        "AWG": 1.79,
        "AZN": 1.7007,
        "BAM": 1.8274,
        "BBD": 2,
        "BDT": 117.582,
        "BGN": 1.8274,
        "BHD": 0.376,
        "BIF": 2867.3971,
        "BMD": 1,
        "BND": 1.3532,
        "BOB": 6.9345,
        "BRL": 5.3659,
        "BSD": 1,
        "BTN": 83.5845,
        "BWP": 13.6479,
        "BYN": 3.2726,
        "BZD": 2,
        "CAD": 1.3735,
        "CDF": 2811.1817,
        "CHF": 0.8908,
        "CLP": 918.097,
        "CNY": 7.2761,
        "COP": 4125.4698,
        "CRC": 527.8638,
        "CUP": 24,
        "CVE": 103.0222,
        "CZK": 23.0881,
        "DJF": 177.721,
        "DKK": 6.9697,
        "DOP": 59.6961,
        "DZD": 134.8695,
        "EGP": 47.7066,
        "ERN": 15,
        "ETB": 57.711,
        "EUR": 0.9343,
        "FJD": 2.2419,
        "FKP": 0.7889,
        "FOK": 6.9697,
        "GBP": 0.7889,
        "GEL": 2.8683,
        "GGP": 0.7889,
        "GHS": 15.1395,
        "GIP": 0.7889,
        "GMD": 65.5045,
        "GNF": 8590.3598,
        "GTQ": 7.7857,
        "GYD": 209.2441,
        "HKD": 7.8123,
        "HNL": 24.7901,
        "HRK": 7.0396,
        "HTG": 132.4625,
        "HUF": 371.7429,
        "IDR": 16460.2009,
        "ILS": 3.721,
        "IMP": 0.7889,
        "INR": 83.5835,
        "IQD": 1310.1654,
        "IRR": 42104.4774,
        "ISK": 139.5748,
        "JEP": 0.7889,
        "JMD": 155.8355,
        "JOD": 0.709,
        "JPY": 157.4773,
        "KES": 128.4461,
        "KGS": 86.9658,
        "KHR": 4128.9042,
        "KID": 1.5118,
        "KMF": 459.6528,
        "KRW": 1381.9946,
        "KWD": 0.3067,
        "KYD": 0.8333,
        "KZT": 451.9814,
        "LAK": 21616.4732,
        "LBP": 89500,
        "LKR": 303.7975,
        "LRD": 194.9098,
        "LSL": 18.37,
        "LYD": 4.8584,
        "MAD": 9.9799,
        "MDL": 17.7768,
        "MGA": 4462.0936,
        "MKD": 57.5767,
        "MMK": 2098.8668,
        "MNT": 3375.0857,
        "MOP": 8.0465,
        "MRU": 39.4135,
        "MUR": 46.647,
        "MVR": 15.4143,
        "MWK": 1743.0533,
        "MXN": 18.495,
        "MYR": 4.7187,
        "MZN": 63.8439,
        "NAD": 18.37,
        "NGN": 1513.7314,
        "NIO": 36.9489,
        "NOK": 10.6821,
        "NPR": 133.7351,
        "NZD": 1.6295,
        "OMR": 0.3845,
        "PAB": 1,
        "PEN": 3.7789,
        "PGK": 3.8447,
        "PHP": 58.7065,
        "PKR": 278.5415,
        "PLN": 4.0841,
        "PYG": 7520.7635,
        "QAR": 3.64,
        "RON": 4.6567,
        "RSD": 109.4952,
        "RUB": 89.4676,
        "RWF": 1316.4133,
        "SAR": 3.75,
        "SBD": 8.4695,
        "SCR": 14.5658,
        "SDG": 532.5211,
        "SEK": 10.5305,
        "SGD": 1.3533,
        "SHP": 0.7889,
        "SLE": 22.9677,
        "SLL": 22967.6967,
        "SOS": 571.7521,
        "SRD": 31.7386,
        "SSP": 1793.3311,
        "STN": 22.8907,
        "SYP": 12983.3643,
        "SZL": 18.37,
        "THB": 36.6731,
        "TJS": 10.7228,
        "TMT": 3.5003,
        "TND": 3.1451,
        "TOP": 2.3551,
        "TRY": 32.7864,
        "TTD": 6.7952,
        "TVD": 1.5118,
        "TWD": 32.3454,
        "TZS": 2600.6585,
        "UAH": 40.6506,
        "UGX": 3722.7985,
        "UYU": 39.2902,
        "UZS": 12586.5842,
        "VES": 36.4176,
        "VND": 25434.6838,
        "VUV": 119.7204,
        "WST": 2.7294,
        "XAF": 612.8705,
        "XCD": 2.7,
        "XDR": 0.7609,
        "XOF": 612.8705,
        "XPF": 111.4937,
        "YER": 250.2642,
        "ZAR": 18.3681,
        "ZMW": 26.2162,
        "ZWL": 3.4803
    }
}

Error Responses

{
	"result": "error",
	"error-type": "unknown-code"
}

Where "error-type" can be any of the following:

  1. unsupported-code: if we don't support the supplied currency code (see supported currencies...).
  2. malformed-request: when some part of your request doesn't follow the structure shown above.
  3. invalid-key: when your API key is not valid.
  4. inactive-account: if your email address wasn't confirmed.
  5. quota-reached: when your account has reached the the number of requests allowed by your plan.

Need Help?

If you have any questions or need further assistance, don’t hesitate to contact us. We’re here to assist you!

AuthenticationPair Conversion