Geliştiriciler İçin

Canlı Altın Fiyatı Çekme: Adım Adım

Canlı altın fiyatı çekme işi, ücretsiz altın fiyatı API'sine tek bir istek atmaktan ibarettir: ücret yoktur, yalnız bir dakikada alınan ücretsiz API anahtarı gerekir. Aşağıda tarayıcıda, sunucuda ve tablo programlarında adım adım nasıl yapıldığı, verinin ne sıklıkla güncellendiği ve önbelleğin nasıl kurulacağı anlatılır.

Tek İstekle Hangi Fiyatlar Gelir?

Tek adres yeterlidir: GET https://hesaplialtin.com/api/v1/public-prices. Yanıt JSON biçimindedir ve Kapalıçarşı ve serbest piyasa fiyatlarından hesaplanan bütün altın, gümüş ve döviz kalemlerinin alış ve satış fiyatını, 24 saatlik değişimini ve güncelleme zamanını içerir. Alanların tamamı JSON kılavuzunda, uç noktaların özeti altın fiyatı API sayfasındadır.

Örneklerdeki ANAHTARINIZ yerine ücretsiz API anahtarınızı yazın; anahtar X-API-Key başlığıyla ya da ?anahtar= parametresiyle gönderilir.

curl -s -H "X-API-Key: ANAHTARINIZ" https://hesaplialtin.com/api/v1/public-prices

1. Tarayıcıda Çekme

Servis bütün sitelere açıktır (CORS izinli); sayfanızdaki JavaScript anahtarı başlıkta göndererek doğrudan çağırabilir. Fiyatı ekrana yazdırmanın en kısa yolu:

fetch('https://hesaplialtin.com/api/v1/public-prices', { headers: { 'X-API-Key': 'ANAHTARINIZ' } })
  .then((r) => r.json())
  .then((d) => {
    const gram = d.kalemler.GRAM_ALTIN_TRY;
    document.getElementById('gram').textContent = gram.satis.toLocaleString('tr-TR');
  });

Dakikada bir yenileme, hata yakalama ve kaynak bağlantısıyla eksiksiz örnek JavaScript kılavuzunda.

2. Sunucuda Çekme ve Önbellek

Sitenizin çok ziyaretçisi varsa her ziyaretçinin tarayıcısı ayrı istek atmasın: fiyatı sunucunuzda çekip kısa süre saklayın ve sayfalarınıza oradan verin. Önerilen düzen şudur:

Sunucunuz fiyatları 15–60 saniyede bir çeksin (ya da ilk istekte çekip bu süre boyunca saklasın); anahtar başına sınır dakikada 60 istektir.
Yanıtı bellekte, bir dosyada ya da Redis gibi bir önbellekte tutun; sayfalarınız hep bu kopyayı okusun.
API'ye ulaşılamazsa ya da yanıt 503 gelirse son kayıtlı kopyayı göstermeye devam edin ve updatedAt zamanını yanında yazın.
İsterseniz fiyatın yanına "Kaynak: Hesaplı Altın" bağlantısı ekleyin; şart değildir, eklerseniz dakika sınırınız iki katına çıkar.

# Linux sunucuda her dakika dosyaya kaydetme (crontab -e)
* * * * * curl -sf --max-time 10 -H "X-API-Key: ANAHTARINIZ" https://hesaplialtin.com/api/v1/public-prices -o /var/tmp/fiyatlar.yeni && mv /var/tmp/fiyatlar.yeni /var/tmp/fiyatlar.json

-f seçeneği hata durumunda dosyanın üzerine yazılmasını önler; böylece son sağlam kopya korunur. Dile göre örnekler: Python, PHP (dosya önbellekli işlevle).

3. Excel ve Google Sheets'te Çekme

Kod yazmadan tabloya almak için Excel'de Power Query, Google Sheets'te Apps Script kullanılır. Excel tabloyu dakikada bire kadar sık yenileyebilir; Google Sheets'te zamana dayalı tetikleyici 5 dakikada bir çalıştırılır. Adımlar: Excel canlı altın fiyatı ve Google Sheets altın fiyatı.

Fiyatlar Ne Sıklıkla Güncellenir?

Fiyatlar piyasada değiştikçe güncellenir; yanıt 5 saniye önbelleklidir, bu yüzden 5 saniyeden sık sorgulamak yeni veri getirmez. Çoğu site için 15–60 saniyede bir sorgu yeterlidir. Fiyat değiştiği anda haber almak gerekiyorsa sorgulamak yerine sunucunuzda canlı akışı dinleyin. Fiyatlar bir süredir değişmiyorsa (çoğunlukla hafta sonu) piyasa alanı durgun olur ve son fiyat döner.

Aynı yanıtta canlı döviz kurları da vardır; kodlar döviz kuru API kılavuzunda. Geçmiş fiyatlar için geçmiş altın fiyatları API kullanılır.

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.

Sık Sorulan Sorular

Kapalıçarşı altın fiyatları API ile çekilebilir mi?

Evet. API'deki fiyatlar Kapalıçarşı ve serbest piyasada oluşan alış ve satış fiyatlarından hesaplanır; gram, çeyrek, yarım, tam, Ata ve ayar altınları tek istekte gelir. Hesap yöntemi Fiyatları Nasıl Hesaplıyoruz sayfasında anlatılır.

Canlı döviz kuru da aynı istekle gelir mi?

Evet. Dolar, Euro, Sterlin ve diğer serbest piyasa döviz kurları altın kalemleriyle aynı JSON yanıtında USD_TRY, EUR_TRY gibi kodlarla yer alır; ayrı bir istek gerekmez.

JSON altın fiyatı verisinde sayılar hangi biçimde gelir?

Fiyatlar ondalık ayırıcısı nokta olan, yuvarlanmamış sayılardır (ör. 6752.2). Ekranda Türkçe biçimde göstermek için binlik ayırıcıyı ve virgülü kendi kodunuzda uygulamanız gerekir.

Piyasa kapalıyken API ne döndürür?

Fiyatlar bir süredir değişmiyorsa (çoğunlukla hafta sonu) yanıttaki piyasa alanı durgun olur ve fiyatlar piyasanın son fiyatıdır; hafta içi gece fiyatlar akmaya devam eder. Her kalemin guncelleme alanı o fiyatın ne zaman oluştuğunu gösterir; piyasa açıkken 30 dakikadır güncellenmeyen kalem bayat: true taşır.

Diğer Kılavuzlar

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