Geliştiriciler İçin

Döviz Kuru API: Dolar, Euro ve Sterlin

Canlı döviz kuru API'si altın fiyatlarıyla aynı uç noktadan serbest piyasa döviz kurlarını verir: Dolar, Euro, Sterlin ve diğer kurların alış ve satış fiyatı TL olarak gelir. Ücretsiz bir API anahtarı yeterlidir.

Döviz Kodları

`USD_TRY`	Dolar: TL karşılığı alış ve satış
`EUR_TRY`	Euro: TL karşılığı alış ve satış
`GBP_TRY`	Sterlin: TL karşılığı alış ve satış
`CHF_TRY`	İsviçre Frangı: TL karşılığı alış ve satış
`JPY_TRY`	Japon Yeni: TL karşılığı alış ve satış
`SAR_TRY`	Suudi Riyali: TL karşılığı alış ve satış
`AUD_TRY`	Avustralya Doları: TL karşılığı alış ve satış
`CAD_TRY`	Kanada Doları: TL karşılığı alış ve satış

Kurlar serbest piyasa kurlarıdır ve piyasada değiştikçe güncellenir. Türkiye Cumhuriyet Merkez Bankası'nın gösterge kurları bu API'de yer almaz; onlar Merkez Bankası döviz kurları sayfasındadır.

Örnek İstek ve Yanıt

Dövizler GET https://hesaplialtin.com/api/v1/public-prices yanıtındaki kalemler nesnesinde, altın kalemleriyle birlikte gelir. Yanıttan bir döviz kaydı:

{
  "USD_TRY": {
    "degisim24s": 0.051,
    "etiket": "Dolar",
    "birim": "TRY",
    "slug": "dolar",
    "alis": 48.809,
    "satis": 49.011,
    "guncelleme": "2026-09-27T10:15:02.000Z"
  }
}

Alan açıklamalarının tamamı JSON kılavuzunda. alis dövizi bozdururken, satis alırken geçerli kurdur.

JavaScript ile Bütün Kurlar

const DOVIZLER = ["USD_TRY","EUR_TRY","GBP_TRY","CHF_TRY","JPY_TRY","SAR_TRY","AUD_TRY","CAD_TRY"];

const r = await fetch('https://hesaplialtin.com/api/v1/public-prices', { headers: { 'X-API-Key': 'ANAHTARINIZ' } });
const { kalemler } = await r.json();
for (const kod of DOVIZLER) {
  const k = kalemler[kod];
  if (k) console.log(kod, k.etiket, 'alış', k.alis, 'satış', k.satis);
}

// EUR/USD paritesi yanıtta ayrıca yok; iki kurdan hesaplanabilir:
const parite = kalemler.EUR_TRY.satis / kalemler.USD_TRY.satis;
console.log('EUR/USD yaklaşık', parite.toFixed(4));

İki TL kurundan hesaplanan parite, piyasada doğrudan işlem gören pariteden biraz farklı olabilir; bu yüzden "yaklaşık" olarak gösterin. Bir dövizin geçmiş kurları için kod=USD_TRY ile geçmiş fiyatlar uç noktasını kullanın. Python ve PHP örnekleri: Python, PHP. Kurları sitede görmek için döviz kurları sayfasına bakın.

Kullanım Koşulu

API'yi kullanmak için ücretsiz bir API anahtarı gerekir; anahtar her istekte X-API-Key başlığıyla ya da ?anahtar= parametresiyle gönderilir. 13 Ekim 2026 tarihine kadar anahtarsız istekler de yanıtlanır (yanıtta ek uyari alanı ve Warning başlığı bulunur); bu tarihten sonra anahtarsız istek 401 alır. Sınırlar anahtar başınadır: dakikada 60 istek (anlık fiyat ve geçmiş seri toplamı) ve aynı anda en çok 5 canlı akış bağlantısı; aşılınca 429 döner. Anahtar tek bir site ya da uygulama içindir ve başkasıyla paylaşılmaz; koşullara uyulmadığında ya da kötüye kullanımda anahtar kapatılabilir. Kaynak bağlantısı şart değildir; veriyi gösterdiğiniz sayfada "Kaynak: Hesaplı Altın" bağlantısı (https://hesaplialtin.com/) verirseniz dakika sınırınız iki katına çıkar. Servisi 5 saniyeden sık sorgulamayın; yoğun kullanımda kendi sunucunuzda önbellek tutun. Fiyatlar Kapalıçarşı ve serbest piyasa fiyatlarından hesaplanır, bilgi amaçlıdır ve alım satım teklifi değildir. Veri olduğu gibi sunulur; doğruluk ve kesintisiz erişim garantisi verilmez, servis önceden haber verilmeden değiştirilebilir ya da durdurulabilir ve aşırı kullanımda erişim sınırlanabilir. Kod yazmadan fiyat göstermek isterseniz hazır fiyat kutusunu kullanabilirsiniz.

Diğer Kılavuzlar

Fiyatları nasıl hesaplıyoruz? · Sitene altın fiyatı ekle · Altın hesaplama kutusu · Kapalıçarşı altın fiyatları