Global Exchange Rates
HomeDocsDeveloper API Portal
HomeDocsDeveloper API Portal
  1. Exchange Rates
  • 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. Exchange Rates

/historical

GET
https://api.globalexchangerates.org/v1/historical
Exchange Rates
Returns historical exchange rates for a specific date and provider.
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.globalexchangerates.org/v1/historical?date&latest&provider&currencies&base&decimals&format&header' \
--header 'Subscription-Key;'
Response Response Example
200 - Success
{
  "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
  }
}

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
date
string <YYYY-MM-DD>
required
Date in format YYYY-MM-DD. Must be >= 2024-01-01 (2025-01-01 for GLOBAL)
latest
boolean 
optional
If true, returns latest available rates up to specified date. If false, returns rates only for exact date. Default is true
provider
string 
optional
Provider code. Default is GLOBAL.
currencies
string 
optional
Comma-separated list of currencies to include (e.g., USD,EUR,GBP)
base
string 
optional
Base currency for rates conversion. Only valid for GLOBAL provider. Default is EUR
decimals
integer <int32>
optional
Format - int32. Number of decimal places for rates (0-10). Default is 10
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
Exchange rates for the specified date and provider
Body
provider
string 
optional
date
string <date-time>
optional
base
string 
optional
exchangeRates
object 
optional
Additional properties
number <double>
optional
🟠400Bad Request
Previous
/latest
Next
/providers
Built with