{ "openapi": "3.0.3", "info": { "title": "Global Exchange Rates API", "version": "1.0" }, "servers": [ { "url": "https://api.globalexchangerates.org/v1" } ], "security": [ { "apiKeyHeader": [] }, { "apiKeyQuery": [] } ], "tags": [ { "name": "Currencies" }, { "name": "Exchange Rates" }, { "name": "Providers" }, { "name": "Conversion" } ], "paths": { "/currencies": { "get": { "summary": "/currencies", "deprecated": false, "description": "Returns the list of available currencies.", "operationId": "currencies", "tags": [ "Currencies" ], "parameters": [ { "name": "code", "in": "query", "description": "Comma-separated list of currency codes to filter the results (e.g., USD,EUR,GBP)", "required": false, "schema": { "type": "string" } }, { "name": "format", "in": "query", "description": "Response format. Allowed values: JSON (default), XML, CSV", "required": false, "schema": { "type": "string" } }, { "name": "header", "in": "query", "description": "For CSV format only. Include header row if true. Default is false", "required": false, "schema": { "type": "boolean" } } ], "responses": { "200": { "description": "List of available currencies", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string" }, "name": { "type": "string" }, "numericCode": { "type": "string" }, "obsolete": { "type": "boolean" } }, "required": [ "code", "name", "numericCode", "obsolete" ] } }, "example": [ { "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 } ] }, "application/xml": { "schema": { "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string" }, "name": { "type": "string" }, "numericCode": { "type": "string" }, "obsolete": { "type": "boolean" } }, "required": [ "code", "name", "numericCode", "obsolete" ] } } }, "text/csv": { "schema": { "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string" }, "name": { "type": "string" }, "numericCode": { "type": "string" }, "obsolete": { "type": "boolean" } }, "required": [ "code", "name", "numericCode", "obsolete" ] } } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string" }, "errorCode": { "type": "integer" } } }, "example": { "message": "error message", "errorCode": 1001 } }, "application/xml": { "schema": { "type": "object", "properties": { "message": { "type": "string" }, "errorCode": { "type": "integer" } } } }, "text/csv": { "schema": { "type": "object", "properties": { "message": { "type": "string" }, "errorCode": { "type": "integer" } } } } } } } } }, "/latest": { "get": { "summary": "/latest", "deprecated": false, "description": "Returns the latest exchange rates for the specified provider. If no provider is specified, exchange rates from the GLOBAL provider will be returned.", "operationId": "latest", "tags": [ "Exchange Rates" ], "parameters": [ { "name": "provider", "in": "query", "description": "Provider code. Default is GLOBAL", "required": false, "schema": { "type": "string" } }, { "name": "currencies", "in": "query", "description": "Comma-separated list of currencies to include (e.g., USD,EUR,GBP)", "required": false, "schema": { "type": "string" } }, { "name": "base", "in": "query", "description": "Base currency for rates conversion. Only valid for GLOBAL provider. Default is EUR", "required": false, "schema": { "type": "string" } }, { "name": "decimals", "in": "query", "description": "Number of decimal places for rates (0-10). Default is 10", "required": false, "schema": { "type": "integer", "format": "int32" } }, { "name": "format", "in": "query", "description": "Response format. Allowed values: JSON (default), XML, CSV", "required": false, "schema": { "type": "string" } }, { "name": "header", "in": "query", "description": "For CSV format only. Include header row if true. Default is false", "required": false, "schema": { "type": "boolean" } }, { "name": "extended", "in": "query", "description": "Returns the extended format with Bid and Ask rates when supported. Default is false", "required": false, "schema": { "type": "boolean" } }, { "name": "type", "in": "query", "description": "The type (mid, bid or ask) of rate that will be returned, when supported by the provider. Not available in the extended format.", "required": false, "schema": { "type": "string", "enum": [ "mid", "bid", "ask" ] } } ], "responses": { "200": { "description": "Latest exchange rates available for the specified provider", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/exchangeRateResponse" }, "examples": { "standard": { "summary": "Standard", "value": { "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 } } }, "extended": { "summary": "Extended", "value": { "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 } ] } } } }, "application/xml": { "schema": { "$ref": "#/components/schemas/exchangeRateResponse" } }, "text/csv": { "schema": { "$ref": "#/components/schemas/exchangeRateResponse" } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorResponse" }, "example": { "message": "error message", "errorCode": 1001 } }, "application/xml": { "schema": { "$ref": "#/components/schemas/errorResponse" } }, "text/csv": { "schema": { "$ref": "#/components/schemas/errorResponse" } } } } } } }, "/historical": { "get": { "summary": "/historical", "deprecated": false, "description": "Returns historical exchange rates for a specific date and provider.", "operationId": "historical", "tags": [ "Exchange Rates" ], "parameters": [ { "name": "date", "in": "query", "description": "Date in format YYYY-MM-DD. Must be >= 2024-01-01 (2025-01-01 for GLOBAL)", "required": true, "schema": { "type": "string", "format": "YYYY-MM-DD" } }, { "name": "latest", "in": "query", "description": "If true, returns latest available rates up to specified date. If false, returns rates only for exact date. Default is true", "required": false, "schema": { "type": "boolean" } }, { "name": "provider", "in": "query", "description": "Provider code. Default is GLOBAL.", "required": false, "schema": { "type": "string" } }, { "name": "currencies", "in": "query", "description": "Comma-separated list of currencies to include (e.g., USD,EUR,GBP)", "required": false, "schema": { "type": "string" } }, { "name": "base", "in": "query", "description": "Base currency for rates conversion. Only valid for GLOBAL provider. Default is EUR", "required": false, "schema": { "type": "string" } }, { "name": "decimals", "in": "query", "description": "Format - int32. Number of decimal places for rates (0-10). Default is 10", "required": false, "schema": { "type": "integer", "format": "int32" } }, { "name": "format", "in": "query", "description": "Response format. Allowed values: JSON (default), XML, CSV", "required": false, "schema": { "type": "string" } }, { "name": "header", "in": "query", "description": "For CSV format only. Include header row if true. Default is false", "required": false, "schema": { "type": "boolean" } }, { "name": "extended", "in": "query", "description": "Returns the extended format with Bid and Ask rates when supported. Default is false", "required": false, "schema": { "type": "boolean" } }, { "name": "type", "in": "query", "description": "The type (mid, bid or ask) of rate that will be returned, when supported by the provider. Not available in the extended format.", "required": false, "schema": { "type": "string", "enum": [ "mid", "bid", "ask" ] } } ], "responses": { "200": { "description": "Exchange rates for the specified date and provider", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/exchangeRateResponse" }, "examples": { "standard": { "summary": "Standard", "value": { "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 } } }, "extended": { "summary": "Extended", "value": { "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 } ] } } } }, "application/xml": { "schema": { "$ref": "#/components/schemas/exchangeRateResponse" } }, "text/csv": { "schema": { "$ref": "#/components/schemas/exchangeRateResponse" } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorResponse" }, "example": { "message": "error message", "errorCode": 1001 } }, "application/xml": { "schema": { "$ref": "#/components/schemas/errorResponse" } }, "text/csv": { "schema": { "$ref": "#/components/schemas/errorResponse" } } } } } } }, "/providers": { "get": { "summary": "/providers", "deprecated": false, "description": "Returns the list of available exchange rate providers.", "operationId": "providers", "tags": [ "Providers" ], "parameters": [ { "name": "code", "in": "query", "description": "Comma-separated list of provider codes to filter the results (e.g. ECB)", "required": false, "schema": { "type": "string" } }, { "name": "countryCode", "in": "query", "description": "Two-letter ISO country code to filter providers by country", "required": false, "schema": { "type": "string" } }, { "name": "format", "in": "query", "description": "Response format. Allowed values: JSON (default), XML, CSV", "required": false, "schema": { "type": "string" } }, { "name": "header", "in": "query", "description": "For CSV format only. Include header row if true. Default is false", "required": false, "schema": { "type": "boolean" } } ], "responses": { "200": { "description": "List of available providers", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string" }, "description": { "type": "string" }, "country": { "type": "string" }, "referenceCurrency": { "type": "string" }, "timeSeries": { "type": "boolean", "description": "Indicates whether the provider supports historical exchange rates." }, "monthly": { "type": "boolean", "description": "Indicates whether the provider only supports monthly exchange rates." }, "countryCode": { "type": "string" }, "bidAsk": { "type": "boolean", "description": "Indicates whether the provider supports Bid/Ask rates in addition to Mid rates. Bid/Ask values are returned when using the extended parameter to retrieve exchange rates." }, "obsolete": { "type": "boolean" } }, "required": [ "code", "description", "country", "referenceCurrency", "timeSeries", "monthly", "countryCode", "bidAsk", "obsolete" ] } } }, "application/xml": { "schema": { "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string" }, "description": { "type": "string" }, "country": { "type": "string" }, "referenceCurrency": { "type": "string" }, "timeSeries": { "type": "boolean", "description": "Indicates whether the provider supports historical exchange rates." }, "monthly": { "type": "boolean", "description": "Indicates whether the provider only supports monthly exchange rates." }, "countryCode": { "type": "string" }, "bidAsk": { "type": "boolean", "description": "Indicates whether the provider supports Bid/Ask rates in addition to Mid rates. Bid/Ask values are returned when using the extended parameter to retrieve exchange rates." }, "obsolete": { "type": "boolean" } }, "required": [ "code", "description", "country", "referenceCurrency", "timeSeries", "monthly", "countryCode", "bidAsk", "obsolete" ] } } }, "text/csv": { "schema": { "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string" }, "description": { "type": "string" }, "country": { "type": "string" }, "referenceCurrency": { "type": "string" }, "timeSeries": { "type": "boolean", "description": "Indicates whether the provider supports historical exchange rates." }, "monthly": { "type": "boolean", "description": "Indicates whether the provider only supports monthly exchange rates." }, "countryCode": { "type": "string" }, "bidAsk": { "type": "boolean", "description": "Indicates whether the provider supports Bid/Ask rates in addition to Mid rates. Bid/Ask values are returned when using the extended parameter to retrieve exchange rates." }, "obsolete": { "type": "boolean" } }, "required": [ "code", "description", "country", "referenceCurrency", "timeSeries", "monthly", "countryCode", "bidAsk", "obsolete" ] } } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorResponse" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/errorResponse" } }, "text/csv": { "schema": { "$ref": "#/components/schemas/errorResponse" } } } } } } }, "/convert": { "get": { "summary": "/convert", "deprecated": false, "description": "Converts amounts between currencies.", "operationId": "convert", "tags": [ "Conversion" ], "parameters": [ { "name": "date", "in": "query", "description": "Date in format YYYY-MM-DD. Must be >= 2024-01-01 (2025-01-01 for GLOBAL)", "required": false, "schema": { "type": "string", "format": "YYYY-MM-DD" } }, { "name": "base", "in": "query", "description": "Base currency for rates conversion. Only valid for GLOBAL provider. Default is EUR", "required": false, "schema": { "type": "string" } }, { "name": "to", "in": "query", "description": "Comma-separated list of currencies to convert to (e.g., USD,EUR,GBP)", "required": false, "schema": { "type": "string" } }, { "name": "amount", "in": "query", "description": "The amount to be converted. Mandatory.", "required": true, "schema": { "type": "number" } }, { "name": "provider", "in": "query", "description": "Provider code. Default is GLOBAL.", "required": false, "schema": { "type": "string" } }, { "name": "decimals", "in": "query", "description": "Format - int32. Number of decimal places for rates (0-10). Default is 10", "required": false, "schema": { "type": "integer" } }, { "name": "format", "in": "query", "description": "Response format. Allowed values: JSON (default), XML, CSV", "required": false, "schema": { "type": "string" } }, { "name": "header", "in": "query", "description": "For CSV format only. Include header row if true. Default is false", "required": false, "schema": { "type": "boolean" } } ], "responses": { "200": { "description": "Currency conversion.", "content": { "application/json": { "schema": { "type": "object", "properties": { "provider": { "type": "string" }, "date": { "type": "string" }, "base": { "type": "string" }, "amount": { "type": "integer" }, "conversions": { "type": "object", "properties": {}, "nullable": true } }, "required": [ "provider", "date", "base", "amount", "conversions" ] }, "example": { "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 } } }, "application/xml": { "schema": { "type": "object", "properties": { "provider": { "type": "string" }, "date": { "type": "string" }, "base": { "type": "string" }, "amount": { "type": "integer" }, "conversions": { "type": "object", "properties": {}, "nullable": true } }, "required": [ "provider", "date", "base", "amount", "conversions" ] } }, "text/csv": { "schema": { "type": "object", "properties": { "provider": { "type": "string" }, "date": { "type": "string" }, "base": { "type": "string" }, "amount": { "type": "integer" }, "conversions": { "type": "object", "properties": {}, "nullable": true } }, "required": [ "provider", "date", "base", "amount", "conversions" ] } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string" }, "errorCode": { "type": "integer" } }, "required": [ "message", "errorCode" ] }, "example": { "message": "error message", "errorCode": 1001 } }, "application/xml": { "schema": { "type": "object", "properties": { "message": { "type": "string" }, "errorCode": { "type": "integer" } }, "required": [ "message", "errorCode" ] } }, "text/csv": { "schema": { "type": "object", "properties": { "message": { "type": "string" }, "errorCode": { "type": "integer" } }, "required": [ "message", "errorCode" ] } } } } } } } }, "components": { "securitySchemes": { "apiKeyHeader": { "type": "apiKey", "name": "Subscription-Key", "in": "header" }, "apiKeyQuery": { "type": "apiKey", "name": "subscription-key", "in": "query" } }, "schemas": { "exchangeRateResponse": { "type": "object", "properties": { "provider": { "type": "string" }, "date": { "type": "string", "format": "date-time" }, "base": { "type": "string" }, "exchangeRates": { "type": "object", "additionalProperties": { "type": "number", "format": "double" }, "properties": {} } } }, "errorResponse": { "type": "object", "properties": { "message": { "type": "string" }, "errorCode": { "type": "integer", "format": "int32" } } }, "currency": { "type": "object", "properties": { "code": { "type": "string" }, "name": { "type": "string" }, "numericCode": { "type": "string" }, "obsolete": { "type": "boolean" } } }, "provider": { "type": "object", "properties": { "code": { "type": "string" }, "description": { "type": "string" }, "country": { "type": "string" }, "referenceCurrency": { "type": "string" }, "timeSeries": { "type": "boolean" }, "monthly": { "type": "boolean" }, "countryCode": { "type": "string" }, "bidAsk": { "type": "boolean" }, "obsolete": { "type": "boolean" } } }, "currencyArray": { "type": "array", "items": { "$ref": "#/components/schemas/currency" } }, "providerArray": { "type": "array", "items": { "$ref": "#/components/schemas/provider" } } } } }