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ı
- Ü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.
- Anahtarı her istekte
X-API-Keybaşlığıyla ya da adrese eklenen?anahtar=parametresiyle gönderin (Excel, Google Sheets ve canlı akışta parametre kolaydı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 yanıt
429olur. - 13 Ekim 2026 tarihine kadar anahtarsız istekler de yanıtlanır; yanıtta ek bir
uyarialanı veWarningbaşlığı bulunur. Bu tarihten sonra anahtarsız istekler401alır.
curl -H "X-API-Key: ANAHTARINIZ" https://hesaplialtin.com/api/v1/public-prices
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
updatedAt | Verinin üretildiği an (ISO 8601, UTC) |
piyasa | canli (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 · satis | Alış (bozdururken) ve satış (alırken) fiyatı |
degisim24s | Satış fiyatının son 24 saatteki yüzde değişimi; arşiv yoksa null |
birim | Fiyatın para birimi: TRY ya da USD |
slug | Kalemin kendi sayfası varsa adresi (ör. gram-altin → https://hesaplialtin.com/gram-altin); yoksa null |
guncelleme | Kalemin son güncellenme anı (ISO 8601) |
bayat | Yalnız true olduğunda gelir: piyasa açıkken kalemin fiyatı 30 dakikadır güncellenmedi |
uyari | Yalnız anahtarsız isteklerde, 13 Ekim 2026 tarihine kadar: anahtar zorunluluğu hatırlatması |
Sık Kullanılan Kodlar
GRAM_ALTIN_TRY | Gram altın (TL) |
HAS_ALTIN_TRY | Has altın (TL) |
CEYREK_YENI_TRY | Çeyrek altın, yeni (TL) |
YARIM_YENI_TRY | Yarım altın, yeni (TL) |
TAM_YENI_TRY | Tam altın, yeni (TL) |
ATA_YENI_TRY | Ata altın, yeni (TL) |
AYAR22_TRY | 22 ayar altın gramı (TL) |
ONS_ALTIN_USD | Ons altın (USD) |
GUMUS_TRY | Gram gümüş (TL) |
USD_TRY | Dolar (TL) |
EUR_TRY | Euro (TL) |
GBP_TRY | Sterlin (TL) |
Bütün kodlar (38)
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) |
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_al | Tek kalem fiyatı |
fiyatlar | Ana fiyatlar |
hesapla | Altın hesabı |
gecmis | Geç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.
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.