İçeriğe geç
Geliştiriciler İçin

Altın Fiyatı API

Gram, çeyrek, has altın, ons, gümüş, Dolar ve Euro fiyatlarını JSON olarak alın. Ücretsiz ve şartsızdır: kısa bir formla API anahtarı alın, kullanmaya başlayın. Kaynak bağlantısı verirseniz istek hakkınız iki katına çıkar. Şu an gram altın satış fiyatı 6.453,07 ₺.

API Anahtarı

  1. Ücretsiz anahtar alma sayfasında e-posta adresinizi, site ya da uygulama adresinizi ve kısa kullanım amacınızı yazın; anahtar hemen ekranda gösterilir.
  2. Anahtarı her istekte X-API-Key başlığıyla ya da adrese eklenen ?anahtar= parametresiyle gönderin (Excel, Google Sheets ve canlı akışta parametre kolaydır).
  3. 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 yanıt 429 olur.
  4. 13 Ekim 2026 tarihine kadar anahtarsız istekler de yanıtlanır; yanıtta ek bir uyari alanı ve Warning başlığı bulunur. Bu tarihten sonra anahtarsız istekler 401 alır.

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

Ücretsiz anahtar al

Kaynak Olarak Bağlantı Verin, İki Kat İstek Hakkı Kazanın

İsteğe bağlıdır. Kayıtta yazdığınız sitenin ana sayfasında ya da fiyatları gösterdiğiniz sayfada Hesaplı Altın'a bir bağlantı varsa anahtarınızın sınırı dakikada 60 yerine 120 istek olur. Bağlantıyı haftada bir kendimiz kontrol ederiz; ayrıca bir şey yapmanız gerekmez. nofollow, sponsored ya da ugc etiketli bağlantı da geçerlidir. Bağlantı kaldırılırsa sınır bir sonraki kontrolde eski hâline döner.

<p>Fiyatlar: <a href="https://hesaplialtin.com/">Hesaplı Altın</a></p>

Gram altın fiyatı gösteriyorsanız bağlantıyı gram altın sayfasına verebilirsiniz:

<p>Gram altın fiyatı: <a href="https://hesaplialtin.com/gram-altin">Hesaplı Altın</a></p>

Hesaplı Altın'ı Kullanan Siteler

Anlık Fiyatlar

GET https://hesaplialtin.com/api/v1/public-prices

Bütün kalemlerin güncel alış ve satış fiyatını, son 24 saatteki yüzde değişimi ve güncelleme zamanını döndürür. Yanıt 5 saniye önbelleklidir. Örnek yanıt (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"
    }
  }
}

Alanlar

