Geliştiriciler İçin

Altın Fiyatı JSON: Yanıt Alanları ve Kodlar

Altın fiyatı JSON yanıtı tek istekle bütün altın, gümüş ve döviz kalemlerinin alış ve satış fiyatını verir. Aşağıda yanıtın her alanı, alabileceği değerler ve kullanılabilen bütün kodlar yer alır.

Uç Nokta ve Örnek Yanıt

İstek: GET https://hesaplialtin.com/api/v1/public-prices, X-API-Key başlığında ücretsiz API anahtarınızla (ya da ?anahtar= parametresiyle); başka parametre gerekmez. Yanıt application/json biçimindedir, 5 saniye önbelleklidir (Cache-Control: public, max-age=5) ve bütün sitelerden okunabilir (Access-Control-Allow-Origin: *). Örnek yanıt (üç kalemle kısaltılmış):

{
  "updatedAt": "2026-09-27T10:15:02.000Z",
  "piyasa": "canli",
  "kalemler": {
    "GRAM_ALTIN_TRY": {
      "degisim24s": 0.412,
      "etiket": "Gram Altın",
      "birim": "TRY",
      "slug": "gram-altin",
      "alis": 6648.2,
      "satis": 6752.2,
      "guncelleme": "2026-09-27T10:15:02.000Z"
    },
    "ONS_ALTIN_USD": {
      "degisim24s": -0.105,
      "etiket": "Ons Altın",
      "birim": "USD",
      "slug": "ons-altin",
      "alis": 4284.63,
      "satis": 4284.63,
      "guncelleme": "2026-09-27T10:15:00.000Z"
    },
    "GBP_TRY": {
      "degisim24s": null,
      "etiket": "Sterlin",
      "birim": "TRY",
      "alis": 65.412,
      "satis": 65.874,
      "guncelleme": "2026-09-27T10:14:58.000Z"
    }
  }
}

Üst Düzey Alanlar

`updatedAt`	Fiyat verisinin üretildiği an; ISO 8601 biçiminde, UTC saatiyle.
`piyasa`	`canli`: fiyatlar akıyor (hafta içi gece de). `durgun`: fiyatlar bir süredir değişmiyor, çoğunlukla hafta sonu; son fiyat döner. `bilinmiyor`: fiyat verisi 10 dakikadan eski, fiyatlar güncel olmayabilir.
`kalemler`	Kod → kalem nesnesi eşlemesi. Anahtarlar aşağıdaki kod tablosundaki kodlardır; o an fiyatı olmayan kalem yanıtta yer almaz.
`uyari`	Yalnız anahtarsız isteklerde ve 13 Ekim 2026 tarihine kadar: anahtar zorunluluğunun tarihi ve anahtar alma adresi. Aynı metin `Warning` başlığında da gelir. Diğer alanlar değişmez.

Kalem Alanları

