Geliştiriciler İçin

Geçmiş Altın Fiyatları API

Geçmiş altın fiyatları API'si bir kalemin seçtiğiniz aralıktaki satış fiyatlarını zaman sıralı seri olarak ve dönemin özetiyle döndürür. Grafik çizmek ya da dönem değişimini göstermek için kullanılır.

İstek ve Parametreler

İstek: GET https://hesaplialtin.com/api/v1/public-history?kod=GRAM_ALTIN_TRY&aralik=1a. İki parametre de zorunludur; API anahtarınız X-API-Key başlığıyla ya da &anahtar= parametresiyle gönderilir.

`kod`	Kalem kodu (ör. `GRAM_ALTIN_TRY`, `USD_TRY`). Kodların tamamı JSON kılavuzunda; burada gremse için yalnız `GREMESE_YENI_TRY` ve `GREMESE_ESKI_TRY` yazımı geçerlidir.
`aralik`	Zaman aralığı: `1g`, `1h`, `1a`, `3a`, `6a`, `1y`, `tumu`. `1g` son gün, `1h` son hafta, `1a` son 30 gün, `3a` ve `6a` son 90 ve 180 gün, `1y` son 365 gün, `tumu` kayıtların başından bugüne.

Yanıt

{
  "kalem": "GRAM_ALTIN_TRY",
  "aralik": "1h",
  "seri": [
    [1789938000000, 6702.5],
    [1790024400000, 6731.8],
    …
  ],
  "ozet": { "ilk": 6702.5, "son": 6752.2, "min": 6690.1, "max": 6760.4, "degisim": 49.7, "degisimYuzde": 0.742 }
}

`seri`	`[zaman, satış]` çiftleri; zaman Unix milisaniyesidir (UTC), eskiden yeniye sıralıdır. Yalnız satış fiyatı verilir. En çok 400 nokta döner.
`ozet`	Dönemin `ilk`, `son`, `min`, `max` satış fiyatı, `degisim` (son eksi ilk) ve `degisimYuzde`. Aralıkta kayıt yoksa `null`.
`kalem`	İstekte gönderdiğiniz kod.
`aralik`	İstekte gönderdiğiniz aralık.

1g, 1h ve 1a aralıklarında seri gün içi fiyatlardan oluşur; 3a ve daha uzun aralıklarda her nokta bir günün kapanış fiyatıdır (İstanbul saatiyle). Yanıt 60 saniye önbelleklidir ve bütün sitelerden okunabilir.

Örnekler

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

curl -H "X-API-Key: ANAHTARINIZ" "https://hesaplialtin.com/api/v1/public-history?kod=CEYREK_YENI_TRY&aralik=1y"

const r = await fetch('https://hesaplialtin.com/api/v1/public-history?kod=GRAM_ALTIN_TRY&aralik=1a', {
  headers: { 'X-API-Key': 'ANAHTARINIZ' },
});
const { seri, ozet } = await r.json();
for (const [t, satis] of seri) {
  console.log(new Date(t).toLocaleString('tr-TR'), satis);
}
if (ozet) console.log('Dönem değişimi (%):', ozet.degisimYuzde);

Geçersiz kod ya da aralık 400 durum koduyla {"hata": "gecersiz-kod-ya-da-aralik"} döndürür; arşiv geçici olarak erişilemezse 503 ve {"hata": "arsiv-yok"} gelir. Aynı veriyi hazır grafik olarak görmek için gram altın grafiği sayfasına bakabilirsiniz.

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ı