/convert

GEThttps://api.globalexchangerates.org/v1/convert

Converts amounts between currencies.

Every request needs your API key, in the Subscription-Key header or the subscription-key query parameter. See Authentication.

Query parameters

Name	Type	Required	Description
`date`	string	No	Date in format YYYY-MM-DD. Must be >= 2024-01-01 (2025-01-01 for GLOBAL)
`base`	string	No	Base currency for rates conversion. Only valid for GLOBAL provider. Default is EUR
`to`	string	No	Comma-separated list of currencies to convert to (e.g., USD,EUR,GBP)
`amount`	number	Yes	The amount to be converted. Mandatory.
`provider`	string	No	Provider code. Default is GLOBAL.
`decimals`	integer	No	Format - int32. Number of decimal places for rates (0-10). Default is 10
`format`	string	No	Response format. Allowed values: JSON (default), XML, CSV
`header`	boolean	No	For CSV format only. Include header row if true. Default is false

Request samples

curl

curl "https://api.globalexchangerates.org/v1/convert?amount=100" \
  -H "Subscription-Key: YOUR_API_KEY"

JavaScript

const response = await fetch("https://api.globalexchangerates.org/v1/convert?amount=100", {
  headers: { "Subscription-Key": "YOUR_API_KEY" },
});
const data = await response.json();

Python

import requests

response = requests.get(
    "https://api.globalexchangerates.org/v1/convert?amount=100",
    headers={"Subscription-Key": "YOUR_API_KEY"},
)
data = response.json()

using var client = new HttpClient();
client.DefaultRequestHeaders.Add("Subscription-Key", "YOUR_API_KEY");
var json = await client.GetStringAsync("https://api.globalexchangerates.org/v1/convert?amount=100");

Responses

200 OK Currency conversion.

Formats: JSON, XML, CSV.

Example (JSON)

{
  "provider": "GLOBAL",
  "date": "2025-04-07",
  "base": "EUR",
  "amount": 1,
  "conversions": {
    "AED": 3.9628755802,
    "AFN": 77.2385,
    "ALL": 98.5618211802,
    "AMD": 422.1071538005,
    "ANG": 1.9327,
    "AOA": 988.9800313588,
    "ARS": 1157.2549184417,
    "AUD": 1.7246645496,
    "AWG": 1.9290669688,
    "AZN": 1.8321557429,
    "BAM": 1.9503972974,
    "BBD": 2.1593492684,
    "BDT": 131.0641334443,
    "BGN": 1.9519177022,
    "BHD": 0.4062112461,
    "BIF": 3163.8274829268,
    "BMD": 1.0800925436,
    "BND": 1.4505352963,
    "BOB": 7.4404495472,
    "BRL": 6.1722093082,
    "BSD": 1.0800921256,
    "BTN": 92.40455331,
    "BWP": 14.7774118804,
    "BYN": 3.5325481777,
    "BZD": 2.1602737284,
    "CAD": 1.5513179655,
    "CDF": 3091.3480441116,
    "CHF": 0.9529992047,
    "CLP": 1023.5471340823,
    "CNY": 7.8374789128,
    "COP": 4504.5804610126,
    "CRC": 538.0121730697,
    "CUP": 25.8912,
    "CVE": 110.257501742,
    "CZK": 24.9109878139,
    "DJF": 191.6332048084,
    "DKK": 7.4491165343,
    "DOP": 67.9140278123,
    "DZD": 143.9502900716,
    "EGP": 54.5449932559,
    "ERN": 16.4474048084,
    "ETB": 141.3726715165,
    "FJD": 2.5013590244,
    "FKP": 0.83665,
    "GBP": 0.8353276134,
    "GEL": 2.9633996441,
    "GHS": 16.7204445992,
    "GIP": 0.83665,
    "GMD": 77.3273728224,
    "GNF": 9296.5018459232,
    "GTQ": 8.2794818234,
    "GYD": 225.5468825784,
    "HKD": 8.3916999587,
    "HNL": 27.4889997598,
    "HTG": 140.8153,
    "HUF": 402.0135749197,
    "IDR": 17927.3255881922,
    "ILS": 3.9987538408,
    "INR": 92.2164737401,
    "IQD": 1415.1518715516,
    "IRR": 739520,
    "ISK": 142.8618569866,
    "JMD": 169.7343754008,
    "JOD": 0.7659639894,
    "JPY": 161.1618241989,
    "KES": 139.337553149,
    "KGS": 93.515031568,
    "KHR": 4302.0803024953,
    "KMF": 492.3490681184,
    "KPW": 2.3734,
    "KRW": 1588.1088514673,
    "KWD": 0.3324738628,
    "KYD": 0.8852001491,
    "KZT": 543.0462935055,
    "LAK": 22724.700305712,
    "LBP": 96393.7288541319,
    "LKR": 319.5184148716,
    "LRD": 214.9984021604,
    "LSL": 19.7999886968,
    "LYD": 5.1937635931,
    "MAD": 10.3771559457,
    "MDL": 19.339924215,
    "MGA": 5007.2515818816,
    "MKD": 61.3744484611,
    "MMK": 2267.6507002993,
    "MNT": 3769.4589965156,
    "MOP": 8.6539886412,
    "MRU": 42.9597144252,
    "MUR": 48.9951116237,
    "MVR": 16.6775654005,
    "MWK": 1865.3618539372,
    "MXN": 22.0834663736,
    "MYR": 4.7836323747,
    "MZN": 68.7220104712,
    "NAD": 19.8067664808,
    "NGN": 1654.6238708736,
    "NIO": 39.66464223,
    "NOK": 11.3209663427,
    "NPR": 148.0246761367,
    "NZD": 1.8985809303,
    "OMR": 0.4150590278,
    "PAB": 1.0698361963,
    "PEN": 3.9545283009,
    "PGK": 4.3599760841,
    "PHP": 61.8230320575,
    "PKR": 302.2136291971,
    "PLN": 4.1785224675,
    "PYG": 8624.4710801392,
    "QAR": 3.9299811014,
    "RON": 4.9669282158,
    "RSD": 116.8026792996,
    "RUB": 91.2702172751,
    "RWF": 1521.8257331708,
    "SAR": 4.0468885628,
    "SBD": 8.9975,
    "SCR": 15.8582707692,
    "SDG": 647.8260687377,
    "SEK": 10.8118785839,
    "SGD": 1.4482878166,
    "SHP": 0.83665,
    "SLE": 24.5745,
    "SOS": 616.394,
    "SRD": 39.2669783972,
    "SSP": 4804.3309,
    "STN": 24.5,
    "SVC": 9.4506455052,
    "SYP": 13270.0686950354,
    "SZL": 19.8038375608,
    "THB": 36.7405305939,
    "TJS": 11.75292921,
    "TMT": 3.7784763621,
    "TND": 3.3483325384,
    "TOP": 2.5636890592,
    "TRY": 40.8676123869,
    "TTD": 7.3067939749,
    "TWD": 35.8512944271,
    "TZS": 2837.4686876354,
    "UAH": 44.6180393715,
    "UGX": 3948.9326589467,
    "USD": 1.0789549802,
    "UYU": 45.3833932001,
    "UZS": 13960.0618301697,
    "VES": 74.9069140535,
    "VND": 27617.8620039793,
    "VUV": 132.57,
    "WST": 3.0026698256,
    "XAF": 655.6097540068,
    "XCD": 2.9118890592,
    "XOF": 655.1754682928,
    "YER": 265.1763727589,
    "ZAR": 19.7963071074,
    "ZMW": 30.3641222129,
    "ZWG": 28.8816
  }
}

400 Bad Request Invalid request