{"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"},"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"},"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"},"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"},"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"}