`alis`	Alış fiyatı: altını ya da dövizi bozdururken geçerli fiyat. Sayı; ondalık ayırıcı noktadır.
`satis`	Satış fiyatı: altını ya da dövizi alırken geçerli fiyat.
`degisim24s`	Satış fiyatının 24 saat önceki kayda göre yüzde değişimi (ör. `0.412` = %0,412). 24 saat önceye ait kayıt yoksa `null`.
`etiket`	Kalemin Türkçe adı (ör. `Gram Altın`).
`birim`	Fiyatın para birimi: `TRY` ya da `USD`.
`slug`	Kalemin sitede kendi sayfası varsa adresi (`gram-altin` → https://hesaplialtin.com/gram-altin); yoksa alan `null` ya da yoktur.
`guncelleme`	Kalem fiyatının son güncellenme anı (ISO 8601, UTC); bilinmiyorsa `null`.
`bayat`	Yalnız `true` olduğunda gelir: piyasa açıkken kalemin fiyatı 30 dakikadır güncellenmedi, fiyat güncel olmayabilir.

Sayılar yuvarlanmadan gelir; ekranda gösterirken kendi biçiminizi uygulayın (Türkçe biçim için JavaScript'te toLocaleString('tr-TR')).

Bütün Kodlar

Yanıtta kullanılabilen 38 kod aşağıdadır. Gremse için eski yazım (GREMESE_YENI_TRY, GREMESE_ESKI_TRY) korunur, doğru yazımlı GREMSE_YENI_TRY ve GREMSE_ESKI_TRY de aynı veriyle gelir.

`HAS_ALTIN_TRY`	Has Altın (TRY)
`GRAM_ALTIN_TRY`	Gram Altın (TRY)
`ONS_ALTIN_USD`	Ons Altın (USD)
`ALTIN_KG_USD`	Altın KG/USD (USD)
`ALTIN_KG_EUR`	Altın KG/EUR (EUR)
`GUMUS_TRY`	Gümüş (gram) (TRY)
`GUMUS_KG_USD`	Gümüş KG/USD (USD)
`GUMUS_ONS_USD`	Gümüş Ons (USD)
`CEYREK_YENI_TRY`	Çeyrek Altın (TRY)
`CEYREK_ESKI_TRY`	Eski Çeyrek (TRY)
`YARIM_YENI_TRY`	Yarım Altın (TRY)
`YARIM_ESKI_TRY`	Eski Yarım (TRY)
`TAM_YENI_TRY`	Tam Altın (TRY)
`TAM_ESKI_TRY`	Eski Tam (TRY)
`ATA_YENI_TRY`	Ata Altın (TRY)
`ATA_ESKI_TRY`	Eski Ata (TRY)
`ATA_CEYREK_YENI_TRY`	Ata Çeyrek (TRY)
`ATA_CEYREK_ESKI_TRY`	Eski Ata Çeyrek (TRY)
`ATA_YARIM_YENI_TRY`	Ata Yarım (TRY)
`ATA_YARIM_ESKI_TRY`	Eski Ata Yarım (TRY)
`ATA5_YENI_TRY`	Ata Beşli (TRY)
`ATA5_ESKI_TRY`	Eski Ata Beşli (TRY)
`GREMESE_YENI_TRY`	Gremse (TRY)
`GREMESE_ESKI_TRY`	Eski Gremse (TRY)
`RESAT_TRY`	Reşat Altın (TRY)
`RESAT25_TRY`	Reşat İkibuçuk (TRY)
`RESAT5_TRY`	Reşat Beşli (beşi bir yerde) (TRY)
`AYAR22_TRY`	22 Ayar (TRY)
`AYAR18_TRY`	18 Ayar (TRY)
`AYAR14_TRY`	14 Ayar (TRY)
`USD_TRY`	Dolar (TRY)
`EUR_TRY`	Euro (TRY)
`GBP_TRY`	Sterlin (TRY)
`CHF_TRY`	İsviçre Frangı (TRY)
`JPY_TRY`	Japon Yeni (TRY)
`SAR_TRY`	Suudi Riyali (TRY)
`AUD_TRY`	Avustralya Doları (TRY)
`CAD_TRY`	Kanada Doları (TRY)

Hata Yanıtları ve Durum Ucu

Fiyat verisi henüz hazır değilse yanıt 503 durum koduyla {"hata": "veri-yok"} olur; birkaç saniye sonra yeniden deneyin. Bilinmeyen bir /api/v1/ adresi 404 ve {"hata": "bulunamadi"} döndürür.

`401 anahtar-gerekli`	13 Ekim 2026 tarihinden sonra anahtarsız istek. `kayit` alanında anahtar alma adresi bulunur.
`401 gecersiz-anahtar`	Gönderilen anahtar tanınmadı; eksiksiz kopyaladığınızı kontrol edin.
`403 anahtar-kapali`	Anahtar kötüye kullanım ya da koşullara uyulmaması nedeniyle kapatıldı.
`429 sinir-asildi`	Anahtar başına dakikada 60 istek aşıldı; `Retry-After` başlığındaki saniye kadar bekleyin. Kalan hak `X-RateLimit-Remaining` başlığında.
`429 akis-siniri`	Anahtar başına aynı anda 5 canlı akış bağlantısı dolu.

Servisin iş görüp görmediğini GET https://hesaplialtin.com/api/v1/durum ile izleyebilirsiniz: ok (true/false), sebep, veriYasiSn (verinin kaç saniye önce güncellendiği), uptimeSn ve surum alanlarını döndürür; sorun varsa durum kodu 503 olur.

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ı