{"openapi":"3.1.0","info":{"title":"doviz.day açık veri API'si","version":"1.0.0","description":"Canlı kur, altın, kripto, endeks ve emtia verisi ile ülke ekonomisi göstergeleri. Anahtar yok, ücret yok; tek koşul kaynak bağlantısının korunması.","contact":{"url":"https://doviz.day/gelistirici"},"license":{"name":"Atıf koşuluyla ücretsiz","url":"https://doviz.day/gelistirici#atif"}},"servers":[{"url":"https://doviz.day"}],"paths":{"/api/rates":{"get":{"operationId":"getRates","summary":"Canlı kur ve piyasa verisi","description":"Fiyatı yayımlanan bütün enstrümanlar (döviz, altın, kıymetli maden, kripto, endeks, emtia, hisse). Yanıt 2 dakika önbelleklenir ve ortak önbelleklerde tutulabilir.","responses":{"200":{"description":"Enstrüman kodu => son fiyat kaydı","content":{"application/json":{"schema":{"type":"object","required":["updated_at","rates"],"properties":{"updated_at":{"type":"string","format":"date-time","description":"Verinin yayımlandığı an (Europe/Istanbul)."},"rates":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/Rate"}}}},"example":{"updated_at":"2026-09-18T22:58:28+03:00","rates":{"USDTRY":{"type":"forex","name":"Amerikan Doları","currency":"TRY","price":48.7833,"change_pct":0.1,"buy":48.7749,"sell":48.7833,"traded_at":"2026-09-18T22:55:03+03:00","url":"https://doviz.day/doviz/usd-try"}}}}}}}}},"/api/ekonomi/{country}":{"get":{"operationId":"getCountryEconomy","summary":"Ülke ekonomisi göstergeleri","parameters":[{"name":"country","in":"path","required":true,"description":"Ülke slug'ı (ülke dizininde listelenir)","schema":{"type":"string","example":"turkiye"}}],"responses":{"200":{"description":"Ülkenin gösterge serileri"},"404":{"description":"Ülke bulunamadı","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}}}}},"components":{"schemas":{"Rate":{"type":"object","required":["type","name","price","url"],"properties":{"type":{"type":"string","enum":["forex","gold","metal","crypto","index","stock","commodity","bond"]},"name":{"type":"string","description":"Türkçe görünen ad"},"currency":{"type":["string","null"],"description":"Fiyatın para birimi; tahvil getirisinde null"},"price":{"type":"number"},"change_pct":{"type":["number","null"],"description":"Günlük değişim, yüzde"},"buy":{"type":["number","null"]},"sell":{"type":["number","null"]},"traded_at":{"type":["string","null"],"format":"date-time"},"url":{"type":"string","description":"Enstrümanın doviz.day üzerindeki sayfası (atıf bağlantısı)"}}}}}}