updatedAtVerinin üretildiği an (ISO 8601, UTC)
piyasacanli (fiyatlar akıyor, hafta içi gece de), durgun (fiyatlar bir süredir değişmiyor, çoğunlukla hafta sonu: son fiyat) ya da bilinmiyor (veri 10 dakikadan eski)
alis · satisAlış (bozdururken) ve satış (alırken) fiyatı
degisim24sSatış fiyatının son 24 saatteki yüzde değişimi; arşiv yoksa null
birimFiyatın para birimi: TRY ya da USD
slugKalemin kendi sayfası varsa adresi (ör. gram-altin → https://hesaplialtin.com/gram-altin); yoksa null
guncellemeKalemin son güncellenme anı (ISO 8601)
bayatYalnız true olduğunda gelir: piyasa açıkken kalemin fiyatı 30 dakikadır güncellenmedi
uyariYalnız anahtarsız isteklerde, 13 Ekim 2026 tarihine kadar: anahtar zorunluluğu hatırlatması

Sık Kullanılan Kodlar

GRAM_ALTIN_TRYGram altın (TL)
HAS_ALTIN_TRYHas altın (TL)
CEYREK_YENI_TRYÇeyrek altın, yeni (TL)
YARIM_YENI_TRYYarım altın, yeni (TL)
TAM_YENI_TRYTam altın, yeni (TL)
ATA_YENI_TRYAta altın, yeni (TL)
AYAR22_TRY22 ayar altın gramı (TL)
ONS_ALTIN_USDOns altın (USD)
GUMUS_TRYGram gümüş (TL)
USD_TRYDolar (TL)
EUR_TRYEuro (TL)
GBP_TRYSterlin (TL)
Bütün kodlar (38)
HAS_ALTIN_TRYHas Altın (TRY)
GRAM_ALTIN_TRYGram Altın (TRY)
ONS_ALTIN_USDOns Altın (USD)
ALTIN_KG_USDAltın KG/USD (USD)
ALTIN_KG_EURAltın KG/EUR (EUR)
GUMUS_TRYGümüş (gram) (TRY)
GUMUS_KG_USDGümüş KG/USD (USD)
GUMUS_ONS_USDGümüş Ons (USD)
CEYREK_YENI_TRYÇeyrek Altın (TRY)
CEYREK_ESKI_TRYEski Çeyrek (TRY)
YARIM_YENI_TRYYarım Altın (TRY)
YARIM_ESKI_TRYEski Yarım (TRY)
TAM_YENI_TRYTam Altın (TRY)
TAM_ESKI_TRYEski Tam (TRY)
ATA_YENI_TRYAta Altın (TRY)
ATA_ESKI_TRYEski Ata (TRY)
ATA_CEYREK_YENI_TRYAta Çeyrek (TRY)
ATA_CEYREK_ESKI_TRYEski Ata Çeyrek (TRY)
ATA_YARIM_YENI_TRYAta Yarım (TRY)
ATA_YARIM_ESKI_TRYEski Ata Yarım (TRY)
ATA5_YENI_TRYAta Beşli (TRY)
ATA5_ESKI_TRYEski Ata Beşli (TRY)
GREMESE_YENI_TRYGremse (TRY)
GREMESE_ESKI_TRYEski Gremse (TRY)
RESAT_TRYReşat Altın (TRY)
RESAT25_TRYReşat İkibuçuk (TRY)
RESAT5_TRYReşat Beşli (beşi bir yerde) (TRY)
AYAR22_TRY22 Ayar (TRY)
AYAR18_TRY18 Ayar (TRY)
AYAR14_TRY14 Ayar (TRY)
USD_TRYDolar (TRY)
EUR_TRYEuro (TRY)
GBP_TRYSterlin (TRY)
CHF_TRYİsviçre Frangı (TRY)
JPY_TRYJapon Yeni (TRY)
SAR_TRYSuudi Riyali (TRY)
AUD_TRYAvustralya Doları (TRY)
CAD_TRYKanada Doları (TRY)

Geçmiş Fiyatlar

GET https://hesaplialtin.com/api/v1/public-history?kod=GRAM_ALTIN_TRY&aralik=1a

Bir kalemin geçmiş satış fiyatlarını seri alanında [zaman (milisaniye), satış] çiftleri olarak döndürür (en çok 400 nokta). aralik: 1g (gün), 1h (hafta), 1a (ay), 3a, 6a, 1y, tumu. Yanıt 60 saniye önbelleklidir.

Yapay Zekâ Asistanınıza Bağlayın (MCP)

Claude, Cursor gibi MCP (Model Context Protocol) destekleyen asistanlar bu adrese bağlanıp güncel fiyatı sorabilir, çok parçalı altın hesabı yapabilir ve geçmiş kapanışları çekebilir. Bağlantı anahtar istemez; IP başına dakikada 20 istek sınırı vardır. API anahtarınızı X-API-Key başlığıyla gönderirseniz anahtar sınırınız geçerli olur. Yanıtlar Türkçedir, kaynak bağlantısı taşır ve yatırım tavsiyesi içermez.

POST https://hesaplialtin.com/mcp · Streamable HTTP, JSON-RPC 2.0, oturumsuz

fiyat_alTek kalem fiyatı
fiyatlarAna fiyatlar
hesaplaAltın hesabı
gecmisGeçmiş fiyatlar

Claude Code (terminal):

claude mcp add --transport http hesaplialtin https://hesaplialtin.com/mcp

Cursor (.cursor/mcp.json):

{
  "mcpServers": {
    "hesaplialtin": {
      "url": "https://hesaplialtin.com/mcp"
    }
  }
}

Claude uygulaması ve claude.ai: Ayarlar → Bağlayıcılar (Connectors) → Özel bağlayıcı ekle; adres alanına https://hesaplialtin.com/mcp yazın. Diğer istemciler (VS Code, ChatGPT vb.): istemcinin MCP sunucu ayarında taşıma türü olarak HTTP ("Streamable HTTP") seçip aynı adresi girin.

Makine okunur tanım: openapi.json (OpenAPI 3.1) · API kataloğu: /.well-known/api-catalog · CSV dosyaları ve bütün veri setleri: açık veri sayfası.

Örnek Kod

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

Kullanım Koşulları

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.

Rehber

Sık Sorulan Sorular

Altın fiyatı API ücretsiz mi?

Evet. Kısa bir formla ücretsiz API anahtarı alırsınız; anahtar hemen ekranda gösterilir. Herhangi bir şart yoktur. Veriyi gösterdiğiniz yerde Hesaplı Altın'a kaynak bağlantısı verirseniz dakika sınırınız iki katına çıkar; vermeseniz de API'yi kullanabilirsiniz.

API anahtarı nasıl kullanılır?

Anahtarı her istekte X-API-Key başlığıyla ya da adrese eklenen ?anahtar= parametresiyle gönderin. 13 Ekim 2026 tarihine kadar anahtarsız istekler de yanıtlanır ama yanıtta uyarı bulunur; bu tarihten sonra anahtarsız istekler 401 hatası alır. Sınırlar anahtar başına dakikada 60 istek ve aynı anda 5 canlı akış bağlantısıdır.

Veri ne sıklıkla güncellenir?

Fiyatlar piyasada değiştikçe güncellenir; yanıt 5 saniye önbelleklidir. Bu yüzden servisi 5 saniyeden sık sorgulamanın faydası yoktur; bir dakikada birkaç istek çoğu kullanım için yeterlidir.

Tarayıcıdan doğrudan çağırabilir miyim?

Evet. Servis bütün sitelerden okumaya açıktır (CORS izinli); JavaScript ile anahtarınızı X-API-Key başlığında göndererek doğrudan çağrılabilir. Tarayıcıdaki anahtar ziyaretçilere görünür; sınır anahtar başına olduğu için yoğun kullanımda fiyatı sunucunuzda çekip kısa süre önbellekte tutmanız önerilir.

Fiyatlar nereden geliyor?

Fiyatlar Kapalıçarşı ve serbest piyasa fiyatlarından hesaplanır; yöntem Fiyatları Nasıl Hesaplıyoruz sayfasında anlatılır. Veriler bilgi amaçlıdır, alım satım teklifi değildir.

Yapay zekâ asistanıma bağlayabilir miyim?

Evet. Claude, Cursor gibi MCP (Model Context Protocol) destekleyen asistanlar https://hesaplialtin.com/mcp adresine bağlanıp güncel fiyatı sorabilir, çok parçalı altın hesabı yapabilir ve geçmiş kapanışları çekebilir. Bağlantı anahtar istemez; IP başına dakikada 20 istek sınırı vardır, API anahtarınızı X-API-Key başlığıyla gönderirseniz anahtar sınırınız geçerli olur. Araçlar yalnız okur; yanıtlar Türkçedir, kaynak bağlantısı taşır ve yatırım tavsiyesi içermez.