Açık API ve Gömülebilir Widget

Genel bakış

Sitede takip edilen 98 piyasa enstrümanı, 1.000 kripto para ve 242 ülkenin ekonomik verisi JSON olarak sunulur. Kimlik doğrulama istenmez, API anahtarı yoktur; istekler Accept-Encoding ile sıkıştırılır ve tüm kaynaklara açıktır (Access-Control-Allow-Origin: *).

Veri, kaynağından çekildikten sonra 2 dakika önbelleklenir. Bu yüzden yanıttaki updated_at alanı verinin yayımlandığı anı gösterir, isteğinizin anını değil.

Canlı kurlar

GET https://doviz.day/api/rates

Sitede fiyatı yayımlanan bütün enstrümanlar döner: döviz kurları, altın ve kıymetli madenler, kripto varlıklar, endeksler, emtia ve hisseler. Her kayıt son fiyatı, günlük değişim yüzdesini, varsa alış/satışı, fiyatın para birimini ve doviz.day üzerindeki kendi sayfasının adresini taşır. Örnek yanıt (kısaltılmış):

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

url alanı veriyi gösterdiğiniz yere konulacak bağlantıdır; enstrümanın kendi sayfası yoksa ait olduğu bölüm listesine işaret eder. Hangi üst sağlayıcıdan çektiğimiz yanıtta yer almaz: veriyi bizden alan tarafın doğrudan kaynağa yönlenmesi işimizi anlamsız kılar. Kaynak şeffaflığı sitedeki her sayfada zaten açıktır.

Fiyatlar ilgili para birimindedir (currency alanı). forex tipindeki kayıtlar 1 birimin karşı tarafına karşılığıdır (ör. USDTRY = 1 dolar kaç lira). Fiyatlar serbest piyasa kurudur; TCMB resmî kuru değildir.

Ülke ekonomisi

GET https://doviz.day/api/ekonomi/{ülke}

Ülke slug'ı ile o ülkenin veritabanındaki gösterge serileri döner. Slug'lar ülke dizininde listelenir. Bulunamayan ülke için 404 ve {"error": "Ülke bulunamadı"} döner.

API tanımı (OpenAPI)

İki ucun da makine okunur şeması /api/openapi.json adresindedir. İstemci üreteçleri ve API dizinleri bu dosyayı kullanabilir.

Gömülebilir kur widget'ı

Aşağıdaki satırı sayfanıza ekleyin; widget kendini oluşturur, veriyi çeker ve kaynak bağlantısını basar. Satır başına bir enstrüman gösterilir, aynı sayfaya birden çok widget eklenebilir.

<script src="https://doviz.day/gomulu/kur.js" data-kod="USDTRY"></script>

data-kod ile gösterilecek enstrüman seçilir (USDTRY, EURTRY, GBPTRY, CHFTRY, CNYTRY, GRAMALTIN, BTCUSD …). Tam liste /api/rates yanıtındaki anahtarlardır.

Widget'ı sayfada belirli bir yere koymak isterseniz boş bir kapsayıcı verip data-hedef ile işaret edin:

<div id="kur-kutusu"></div>
<script src="https://doviz.day/gomulu/kur.js" data-kod="EURTRY" data-hedef="kur-kutusu"></script>

Tema (açık / koyu)

Widget'ın kendi tema düğmesi vardır. Varsayılanı siz belirlersiniz, okurun kendi seçimi sizinkini geçersiz kılar:

• data-tema="auto" (varsayılan) — işletim sisteminin açık/koyu tercihine uyar.
• data-tema="acik" — sayfanız açık temadaysa (data-tema="light" da kabul edilir).
• data-tema="koyu" — sayfanız koyu temadaysa (data-tema="dark" da kabul edilir).

<script src="https://doviz.day/gomulu/kur.js" data-kod="USDTRY" data-tema="koyu"></script>

Okur düğmeye bastığında seçim tarayıcısında saklanır ve sayfadaki bütün widget'lar birlikte döner. Okurun seçimi data-tema ayarınızın üzerindedir: kendi sitesinde koyu tema seven bir okuru açık temaya mahkûm etmeyiz. Tarayıcı deposu kapalıysa (gizli sekme) widget yine çalışır, yalnızca tercih hatırlanmaz.

Canlı önizleme

Aşağıdaki iki kutu, yukarıdaki satırların bu sayfadaki gerçek çıktısıdır:

Atıf koşulu

Veri ücretsizdir; karşılığında beklediğimiz tek şey kaynak bağlantısının korunmasıdır. Widget bunu kendisi basar, silmeniz gerekmez. Kendi arayüzünüzü yazıyorsanız veriyi gösterdiğiniz yere <a href="https://doviz.day">doviz.day</a> bağlantısını ekleyin.

Bağlantıyı nofollow ile işaretlemenize gerek yok; arama motorları için değil, verinin kimden geldiğini okurun görmesi için istiyoruz.

Sınırlar ve adil kullanım

• Yanıtlar 2 dakika önbelleklidir; saniyede birden sık istek anlamsızdır.
• Toplu veri çekme (siteyi baştan sona kazımak) yerine /api/rates ve site haritası yeterlidir.
• Aşırı yük durumunda istekler sınırlandırılabilir. Ticari ölçekli kullanım (yüksek hacim, yeniden dağıtım, SLA beklentisi) için veri lisanslama konuşulur.
• Veri "olduğu gibi" sunulur; yatırım tavsiyesi değildir ve doğruluk garantisi verilmez. Kritik kullanımda resmî kaynağı teyit edin.