/historical
GET
https://api.globalexchangerates.org/v1/historicalReturns historical exchange rates for a specific date and provider.
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 | Yes | Date in format YYYY-MM-DD. Must be >= 2024-01-01 (2025-01-01 for GLOBAL) |
latest | boolean | No | If true, returns latest available rates up to specified date. If false, returns rates only for exact date. Default is true |
provider | string | No | Provider code. Default is GLOBAL. |
currencies | string | No | Comma-separated list of currencies to include (e.g., USD,EUR,GBP) |
base | string | No | Base currency for rates conversion. Only valid for GLOBAL provider. Default is EUR |
decimals | integer (int32) | 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 |
extended | boolean | No | Returns the extended format with Bid and Ask rates when supported. Default is false |
type | string: mid, bid, ask | No | The type (mid, bid or ask) of rate that will be returned, when supported by the provider. Not available in the extended format. |
Try it
Send a real request with your API key. It goes from your browser straight to the API, and the key is kept only in this browser tab. No API key yet? Start a free trial.
Request samples
curl "https://api.globalexchangerates.org/v1/historical?date=2025-01-02" \
-H "Subscription-Key: YOUR_API_KEY"const response = await fetch("https://api.globalexchangerates.org/v1/historical?date=2025-01-02", {
headers: { "Subscription-Key": "YOUR_API_KEY" },
});
const data = await response.json();import requests
response = requests.get(
"https://api.globalexchangerates.org/v1/historical?date=2025-01-02",
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/historical?date=2025-01-02");Responses
200 OK Exchange rates for the specified date and provider
{
"provider": "GLOBAL",
"date": "2025-04-01",
"base": "EUR",
"exchangeRates": {
"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
}
}{
"provider": "GLOBAL",
"date": "2025-09-08",
"base": "EUR",
"exchangeRates": [
{
"currency": "AED",
"mid": 4.2952304674,
"bid": 0,
"ask": 0
},
{
"currency": "AFN",
"mid": 79.5949500157,
"bid": 0,
"ask": 0
},
{
"currency": "ALL",
"mid": 96.7777662513,
"bid": 0,
"ask": 0
},
{
"currency": "AMD",
"mid": 448.1216888647,
"bid": 0,
"ask": 0
},
{
"currency": "AOA",
"mid": 1073.6282760564,
"bid": 0,
"ask": 0
},
{
"currency": "ARS",
"mid": 1603.6634072006,
"bid": 0,
"ask": 0
},
{
"currency": "AUD",
"mid": 1.7797480115,
"bid": 0,
"ask": 0
},
{
"currency": "AWG",
"mid": 2.0933595469,
"bid": 0,
"ask": 0
},
{
"currency": "AZN",
"mid": 1.9881068322,
"bid": 0,
"ask": 0
},
{
"currency": "BAM",
"mid": 1.95583,
"bid": 1.95583,
"ask": 1.95583
},
{
"currency": "BBD",
"mid": 2.3389492144,
"bid": 0,
"ask": 0
},
{
"currency": "BDT",
"mid": 142.1078230392,
"bid": 0,
"ask": 0
},
{
"currency": "BGN",
"mid": 1.95583,
"bid": 1.95583,
"ask": 1.95583
},
{
"currency": "BHD",
"mid": 0.4402750391,
"bid": 0,
"ask": 0
},
{
"currency": "BIF",
"mid": 3461.0998394368,
"bid": 0,
"ask": 0
},
{
"currency": "BMD",
"mid": 1.1694746072,
"bid": 0,
"ask": 0
},
{
"currency": "BND",
"mid": 1.5019956593,
"bid": 0,
"ask": 0
},
{
"currency": "BOB",
"mid": 8.0761554928,
"bid": 0,
"ask": 0
},
{
"currency": "BRL",
"mid": 6.3388368525,
"bid": 0,
"ask": 0
},
{
"currency": "BSD",
"mid": 1.1694746072,
"bid": 0,
"ask": 0
},
{
"currency": "BTN",
"mid": 102.8740732059,
"bid": 0,
"ask": 0
},
{
"currency": "BWP",
"mid": 16.5933695723,
"bid": 0,
"ask": 0
},
{
"currency": "BYN",
"mid": 3.9582123956,
"bid": 0,
"ask": 0
},
{
"currency": "BZD",
"mid": 2.3389492144,
"bid": 0,
"ask": 0
},
{
"currency": "CAD",
"mid": 1.6167896285,
"bid": 0,
"ask": 0
},
{
"currency": "CDF",
"mid": 3364.0136492956,
"bid": 0,
"ask": 0
},
{
"currency": "CHF",
"mid": 0.9328264639,
"bid": 0,
"ask": 0
},
{
"currency": "CLP",
"mid": 1129.276800738,
"bid": 0,
"ask": 0
},
{
"currency": "CNY",
"mid": 8.3376631807,
"bid": 0,
"ask": 0
},
{
"currency": "COP",
"mid": 4631.3503555513,
"bid": 0,
"ask": 0
},
{
"currency": "CRC",
"mid": 590.9290641069,
"bid": 0,
"ask": 0
},
{
"currency": "CUP",
"mid": 28.1472,
"bid": 0,
"ask": 0
},
{
"currency": "CVE",
"mid": 110.265,
"bid": 110.265,
"ask": 110.265
},
{
"currency": "CZK",
"mid": 24.3199259063,
"bid": 0,
"ask": 0
},
{
"currency": "DJF",
"mid": 207.8401966662,
"bid": 0,
"ask": 0
},
{
"currency": "DKK",
"mid": 7.4458608258,
"bid": 0,
"ask": 0
},
{
"currency": "DOP",
"mid": 74.1419468441,
"bid": 0,
"ask": 0
},
{
"currency": "DZD",
"mid": 151.390946647,
"bid": 0,
"ask": 0
},
{
"currency": "EGP",
"mid": 56.6588139397,
"bid": 0,
"ask": 0
},
{
"currency": "ERN",
"mid": 17.542119108,
"bid": 0,
"ask": 0
},
{
"currency": "ETB",
"mid": 166.8063280773,
"bid": 0,
"ask": 0
},
{
"currency": "FJD",
"mid": 2.6508785916,
"bid": 0,
"ask": 0
},
{
"currency": "FKP",
"mid": 0.8654762046,
"bid": 0,
"ask": 0
},
{
"currency": "GBP",
"mid": 0.8654762046,
"bid": 0,
"ask": 0
},
{
"currency": "GEL",
"mid": 3.1363674495,
"bid": 0,
"ask": 0
},
{
"currency": "GHS",
"mid": 14.0554371832,
"bid": 0,
"ask": 0
},
{
"currency": "GIP",
"mid": 0.8654762046,
"bid": 0,
"ask": 0
},
{
"currency": "GMD",
"mid": 84.0705915492,
"bid": 0,
"ask": 0
},
{
"currency": "GNF",
"mid": 10126.975525634,
"bid": 0,
"ask": 0
},
{
"currency": "GTQ",
"mid": 8.927851187,
"bid": 0,
"ask": 0
},
{
"currency": "GYD",
"mid": 244.6568777464,
"bid": 0,
"ask": 0
},
{
"currency": "HKD",
"mid": 9.1136245112,
"bid": 0,
"ask": 0
},
{
"currency": "HNL",
"mid": 30.4920458855,
"bid": 0,
"ask": 0
},
{
"currency": "HTG",
"mid": 153.2195,
"bid": 0,
"ask": 0
},
{
"currency": "HUF",
"mid": 392.3872300028,
"bid": 0,
"ask": 0
},
{
"currency": "IDR",
"mid": 19200.6278916997,
"bid": 0,
"ask": 0
},
{
"currency": "ILS",
"mid": 3.893596471,
"bid": 0,
"ask": 0
},
{
"currency": "INR",
"mid": 102.8740732059,
"bid": 0,
"ask": 0
},
{
"currency": "IQD",
"mid": 1536.4269097396,
"bid": 0,
"ask": 0
},
{
"currency": "ISK",
"mid": 142.8293228085,
"bid": 0,
"ask": 0
},
{
"currency": "JMD",
"mid": 187.508598028,
"bid": 0,
"ask": 0
},
{
"currency": "JOD",
"mid": 0.8307398278,
"bid": 0,
"ask": 0
},
{
"currency": "JPY",
"mid": 172.9025251164,
"bid": 0,
"ask": 0
},
{
"currency": "KES",
"mid": 150.9139187264,
"bid": 0,
"ask": 0
},
{
"currency": "KGS",
"mid": 102.5057977464,
"bid": 0,
"ask": 0
},
{
"currency": "KHR",
"mid": 4682.2088885791,
"bid": 0,
"ask": 0
},
{
"currency": "KMF",
"mid": 491.96775,
"bid": 491.96775,
"ask": 491.96775
},
{
"currency": "KRW",
"mid": 1622.7927035723,
"bid": 0,
"ask": 0
},
{
"currency": "KWD",
"mid": 0.3569965243,
"bid": 0,
"ask": 0
},
{
"currency": "KYD",
"mid": 0.9615932259,
"bid": 0,
"ask": 0
},
{
"currency": "KZT",
"mid": 627.169507579,
"bid": 0,
"ask": 0
},
{
"currency": "LAK",
"mid": 24506.104112676,
"bid": 0,
"ask": 0
},
{
"currency": "LBP",
"mid": 104526.5596001384,
"bid": 0,
"ask": 0
},
{
"currency": "LKR",
"mid": 353.1975068843,
"bid": 0,
"ask": 0
},
{
"currency": "LRD",
"mid": 234.4409225352,
"bid": 0,
"ask": 0
},
{
"currency": "LSL",
"mid": 20.5628970619,
"bid": 0,
"ask": 0
},
{
"currency": "LYD",
"mid": 6.3314208136,
"bid": 0,
"ask": 0
},
{
"currency": "MAD",
"mid": 10.6042336983,
"bid": 0,
"ask": 0
},
{
"currency": "MDL",
"mid": 19.5227312233,
"bid": 0,
"ask": 0
},
{
"currency": "MGA",
"mid": 5223.378394366,
"bid": 0,
"ask": 0
},
{
"currency": "MKD",
"mid": 61.3812999559,
"bid": 0,
"ask": 0
},
{
"currency": "MMK",
"mid": 2459.2558950691,
"bid": 0,
"ask": 0
},
{
"currency": "MNT",
"mid": 4212.8229295776,
"bid": 0,
"ask": 0
},
{
"currency": "MOP",
"mid": 9.3870332465,
"bid": 0,
"ask": 0
},
{
"currency": "MRU",
"mid": 46.7301442252,
"bid": 0,
"ask": 0
},
{
"currency": "MUR",
"mid": 53.6681375513,
"bid": 0,
"ask": 0
},
{
"currency": "MVR",
"mid": 18.0746078872,
"bid": 0,
"ask": 0
},
{
"currency": "MWK",
"mid": 2024.57622,
"bid": 0,
"ask": 0
},
{
"currency": "MXN",
"mid": 21.8574559695,
"bid": 0,
"ask": 0
},
{
"currency": "MYR",
"mid": 4.9344042601,
"bid": 0,
"ask": 0
},
{
"currency": "MZN",
"mid": 74.5347605632,
"bid": 0,
"ask": 0
},
{
"currency": "NAD",
"mid": 20.5628970619,
"bid": 0,
"ask": 0
},
{
"currency": "NGN",
"mid": 1773.7493266163,
"bid": 0,
"ask": 0
},
{
"currency": "NIO",
"mid": 43.0460738028,
"bid": 0,
"ask": 0
},
{
"currency": "NOK",
"mid": 11.6959333103,
"bid": 0,
"ask": 0
},
{
"currency": "NPR",
"mid": 164.5985171294,
"bid": 0,
"ask": 0
},
{
"currency": "NZD",
"mid": 1.9782538503,
"bid": 0,
"ask": 0
},
{
"currency": "OMR",
"mid": 0.4500012245,
"bid": 0,
"ask": 0
},
{
"currency": "PAB",
"mid": 1.1694746072,
"bid": 0,
"ask": 0
},
{
"currency": "PEN",
"mid": 4.1177966317,
"bid": 0,
"ask": 0
},
{
"currency": "PGK",
"mid": 4.826227324,
"bid": 0,
"ask": 0
},
{
"currency": "PHP",
"mid": 66.4005388356,
"bid": 0,
"ask": 0
},
{
"currency": "PKR",
"mid": 331.181291282,
"bid": 0,
"ask": 0
},
{
"currency": "PLN",
"mid": 4.2403669585,
"bid": 0,
"ask": 0
},
{
"currency": "PYG",
"mid": 8394.2413802816,
"bid": 0,
"ask": 0
},
{
"currency": "QAR",
"mid": 4.2561262444,
"bid": 0,
"ask": 0
},
{
"currency": "RON",
"mid": 5.0622183793,
"bid": 0,
"ask": 0
},
{
"currency": "RSD",
"mid": 116.9265476024,
"bid": 0,
"ask": 0
},
{
"currency": "RUB",
"mid": 95.2492919216,
"bid": 0,
"ask": 0
},
{
"currency": "RWF",
"mid": 1693.2728923944,
"bid": 0,
"ask": 0
},
{
"currency": "SAR",
"mid": 4.3889885874,
"bid": 0,
"ask": 0
},
{
"currency": "SBD",
"mid": 9.6686,
"bid": 0,
"ask": 0
},
{
"currency": "SCR",
"mid": 17.2788977464,
"bid": 0,
"ask": 0
},
{
"currency": "SDG",
"mid": 704.1160166258,
"bid": 0,
"ask": 0
},
{
"currency": "SEK",
"mid": 10.9687361181,
"bid": 0,
"ask": 0
},
{
"currency": "SGD",
"mid": 1.5019956593,
"bid": 0,
"ask": 0
},
{
"currency": "SHP",
"mid": 0.8654762046,
"bid": 0,
"ask": 0
},
{
"currency": "SLE",
"mid": 27.248,
"bid": 0,
"ask": 0
},
{
"currency": "SOS",
"mid": 670.2317,
"bid": 0,
"ask": 0
},
{
"currency": "SRD",
"mid": 45.2905661972,
"bid": 0,
"ask": 0
},
{
"currency": "SSP",
"mid": 5319.2075,
"bid": 0,
"ask": 0
},
{
"currency": "STN",
"mid": 24.5,
"bid": 24.5,
"ask": 24.5
},
{
"currency": "SVC",
"mid": 10.232902813,
"bid": 0,
"ask": 0
},
{
"currency": "SYP",
"mid": 13542.3290638298,
"bid": 0,
"ask": 0
},
{
"currency": "SZL",
"mid": 20.5628970619,
"bid": 0,
"ask": 0
},
{
"currency": "THB",
"mid": 37.3415235301,
"bid": 0,
"ask": 0
},
{
"currency": "TJS",
"mid": 11.0314934281,
"bid": 0,
"ask": 0
},
{
"currency": "TMT",
"mid": 4.0931611252,
"bid": 0,
"ask": 0
},
{
"currency": "TND",
"mid": 3.391690211,
"bid": 0,
"ask": 0
},
{
"currency": "TOP",
"mid": 2.70334,
"bid": 0,
"ask": 0
},
{
"currency": "TRY",
"mid": 48.2753935995,
"bid": 0,
"ask": 0
},
{
"currency": "TTD",
"mid": 7.9309231217,
"bid": 0,
"ask": 0
},
{
"currency": "TWD",
"mid": 35.6556282763,
"bid": 0,
"ask": 0
},
{
"currency": "TZS",
"mid": 2932.188605577,
"bid": 0,
"ask": 0
},
{
"currency": "UAH",
"mid": 48.2030678226,
"bid": 0,
"ask": 0
},
{
"currency": "UGX",
"mid": 4116.5120523426,
"bid": 0,
"ask": 0
},
{
"currency": "USD",
"mid": 1.1694746072,
"bid": 0,
"ask": 0
},
{
"currency": "UYU",
"mid": 46.8446188084,
"bid": 0,
"ask": 0
},
{
"currency": "UZS",
"mid": 14639.231827187,
"bid": 0,
"ask": 0
},
{
"currency": "VES",
"mid": 179.6070623934,
"bid": 0,
"ask": 0
},
{
"currency": "VND",
"mid": 30921.8914955746,
"bid": 0,
"ask": 0
},
{
"currency": "VUV",
"mid": 140.07,
"bid": 0,
"ask": 0
},
{
"currency": "WST",
"mid": 3.2058974648,
"bid": 0,
"ask": 0
},
{
"currency": "XAF",
"mid": 655.957,
"bid": 655.957,
"ask": 655.957
},
{
"currency": "XCD",
"mid": 3.1575814394,
"bid": 0,
"ask": 0
},
{
"currency": "XCG",
"mid": 2.0933595469,
"bid": 0,
"ask": 0
},
{
"currency": "XOF",
"mid": 655.957,
"bid": 655.957,
"ask": 655.957
},
{
"currency": "XPF",
"mid": 119.3317,
"bid": 119.3317,
"ask": 119.3317
},
{
"currency": "YER",
"mid": 281.1972278778,
"bid": 0,
"ask": 0
},
{
"currency": "ZAR",
"mid": 20.5628970619,
"bid": 0,
"ask": 0
},
{
"currency": "ZMW",
"mid": 28.0701130094,
"bid": 0,
"ask": 0
},
{
"currency": "ZWG",
"mid": 31.3302,
"bid": 0,
"ask": 0
}
]
}400 Bad Request Invalid request
{
"message": "error message",
"errorCode": 1001
}