{"openapi":"3.1.0","info":{"title":"Turkey Market API","version":"1.0.0","description":"Live Turkish market prices for the lira (TRY): foreign currencies, the famous Turkish gold market (gram, quarter/half/full and Republic coins, 14/18/22-carat, silver) and key market instruments (the BIST 100 index, Bitcoin in lira, Brent crude and the gold ounce). Turkey's high-inflation economy makes physical gold a primary store of value, and the gram-altın and coin prices quoted here are what the bazaar trades on. The currencies endpoint returns every foreign currency against the lira with buy/sell and daily change; the gold endpoint returns the full Turkish gold/silver market; the quote endpoint returns any single instrument by code (also BIST 100, Bitcoin, Brent); the convert endpoint converts between any currency and the lira. Read live, nothing stored. This is Turkey's own live market FX + gold-bazaar layer — distinct from the central bank's official reference rates.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/turkey-api","description":"oanor gateway"}],"tags":[{"name":"Quote"},{"name":"Currencies"},{"name":"Gold"},{"name":"Convert"},{"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/quote":{"get":{"operationId":"get_v1_quote","tags":["Quote"],"summary":"Any single instrument by code","description":"","parameters":[{"name":"symbol","in":"query","required":true,"description":"Instrument code (usd, gram, bist100, btc, brent …)","schema":{"type":"string"},"example":"gram"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"code":"GRA","name":"Gram Gold","type":"Gold","quote":"TRY","buying":6058.29,"source":"finans.truncgil.com","selling":6059.18,"updated":"2026-06-11 19:50:01","change_pct":0.33},"meta":{"timestamp":"2026-06-11T16:50:43.793Z","request_id":"9c940b6f-8bd6-4ba6-8de3-f52bc9aec2c8"},"status":"ok","message":"Quote 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/currencies":{"get":{"operationId":"get_v1_currencies","tags":["Currencies"],"summary":"Every foreign currency vs the lira","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":63,"quote":"TRY","source":"finans.truncgil.com","updated":"2026-06-11 19:50:01","currencies":[{"code":"AED","quote":"TRY","buying":12.5633,"selling":12.567,"change_pct":0.04},{"code":"ALL","quote":"TRY","buying":0.5591,"selling":0.5592,"change_pct":-0.11},{"code":"ARS","quote":"TRY","buying":0.0323,"selling":0.0323,"change_pct":0.34},{"code":"AUD","quote":"TRY","buying":32.268,"selling":32.2833,"change_pct":0},{"code":"AZN","quote":"TRY","buying":27.1459,"selling":27.1525,"change_pct":0.06},{"code":"BAM","quote":"TRY","buying":27.2227,"selling":27.2294,"change_pct":-1.18},{"code":"BGN","quote":"TRY","buying":27.1768,"selling":27.4044,"change_pct":0.22},{"code":"BHD","quote":"TRY","buying":122.3371,"selling":122.3668,"change_pct":0.02},{"code":"BRL","quote":"TRY","buying":8.9648,"selling":8.967,"change_pct":0.8},{"code":"CAD","quote":"TRY","buying":32.9464,"selling":32.9638,"change_pct":-0.38},{"code":"CHF","quote":"TRY","buying":57.6274,"selling":57.6558,"change_pct":-0.04},{"code":"CLP","quote":"TRY","buying":0.0508,"selling":0.0508,"change_pct":0.65},{"code":"CNY","quote":"TRY","buying":6.8069,"selling":6.809,"change_pct":0.1},{"code":"COP","quote":"TRY","buying":0.0131,"selling":0.0131,"change_pct":1.32},{"code":"CRC","quote":"TRY","buying":0.1014,"selling":0.1015,"change_pct":0.44},{"code":"CZK","quote":"TRY","buying":2.1946,"selling":2.1952,"change_pct":-0.23},{"code":"DKK","quote":"TRY","buying":7.1048,"selling":7.11,"change_pct":-0.16},{"code":"DZD","quote":"TRY","buying":0.3461,"selling":0.3462,"change_pct":0.3},{"code":"EGP","quote":"TRY","buying":0.8881,"selling":0.8883,"change_pct":-0.23},{"code":"EUR","quote":"TRY","buying":53.2491,"selling":53.2665,"change_pct":-0.03},{"code":"GBP","quote":"TRY","buying":61.6913,"selling":61.7102,"change_pct":0.03},{"code":"GEL","quote":"TRY","buying":17.4143,"selling":17.4186,"change_pct":1.38},{"code":"HKD","quote":"TRY","buying":5.8885,"selling":5.8899,"change_pct":0.05},{"code":"HUF","quote":"TRY","buying":0.1496,"selling":0.1496,"change_pct":0.31},{"code":"IDR","quote":"TRY","buying":0.0026,"selling":0.0026,"change_pct":-0.26},{"code":"ILS","quote":"TRY","buying":15.5663,"selling":15.5701,"change_pct":0.6},{"code":"INR","quote":"TRY","buying":0.4824,"selling":0.4825,"change_pct":-0.39},{"code":"IQD","quote":"TRY","buying":0.0352,"selling":0.0353,"change_pct":0.15},{"code":"ISK","quote":"TRY","buying":0.3694,"selling":0.3695,"change_pct":-0.46},{"code":"JPY","quote":"TRY","buying":0.002879,"selling":0.002885,"change_pct":0},{"code":"KRW","quote":"TRY","buying":0.0301,"selling":0.0301,"change_pct":-0.52},{"code":"KWD","quote":"TRY","buying":149.2487,"selling":149.7651,"change_pct":0.29},{"code":"KZT","quote":"TRY","buying":0.0946,"selling":0.0946,"change_pct":-0.01},{"code":"LBP","quote":"TRY","buying":0.0005,"selling":0.0005,"change_pct":0.15},{"code":"LKR","quote":"TRY","buying":0.138,"selling":0.138,"change_pct":-0.92},{"code":"LYD","quote":"TRY","buying":7.2281,"selling":7.2299,"change_pct":-0.48},{"code":"MAD","quote":"TRY","buying":4.9706,"selling":4.9718,"change_pct":-0.09},{"code":"MDL","quote":"TRY","buying":2.6666,"selling":2.6672,"change_pct":0.04},{"code":"MKD","quote":"TRY","buying":0.8631,"selling":0.8633,"change_pct":-0.26},{"code":"MXN","quote":"TRY","buying":2.6554,"selling":2.656,"change_pct":0.3},{"code":"MYR","quote":"TRY","buying":11.3464,"selling":11.3491,"change_pct":0.11},{"code":"NOK","quote":"TRY","buying":4.8435,"selling":4.8483,"change_pct":-0.49},{"code":"NZD","quote":"TRY","buying":26.6613,"selling":26.6677,"change_pct":-0.27},{"code":"OMR","quote":"TRY","buying":120.0208,"selling":120.0499,"change_pct":0.06},{"code":"PEN","quote":"TRY","buying":13.5729,"selling":13.5762,"change_pct":0.09},{"code":"PHP","quote":"TRY","buying":0.7517,"selling":0.7518,"change_pct":0},{"code":"PKR","quote":"TRY","buying":0.1651,"selling":0.1668,"change_pct":0.12},{"code":"PLN","quote":"TRY","buying":12.4637,"selling":12.4667,"change_pct":-0.41},{"code":"QAR","quote":"TRY","buying":12.2284,"selling":13.136,"change_pct":0.16},{"code":"RON","quote":"TRY","buying":10.1345,"selling":10.1462,"change_pct":-0.19},{"code":"RSD","quote":"TRY","buying":0.4529,"selling":0.4545,"change_pct":0.02},{"code":"RUB","quote":"TRY","buying":0.6386,"selling":0.6389,"change_pct":0.09},{"code":"SAR","quote":"TRY","buying":12.294,"selling":12.2962,"change_pct":0.07},{"code":"SEK","quote":"TRY","buying":4.8265,"selling":4.8344,"change_pct":-0.34},{"code":"SGD","quote":"TRY","buying":35.8014,"selling":35.8101,"change_pct":-0.07},{"code":"SYP","quote":"TRY","buying":0.3995,"selling":0.3996,"change_pct":0.06},{"code":"THB","quote":"TRY","buying":1.3989,"selling":1.3992,"change_pct":-0.08},{"code":"TND","quote":"TRY","buying":15.7287,"selling":15.7325,"change_pct":0.13},{"code":"TWD","quote":"TRY","buying":1.4581,"selling":1.4584,"change_pct":0.15},{"code":"UAH","quote":"TRY","buying":1.0277,"selling":1.0279,"change_pct":0.47},{"code":"USD","quote":"TRY","buying":46.148,"selling":46.1592,"change_pct":0.06},{"code":"UYU","quote":"TRY","buying":1.1431,"selling":1.1434,"change_pct":0.43},{"code":"ZAR","quote":"TRY","buying":2.7923,"selling":2.7941,"change_pct":0.4}]},"meta":{"timestamp":"2026-06-11T16:50:43.951Z","request_id":"06c0d943-732a-41af-b4cd-920e7be7368b"},"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/gold":{"get":{"operationId":"get_v1_gold","tags":["Gold"],"summary":"Full Turkish gold & silver market","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"gold":[{"code":"GRA","name":"Gram Gold","quote":"TRY","buying":6058.29,"selling":6059.18,"change_pct":0.33},{"code":"HAS","name":"Gram Pure Gold","quote":"TRY","buying":6028,"selling":6028.88,"change_pct":0.33},{"code":"CEYREKALTIN","name":"Quarter Gold Coin","quote":"TRY","buying":9801.16,"selling":10027.48,"change_pct":-2.1},{"code":"YARIMALTIN","name":"Half Gold Coin","quote":"TRY","buying":19541.06,"selling":20054.97,"change_pct":-2.1},{"code":"TAMALTIN","name":"Full Gold Coin","quote":"TRY","buying":39204.63,"selling":39987.27,"change_pct":-2.1},{"code":"CUMHURIYETALTINI","name":"Republic Gold Coin","quote":"TRY","buying":40663,"selling":41278,"change_pct":-1.96},{"code":"ATAALTIN","name":"Ata Gold Coin","quote":"TRY","buying":40429.77,"selling":41459.19,"change_pct":-2.1},{"code":"RESATALTIN","name":"Resat Gold Coin","quote":"TRY","buying":40429.77,"selling":41459.19,"change_pct":-2.1},{"code":"HAMITALTIN","name":"Hamit Gold Coin","quote":"TRY","buying":40429.77,"selling":41459.19,"change_pct":-2.1},{"code":"IKIBUCUKALTIN","name":"2.5 Gold Coin","quote":"TRY","buying":98011.57,"selling":99600.2,"change_pct":-2.1},{"code":"BESLIALTIN","name":"5 Gold Coin","quote":"TRY","buying":198473.43,"selling":202389.56,"change_pct":-2.1},{"code":"GREMSEALTIN","name":"Gremse Gold Coin","quote":"TRY","buying":98011.57,"selling":100274.83,"change_pct":-2.1},{"code":"14AYARALTIN","name":"14-Carat Gold","quote":"TRY","buying":3491.66,"selling":3495.82,"change_pct":-2.1},{"code":"18AYARALTIN","name":"18-Carat Gold","quote":"TRY","buying":4471.78,"selling":4477.1,"change_pct":-2.1},{"code":"YIA","name":"22-Carat Bracelet","quote":"TRY","buying":5586.66,"selling":5593.31,"change_pct":-2.1},{"code":"ONS","name":"Gold Ounce (global)","quote":"TRY","buying":0,"selling":0,"change_pct":0.28},{"code":"GUMUS","name":"Silver (gram)","quote":"TRY","buying":94.76,"selling":94.86,"change_pct":0.82}],"note":"Turkish gold & silver market — gram, coins (quarter/half/full/Republic/Ata), carat bars, silver and the global ounce.","count":17,"quote":"TRY","source":"finans.truncgil.com","updated":"2026-06-11 19:50:01"},"meta":{"timestamp":"2026-06-11T16:50:44.106Z","request_id":"586e3d62-29be-44cb-ba90-26003f1eef25"},"status":"ok","message":"Gold 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 between any currency and the lira","description":"","parameters":[{"name":"amount","in":"query","required":true,"description":"Amount to convert","schema":{"type":"string"},"example":"100"},{"name":"from","in":"query","required":false,"description":"From currency code","schema":{"type":"string"},"example":"USD"},{"name":"to","in":"query","required":false,"description":"To currency code","schema":{"type":"string"},"example":"TRY"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"to":"TRY","from":"USD","amount":100,"result":4615.51,"source":"finans.truncgil.com","updated":"2026-06-11 10:51:01","try_per_to":1,"try_per_from":46.1551},"meta":{"timestamp":"2026-06-11T07:51:19.169Z","request_id":"087f824c-7376-46ba-9b22-bfa6efb6ca0e"},"status":"ok","message":"Conversion completed","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":{"note":"Prices in TRY; buy = Buying, sell = Selling. quote also serves BIST100 (XU100), Bitcoin (DBITCOIN) and Brent.","source":"finans.truncgil.com (Turkish market feed, live)","service":"turkey-api","endpoints":{"GET /v1/gold":"Full Turkish gold & silver market (gram, coins, carat bars, silver, ounce).","GET /v1/meta":"This document.","GET /v1/quote":"Any single instrument by code (symbol=usd, gram, bist100, btc, brent …).","GET /v1/convert":"Convert between any currency and the lira (amount=100, from=USD, to=TRY).","GET /v1/currencies":"Every foreign currency vs the lira with buy/sell and daily change."},"description":"Live Turkish market prices for the lira (TRY): foreign currencies, the famous Turkish gold market (gram, quarter/half/full and Republic coins, 14/18/22-carat, silver) and key instruments (BIST 100 index, Bitcoin in lira, Brent crude, gold ounce). Turkey's high-inflation economy makes physical gold a primary store of value, and the gram-altın and coin prices quoted here are what the bazaar trades on. The currencies endpoint returns every foreign currency against the lira with buy/sell and daily change; the gold endpoint returns the full Turkish gold/silver market; the quote endpoint returns any single instrument by code; the convert endpoint converts between any currency and the lira. Live, no key, nothing stored. Distinct from the central bank's official reference rates — this is Turkey's own live market FX + gold-bazaar layer."},"meta":{"timestamp":"2026-06-10T22:57:23.841Z","request_id":"f559bfa0-c63e-43fc-a501-65d395242f1d"},"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":3000,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":800,"monthly_call_quota":75000,"rps_limit":12,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2200,"monthly_call_quota":380000,"rps_limit":35,"hard_limit":true},{"slug":"scale","name":"Scale","price_cents_month":5000,"monthly_call_quota":2400000,"rps_limit":110,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/turkey-api"}