Global Exchange Rates
HomeDocsDeveloper API Portal
HomeDocsDeveloper API Portal
  1. Currencies
  • Introduction
  • Authentication
  • Formats
  • Rate limiting and quotas
  • Errors
  • Client libraries
  • Currencies
    • /currencies
      GET
  • Exchange Rates
    • /latest
      GET
    • /historical
      GET
  • Providers
    • /providers
      GET
  • Conversion
    • /convert
      GET
  1. Currencies

/currencies

GET
https://api.globalexchangerates.org/v1/currencies
Currencies
Returns the list of available currencies.
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.globalexchangerates.org/v1/currencies?code&format&header' \
--header 'Subscription-Key;'
Response Response Example
200 - Success
[
  {
    "code": "AED",
    "name": "United Arab Emirates dirham",
    "numericCode": "784",
    "obsolete": false
  },
  {
    "code": "AFN",
    "name": "Afghan afghani",
    "numericCode": "971",
    "obsolete": false
  },
  {
    "code": "ALL",
    "name": "Albanian lek",
    "numericCode": "008",
    "obsolete": false
  },
  {
    "code": "AMD",
    "name": "Armenian dram",
    "numericCode": "051",
    "obsolete": false
  },
  {
    "code": "ANG",
    "name": "Netherlands Antillean guilder",
    "numericCode": "532",
    "obsolete": false
  },
  {
    "code": "AOA",
    "name": "Angolan kwanza",
    "numericCode": "973",
    "obsolete": false
  },
  {
    "code": "ARS",
    "name": "Argentine peso",
    "numericCode": "032",
    "obsolete": false
  },
  {
    "code": "AUD",
    "name": "Australian dollar",
    "numericCode": "036",
    "obsolete": false
  },
  {
    "code": "AWG",
    "name": "Aruban florin",
    "numericCode": "533",
    "obsolete": false
  },
  {
    "code": "AZN",
    "name": "Azerbaijani manat",
    "numericCode": "944",
    "obsolete": false
  },
  {
    "code": "BAM",
    "name": "Bosnia and Herzegovina convert",
    "numericCode": "977",
    "obsolete": false
  },
  {
    "code": "BBD",
    "name": "Barbados dollar",
    "numericCode": "052",
    "obsolete": false
  },
  {
    "code": "BDT",
    "name": "Bangladeshi taka",
    "numericCode": "050",
    "obsolete": false
  },
  {
    "code": "BGN",
    "name": "Bulgarian lev",
    "numericCode": "975",
    "obsolete": false
  },
  {
    "code": "BHD",
    "name": "Bahraini dinar",
    "numericCode": "048",
    "obsolete": false
  },
  {
    "code": "BIF",
    "name": "Burundian franc",
    "numericCode": "108",
    "obsolete": false
  },
  {
    "code": "BMD",
    "name": "Bermudian dollar",
    "numericCode": "060",
    "obsolete": false
  },
  {
    "code": "BND",
    "name": "Brunei dollar",
    "numericCode": "096",
    "obsolete": false
  },
  {
    "code": "BOB",
    "name": "Boliviano",
    "numericCode": "068",
    "obsolete": false
  },
  {
    "code": "BRL",
    "name": "Brazilian real",
    "numericCode": "986",
    "obsolete": false
  },
  {
    "code": "BSD",
    "name": "Bahamian dollar",
    "numericCode": "044",
    "obsolete": false
  },
  {
    "code": "BTN",
    "name": "Bhutanese ngultrum",
    "numericCode": "064",
    "obsolete": false
  },
  {
    "code": "BWP",
    "name": "Botswana pula",
    "numericCode": "072",
    "obsolete": false
  },
  {
    "code": "BYN",
    "name": "Belarusian ruble",
    "numericCode": "933",
    "obsolete": false
  },
  {
    "code": "BZD",
    "name": "Belize dollar",
    "numericCode": "084",
    "obsolete": false
  },
  {
    "code": "CAD",
    "name": "Canadian dollar",
    "numericCode": "124",
    "obsolete": false
  },
  {
    "code": "CDF",
    "name": "Congolese franc",
    "numericCode": "976",
    "obsolete": false
  },
  {
    "code": "CHF",
    "name": "Swiss franc",
    "numericCode": "756",
    "obsolete": false
  },
  {
    "code": "CLP",
    "name": "Chilean peso",
    "numericCode": "152",
    "obsolete": false
  },
  {
    "code": "CNY",
    "name": "Renminbi",
    "numericCode": "156",
    "obsolete": false
  },
  {
    "code": "COP",
    "name": "Colombian peso",
    "numericCode": "170",
    "obsolete": false
  },
  {
    "code": "CRC",
    "name": "Costa Rican colon",
    "numericCode": "188",
    "obsolete": false
  },
  {
    "code": "CUP",
    "name": "Cuban peso",
    "numericCode": "192",
    "obsolete": false
  },
  {
    "code": "CVE",
    "name": "Cape Verdean escudo",
    "numericCode": "132",
    "obsolete": false
  },
  {
    "code": "CZK",
    "name": "Czech koruna",
    "numericCode": "203",
    "obsolete": false
  },
  {
    "code": "DJF",
    "name": "Djiboutian franc",
    "numericCode": "262",
    "obsolete": false
  },
  {
    "code": "DKK",
    "name": "Danish krone",
    "numericCode": "208",
    "obsolete": false
  },
  {
    "code": "DOP",
    "name": "Dominican peso",
    "numericCode": "214",
    "obsolete": false
  },
  {
    "code": "DZD",
    "name": "Algerian dinar",
    "numericCode": "012",
    "obsolete": false
  },
  {
    "code": "EGP",
    "name": "Egyptian pound",
    "numericCode": "818",
    "obsolete": false
  },
  {
    "code": "ERN",
    "name": "Eritrean nakfa",
    "numericCode": "232",
    "obsolete": false
  },
  {
    "code": "ETB",
    "name": "Ethiopian birr",
    "numericCode": "230",
    "obsolete": false
  },
  {
    "code": "EUR",
    "name": "Euro",
    "numericCode": "978",
    "obsolete": false
  },
  {
    "code": "FJD",
    "name": "Fiji dollar",
    "numericCode": "242",
    "obsolete": false
  },
  {
    "code": "FKP",
    "name": "Falkland Islands pound",
    "numericCode": "238",
    "obsolete": false
  },
  {
    "code": "GBP",
    "name": "Pound sterling",
    "numericCode": "826",
    "obsolete": false
  },
  {
    "code": "GEL",
    "name": "Georgian lari",
    "numericCode": "981",
    "obsolete": false
  },
  {
    "code": "GHS",
    "name": "Ghanaian cedi",
    "numericCode": "936",
    "obsolete": false
  },
  {
    "code": "GIP",
    "name": "Gibraltar pound",
    "numericCode": "292",
    "obsolete": false
  },
  {
    "code": "GMD",
    "name": "Gambian dalasi",
    "numericCode": "270",
    "obsolete": false
  },
  {
    "code": "GNF",
    "name": "Guinean franc",
    "numericCode": "324",
    "obsolete": false
  },
  {
    "code": "GTQ",
    "name": "Guatemalan quetzal",
    "numericCode": "320",
    "obsolete": false
  },
  {
    "code": "GYD",
    "name": "Guyanese dollar",
    "numericCode": "328",
    "obsolete": false
  },
  {
    "code": "HKD",
    "name": "Hong Kong dollar",
    "numericCode": "344",
    "obsolete": false
  },
  {
    "code": "HNL",
    "name": "Honduran lempira",
    "numericCode": "340",
    "obsolete": false
  },
  {
    "code": "HTG",
    "name": "Haitian gourde",
    "numericCode": "332",
    "obsolete": false
  },
  {
    "code": "HUF",
    "name": "Hungarian forint",
    "numericCode": "348",
    "obsolete": false
  },
  {
    "code": "IDR",
    "name": "Indonesian rupiah",
    "numericCode": "360",
    "obsolete": false
  },
  {
    "code": "ILS",
    "name": "Israeli new shekel",
    "numericCode": "376",
    "obsolete": false
  },
  {
    "code": "INR",
    "name": "Indian rupee",
    "numericCode": "356",
    "obsolete": false
  },
  {
    "code": "IQD",
    "name": "Iraqi dinar",
    "numericCode": "368",
    "obsolete": false
  },
  {
    "code": "IRR",
    "name": "Iranian rial",
    "numericCode": "364",
    "obsolete": false
  },
  {
    "code": "ISK",
    "name": "Icelandic króna",
    "numericCode": "352",
    "obsolete": false
  },
  {
    "code": "JMD",
    "name": "Jamaican dollar",
    "numericCode": "388",
    "obsolete": false
  },
  {
    "code": "JOD",
    "name": "Jordanian dinar",
    "numericCode": "400",
    "obsolete": false
  },
  {
    "code": "JPY",
    "name": "Japanese yen",
    "numericCode": "392",
    "obsolete": false
  },
  {
    "code": "KES",
    "name": "Kenyan shilling",
    "numericCode": "404",
    "obsolete": false
  },
  {
    "code": "KGS",
    "name": "Kyrgyzstani som",
    "numericCode": "417",
    "obsolete": false
  },
  {
    "code": "KHR",
    "name": "Cambodian riel",
    "numericCode": "116",
    "obsolete": false
  },
  {
    "code": "KMF",
    "name": "Comoro franc",
    "numericCode": "174",
    "obsolete": false
  },
  {
    "code": "KPW",
    "name": "North Korean won",
    "numericCode": "408",
    "obsolete": false
  },
  {
    "code": "KRW",
    "name": "South Korean won",
    "numericCode": "410",
    "obsolete": false
  },
  {
    "code": "KWD",
    "name": "Kuwaiti dinar",
    "numericCode": "414",
    "obsolete": false
  },
  {
    "code": "KYD",
    "name": "Cayman Islands dollar",
    "numericCode": "136",
    "obsolete": false
  },
  {
    "code": "KZT",
    "name": "Kazakhstani tenge",
    "numericCode": "398",
    "obsolete": false
  },
  {
    "code": "LAK",
    "name": "Lao kip",
    "numericCode": "418",
    "obsolete": false
  },
  {
    "code": "LBP",
    "name": "Lebanese pound",
    "numericCode": "422",
    "obsolete": false
  },
  {
    "code": "LKR",
    "name": "Sri Lankan rupee",
    "numericCode": "144",
    "obsolete": false
  },
  {
    "code": "LRD",
    "name": "Liberian dollar",
    "numericCode": "430",
    "obsolete": false
  },
  {
    "code": "LSL",
    "name": "Lesotho loti",
    "numericCode": "426",
    "obsolete": false
  },
  {
    "code": "LYD",
    "name": "Libyan dinar",
    "numericCode": "434",
    "obsolete": false
  },
  {
    "code": "MAD",
    "name": "Moroccan dirham",
    "numericCode": "504",
    "obsolete": false
  },
  {
    "code": "MDL",
    "name": "Moldovan leu",
    "numericCode": "498",
    "obsolete": false
  },
  {
    "code": "MGA",
    "name": "Malagasy ariary",
    "numericCode": "969",
    "obsolete": false
  },
  {
    "code": "MKD",
    "name": "Macedonian denar",
    "numericCode": "807",
    "obsolete": false
  },
  {
    "code": "MMK",
    "name": "Myanmar kyat",
    "numericCode": "104",
    "obsolete": false
  },
  {
    "code": "MNT",
    "name": "Mongolian tögrög",
    "numericCode": "496",
    "obsolete": false
  },
  {
    "code": "MOP",
    "name": "Macanese pataca",
    "numericCode": "446",
    "obsolete": false
  },
  {
    "code": "MRU",
    "name": "Mauritanian ouguiya",
    "numericCode": "929",
    "obsolete": false
  },
  {
    "code": "MUR",
    "name": "Mauritian rupee",
    "numericCode": "480",
    "obsolete": false
  },
  {
    "code": "MVR",
    "name": "Maldivian rufiyaa",
    "numericCode": "462",
    "obsolete": false
  },
  {
    "code": "MWK",
    "name": "Malawian kwacha",
    "numericCode": "454",
    "obsolete": false
  },
  {
    "code": "MXN",
    "name": "Mexican peso",
    "numericCode": "484",
    "obsolete": false
  },
  {
    "code": "MYR",
    "name": "Malaysian ringgit",
    "numericCode": "458",
    "obsolete": false
  },
  {
    "code": "MZN",
    "name": "Mozambican metical",
    "numericCode": "943",
    "obsolete": false
  },
  {
    "code": "NAD",
    "name": "Namibian dollar",
    "numericCode": "516",
    "obsolete": false
  },
  {
    "code": "NGN",
    "name": "Nigerian naira",
    "numericCode": "566",
    "obsolete": false
  },
  {
    "code": "NIO",
    "name": "Nicaraguan córdoba",
    "numericCode": "558",
    "obsolete": false
  },
  {
    "code": "NOK",
    "name": "Norwegian krone",
    "numericCode": "578",
    "obsolete": false
  },
  {
    "code": "NPR",
    "name": "Nepalese rupee",
    "numericCode": "524",
    "obsolete": false
  },
  {
    "code": "NZD",
    "name": "New Zealand dollar",
    "numericCode": "554",
    "obsolete": false
  },
  {
    "code": "OMR",
    "name": "Omani rial",
    "numericCode": "512",
    "obsolete": false
  },
  {
    "code": "PAB",
    "name": "Panamanian balboa",
    "numericCode": "590",
    "obsolete": false
  },
  {
    "code": "PEN",
    "name": "Peruvian sol",
    "numericCode": "604",
    "obsolete": false
  },
  {
    "code": "PGK",
    "name": "Papua New Guinean kina",
    "numericCode": "598",
    "obsolete": false
  },
  {
    "code": "PHP",
    "name": "Philippine peso",
    "numericCode": "608",
    "obsolete": false
  },
  {
    "code": "PKR",
    "name": "Pakistani rupee",
    "numericCode": "586",
    "obsolete": false
  },
  {
    "code": "PLN",
    "name": "Polish złoty",
    "numericCode": "985",
    "obsolete": false
  },
  {
    "code": "PYG",
    "name": "Paraguayan guaraní",
    "numericCode": "600",
    "obsolete": false
  },
  {
    "code": "QAR",
    "name": "Qatari riyal",
    "numericCode": "634",
    "obsolete": false
  },
  {
    "code": "RON",
    "name": "Romanian leu",
    "numericCode": "946",
    "obsolete": false
  },
  {
    "code": "RSD",
    "name": "Serbian dinar",
    "numericCode": "941",
    "obsolete": false
  },
  {
    "code": "RUB",
    "name": "Russian ruble",
    "numericCode": "643",
    "obsolete": false
  },
  {
    "code": "RWF",
    "name": "Rwandan franc",
    "numericCode": "646",
    "obsolete": false
  },
  {
    "code": "SAR",
    "name": "Saudi riyal",
    "numericCode": "682",
    "obsolete": false
  },
  {
    "code": "SBD",
    "name": "Solomon Islands dollar",
    "numericCode": "090",
    "obsolete": false
  },
  {
    "code": "SCR",
    "name": "Seychelles rupee",
    "numericCode": "690",
    "obsolete": false
  },
  {
    "code": "SDG",
    "name": "Sudanese pound",
    "numericCode": "938",
    "obsolete": false
  },
  {
    "code": "SEK",
    "name": "Swedish krona",
    "numericCode": "752",
    "obsolete": false
  },
  {
    "code": "SGD",
    "name": "Singapore dollar",
    "numericCode": "702",
    "obsolete": false
  },
  {
    "code": "SHP",
    "name": "Saint Helena pound",
    "numericCode": "654",
    "obsolete": false
  },
  {
    "code": "SLE",
    "name": "Sierra Leonean leone",
    "numericCode": "925",
    "obsolete": false
  },
  {
    "code": "SOS",
    "name": "Somalian shilling",
    "numericCode": "706",
    "obsolete": false
  },
  {
    "code": "SRD",
    "name": "Surinamese dollar",
    "numericCode": "968",
    "obsolete": false
  },
  {
    "code": "SSP",
    "name": "South Sudanese pound",
    "numericCode": "728",
    "obsolete": false
  },
  {
    "code": "STN",
    "name": "São Tomé and Príncipe dobra",
    "numericCode": "930",
    "obsolete": false
  },
  {
    "code": "SVC",
    "name": "Salvadoran colón",
    "numericCode": "222",
    "obsolete": false
  },
  {
    "code": "SYP",
    "name": "Syrian pound",
    "numericCode": "760",
    "obsolete": false
  },
  {
    "code": "SZL",
    "name": "Swazi lilangeni",
    "numericCode": "748",
    "obsolete": false
  },
  {
    "code": "THB",
    "name": "Thai baht",
    "numericCode": "764",
    "obsolete": false
  },
  {
    "code": "TJS",
    "name": "Tajikistani somoni",
    "numericCode": "972",
    "obsolete": false
  },
  {
    "code": "TMT",
    "name": "Turkmenistan manat",
    "numericCode": "934",
    "obsolete": false
  },
  {
    "code": "TND",
    "name": "Tunisian dinar",
    "numericCode": "788",
    "obsolete": false
  },
  {
    "code": "TOP",
    "name": "Tongan paʻanga",
    "numericCode": "776",
    "obsolete": false
  },
  {
    "code": "TRY",
    "name": "Turkish lira",
    "numericCode": "949",
    "obsolete": false
  },
  {
    "code": "TTD",
    "name": "Trinidad and Tobago dollar",
    "numericCode": "780",
    "obsolete": false
  },
  {
    "code": "TWD",
    "name": "New Taiwan dollar",
    "numericCode": "901",
    "obsolete": false
  },
  {
    "code": "TZS",
    "name": "Tanzanian shilling",
    "numericCode": "834",
    "obsolete": false
  },
  {
    "code": "UAH",
    "name": "Ukrainian hryvnia",
    "numericCode": "980",
    "obsolete": false
  },
  {
    "code": "UGX",
    "name": "Ugandan shilling",
    "numericCode": "800",
    "obsolete": false
  },
  {
    "code": "USD",
    "name": "United States dollar",
    "numericCode": "840",
    "obsolete": false
  },
  {
    "code": "UYU",
    "name": "Uruguayan peso",
    "numericCode": "858",
    "obsolete": false
  },
  {
    "code": "UZS",
    "name": "Uzbekistani sum",
    "numericCode": "860",
    "obsolete": false
  },
  {
    "code": "VES",
    "name": "Venezuelan sovereign bolívar",
    "numericCode": "928",
    "obsolete": false
  },
  {
    "code": "VND",
    "name": "Vietnamese đồng",
    "numericCode": "704",
    "obsolete": false
  },
  {
    "code": "VUV",
    "name": "Vanuatu vatu",
    "numericCode": "548",
    "obsolete": false
  },
  {
    "code": "WST",
    "name": "Samoan tala",
    "numericCode": "882",
    "obsolete": false
  },
  {
    "code": "XAF",
    "name": "CFA franc BEAC",
    "numericCode": "950",
    "obsolete": false
  },
  {
    "code": "XCD",
    "name": "East Caribbean dollar",
    "numericCode": "951",
    "obsolete": false
  },
  {
    "code": "XOF",
    "name": "CFA franc BCEAO",
    "numericCode": "952",
    "obsolete": false
  },
  {
    "code": "YER",
    "name": "Yemeni rial",
    "numericCode": "886",
    "obsolete": false
  },
  {
    "code": "ZAR",
    "name": "South African rand",
    "numericCode": "710",
    "obsolete": false
  },
  {
    "code": "ZMW",
    "name": "Zambian kwacha",
    "numericCode": "967",
    "obsolete": false
  },
  {
    "code": "ZWG",
    "name": "Zimbabwe Gold",
    "numericCode": "924",
    "obsolete": false
  }
]

Request

Authorization
API Key
Add parameter in header
Subscription-Key
Example:
Subscription-Key: ********************
or
API Key
Add parameter in query
subscription-key
Example:
subscription-key: ********************
or
Query Params
code
string 
optional
Comma-separated list of currency codes to filter the results (e.g., USD,EUR,GBP)
format
string 
optional
Response format. Allowed values: JSON (default), XML, CSV
header
boolean 
optional
For CSV format only. Include header row if true. Default is false

Responses

🟢200OK
application/json, application/xml, text/csv
List of available currencies
Body
array of:
code
string 
required
name
string 
required
numericCode
string 
required
obsolete
boolean 
required
🟠400Bad Request
Previous
Client libraries
Next
/latest
Built with