{"openapi":"3.1.0","info":{"title":"Central Bank of Türkiye FX API","version":"1.0.0","description":"Live official exchange-rate data for the Turkish lira (TRY) from the Central Bank of the Republic of Türkiye (TCMB) — straight from its public daily rate XML as clean JSON. Unusually, the TCMB publishes four rates per currency: forex buying, forex selling, banknote buying and banknote selling. Get all of these for every published currency against the lira, for the latest or any past business day, normalised to one unit; pull a single currency's four rates, mid and the inverse; convert an amount between any two published currencies (including TRY) at the forex mid rate; or list the quoted currencies. Read live from the TCMB, nothing cached. This is the official Turkish-lira central-bank rate, with the forex/banknote split few other feeds expose — distinct from the ECB, BCRA, BCRP, NRB and other central-bank feeds and from market mid-rates: the TCMB's own lira rates.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/tcmb-api","description":"oanor gateway"}],"tags":[{"name":"Rates"},{"name":"Rate"},{"name":"Convert"},{"name":"Currencies"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/rates":{"get":{"operationId":"get_v1_rates","tags":["Rates"],"summary":"TCMB forex + banknote buy/sell for every currency vs the lira","description":"","parameters":[{"name":"date","in":"query","required":false,"description":"Business day YYYY-MM-DD (defaults to latest)","schema":{"type":"string"},"example":"2026-06-09"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"base":"TRY","date":"2026-06-09","count":22,"rates":[{"name":"UNITED ARAB EMIRATES DIRHAM","unit":1,"currency":"AED","forex_mid":12.5448,"forex_buying":12.4633,"forex_selling":12.6263},{"name":"AUSTRALIAN DOLLAR","unit":1,"currency":"AUD","forex_mid":32.50505,"forex_buying":32.3994,"forex_selling":32.6107,"banknote_buying":32.2504,"banknote_selling":32.8063},{"name":"AZERBAIJANI NEW MANAT","unit":1,"currency":"AZN","forex_mid":27.10255,"forex_buying":26.9264,"forex_selling":27.2787},{"name":"CANADIAN DOLLAR","unit":1,"currency":"CAD","forex_mid":33.0653,"forex_buying":32.9909,"forex_selling":33.1397,"banknote_buying":32.8689,"banknote_selling":33.2656},{"name":"SWISS FRANK","unit":1,"currency":"CHF","forex_mid":57.85565,"forex_buying":57.6705,"forex_selling":58.0408,"banknote_buying":57.584,"banknote_selling":58.1279},{"name":"CHINESE RENMINBI","unit":1,"currency":"CNY","forex_mid":6.80455,"forex_buying":6.7603,"forex_selling":6.8488},{"name":"DANISH KRONE","unit":1,"currency":"DKK","forex_mid":7.12325,"forex_buying":7.1058,"forex_selling":7.1407,"banknote_buying":7.1009,"banknote_selling":7.1572},{"name":"EURO","unit":1,"currency":"EUR","forex_mid":53.24195,"forex_buying":53.194,"forex_selling":53.2899,"banknote_buying":53.1568,"banknote_selling":53.3698},{"name":"POUND STERLING","unit":1,"currency":"GBP","forex_mid":61.6605,"forex_buying":61.5002,"forex_selling":61.8208,"banknote_buying":61.4571,"banknote_selling":61.9135},{"name":"JAPENESE YEN","unit":100,"currency":"JPY","forex_mid":0.287647,"forex_buying":0.286698,"forex_selling":0.288596,"banknote_buying":0.285637,"banknote_selling":0.289693},{"name":"SOUTH KOREAN WON","unit":1,"currency":"KRW","forex_mid":0.03029,"forex_buying":0.03009,"forex_selling":0.03049},{"name":"KUWAITI DINAR","unit":1,"currency":"KWD","forex_mid":149.9571,"forex_buying":148.9824,"forex_selling":150.9318,"banknote_buying":146.7476,"banknote_selling":153.1958},{"name":"KAZAKHSTAN TENGE","unit":1,"currency":"KZT","forex_mid":0.094225,"forex_buying":0.09361,"forex_selling":0.09484},{"name":"NORWEGIAN KRONE","unit":1,"currency":"NOK","forex_mid":4.8679,"forex_buying":4.8516,"forex_selling":4.8842,"banknote_buying":4.8482,"banknote_selling":4.8954},{"name":"PAKISTANI RUPEE","unit":1,"currency":"PKR","forex_mid":0.16557,"forex_buying":0.16449,"forex_selling":0.16665},{"name":"QATARI RIAL","unit":1,"currency":"QAR","forex_mid":12.63795,"forex_buying":12.5558,"forex_selling":12.7201},{"name":"NEW LEU","unit":1,"currency":"RON","forex_mid":10.1639,"forex_buying":10.0978,"forex_selling":10.23},{"name":"RUSSIAN ROUBLE","unit":1,"currency":"RUB","forex_mid":0.63983,"forex_buying":0.63567,"forex_selling":0.64399},{"name":"SAUDI RIYAL","unit":1,"currency":"SAR","forex_mid":12.27245,"forex_buying":12.2614,"forex_selling":12.2835,"banknote_buying":12.1695,"banknote_selling":12.3757},{"name":"SWEDISH KRONA","unit":1,"currency":"SEK","forex_mid":4.891,"forex_buying":4.8658,"forex_selling":4.9162,"banknote_buying":4.8624,"banknote_selling":4.9275},{"name":"US DOLLAR","unit":1,"currency":"USD","forex_mid":46.0743,"forex_buying":46.0328,"forex_selling":46.1158,"banknote_buying":46.0006,"banknote_selling":46.185},{"name":"SPECIAL DRAWING RIGHT (SDR)                       ","unit":1,"currency":"XDR","forex_buying":62.8744}],"source":"Türkiye Cumhuriyet Merkez Bankası (TCMB)"},"meta":{"timestamp":"2026-06-10T22:58:46.126Z","request_id":"1e2d2ce6-3543-4826-a8f0-a7350872c781"},"status":"ok","message":"Rates retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/rate":{"get":{"operationId":"get_v1_rate","tags":["Rate"],"summary":"One currency's four rates, mid and inverse","description":"","parameters":[{"name":"currency","in":"query","required":true,"description":"ISO 4217 currency code","schema":{"type":"string"},"example":"USD"},{"name":"date","in":"query","required":false,"description":"Business day YYYY-MM-DD","schema":{"type":"string"},"example":"2026-06-09"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"base":"TRY","date":"2026-06-09","name":"US DOLLAR","unit":1,"source":"Türkiye Cumhuriyet Merkez Bankası (TCMB)","currency":"USD","forex_mid":46.0743,"forex_buying":46.0328,"try_per_unit":46.0743,"unit_per_try":0.02170407,"forex_selling":46.1158,"banknote_buying":46.0006,"banknote_selling":46.185},"meta":{"timestamp":"2026-06-10T22:58:46.306Z","request_id":"10e3022c-aefa-4c4d-beb9-24f3339ea87b"},"status":"ok","message":"Rate retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/convert":{"get":{"operationId":"get_v1_convert","tags":["Convert"],"summary":"Convert an amount between two currencies at TCMB forex mid rates","description":"","parameters":[{"name":"from","in":"query","required":true,"description":"Source currency","schema":{"type":"string"},"example":"USD"},{"name":"to","in":"query","required":true,"description":"Target currency","schema":{"type":"string"},"example":"EUR"},{"name":"amount","in":"query","required":false,"description":"Amount to convert","schema":{"type":"string"},"example":"100"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"to":"EUR","date":"2026-06-10","from":"USD","rate":0.86576973,"amount":100,"result":86.576973,"source":"Türkiye Cumhuriyet Merkez Bankası (TCMB)","try_per_to":53.2365,"try_per_from":46.09055},"meta":{"timestamp":"2026-06-10T22:58:46.481Z","request_id":"dd9bec46-7966-4ba4-99ff-4998a0f840d6"},"status":"ok","message":"Conversion completed successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/currencies":{"get":{"operationId":"get_v1_currencies","tags":["Currencies"],"summary":"TCMB list of quoted currencies","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":22,"source":"Türkiye Cumhuriyet Merkez Bankası (TCMB)","currencies":[{"name":"UNITED ARAB EMIRATES DIRHAM","unit":1,"currency":"AED"},{"name":"AUSTRALIAN DOLLAR","unit":1,"currency":"AUD"},{"name":"AZERBAIJANI NEW MANAT","unit":1,"currency":"AZN"},{"name":"CANADIAN DOLLAR","unit":1,"currency":"CAD"},{"name":"SWISS FRANK","unit":1,"currency":"CHF"},{"name":"CHINESE RENMINBI","unit":1,"currency":"CNY"},{"name":"DANISH KRONE","unit":1,"currency":"DKK"},{"name":"EURO","unit":1,"currency":"EUR"},{"name":"POUND STERLING","unit":1,"currency":"GBP"},{"name":"JAPENESE YEN","unit":100,"currency":"JPY"},{"name":"SOUTH KOREAN WON","unit":1,"currency":"KRW"},{"name":"KUWAITI DINAR","unit":1,"currency":"KWD"},{"name":"KAZAKHSTAN TENGE","unit":1,"currency":"KZT"},{"name":"NORWEGIAN KRONE","unit":1,"currency":"NOK"},{"name":"PAKISTANI RUPEE","unit":1,"currency":"PKR"},{"name":"QATARI RIAL","unit":1,"currency":"QAR"},{"name":"NEW LEU","unit":1,"currency":"RON"},{"name":"RUSSIAN ROUBLE","unit":1,"currency":"RUB"},{"name":"SAUDI RIYAL","unit":1,"currency":"SAR"},{"name":"SWEDISH KRONA","unit":1,"currency":"SEK"},{"name":"US DOLLAR","unit":1,"currency":"USD"},{"name":"SPECIAL DRAWING RIGHT (SDR)                       ","unit":1,"currency":"XDR"}]},"meta":{"timestamp":"2026-06-10T22:58:46.652Z","request_id":"ad9c2cf3-bb6c-45b6-9221-b206719dab45"},"status":"ok","message":"Currencies retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Service metadata","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"date":"2026-06-10","source":"TCMB daily exchange-rate XML (tcmb.gov.tr, live)","service":"tcmb-api","usd_try":46.132,"endpoints":{"GET /v1/meta":"This document.","GET /v1/rate":"One currency's four rates, mid and inverse (currency=USD).","GET /v1/rates":"TCMB forex + banknote buy/sell for every currency vs the lira (optional date=YYYY-MM-DD).","GET /v1/convert":"Convert an amount between two currencies at TCMB forex mid rates (from=USD, to=EUR, amount=100).","GET /v1/currencies":"TCMB list of quoted currencies."},"description":"Live official exchange-rate data for the Turkish lira (TRY) from the Central Bank of the Republic of Türkiye (TCMB), via its public daily rate XML. The TCMB publishes four rates per currency — forex buying, forex selling, banknote buying and banknote selling. The rates endpoint returns all of these for every published currency against the lira, for the latest or any past business day, normalised to one unit; the rate endpoint returns one currency's four rates and the inverse; the convert endpoint converts an amount between any two published currencies (including TRY) at the forex mid rate; the currencies endpoint lists the quoted currencies. Live, no key, nothing stored. Distinct from the ECB, BCRA, BCRP, NRB and other central-bank feeds and from market mid-rates — this is the TCMB's own forex and banknote lira rates.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-10T22:58:46.812Z","request_id":"1e5959c1-bcb0-49dc-84a5-2e79bf7755c6"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":550,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":820,"monthly_call_quota":25000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2400,"monthly_call_quota":125000,"rps_limit":20,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":5800,"monthly_call_quota":620000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/tcmb-api"}