Geliştiriciler İçin

Python Altın Fiyatı API Örneği

Python ile altın fiyatı almak için requests kütüphanesiyle, ücretsiz API anahtarınızı başlıkta göndererek tek bir istek yeterlidir; yanıt JSON olarak gelir ve sözlük gibi kullanılır. Örnekler Python 3.8 ve üzerinde çalışır.

Kurulum

pip install requests

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

Güncel Fiyatları Alma

import requests

ADRES = "https://hesaplialtin.com/api/v1/public-prices"
BASLIK = {"X-API-Key": "ANAHTARINIZ"}

yanit = requests.get(ADRES, headers=BASLIK, timeout=10)
yanit.raise_for_status()  # 503: veri hazır değil; 401/429: anahtar ya da sınır
veri = yanit.json()

print("Güncelleme:", veri["updatedAt"], "piyasa:", veri["piyasa"])
for kod in ("GRAM_ALTIN_TRY", "CEYREK_YENI_TRY", "ONS_ALTIN_USD", "USD_TRY"):
    k = veri["kalemler"].get(kod)
    if k is None:
        continue
    degisim = "yok" if k["degisim24s"] is None else f"{k['degisim24s']:+.2f} %"
    print(f"{k['etiket']}: alış {k['alis']} satış {k['satis']} {k['birim']} (24 saat: {degisim})")

Geçmiş Seriyi CSV Dosyasına Yazma

Aşağıdaki kod son 30 günün gram altın satış fiyatlarını tarih ve fiyat sütunlarıyla gram-altin.csv dosyasına yazar. Parametrelerin tamamı geçmiş fiyatlar kılavuzunda.

import csv
from datetime import datetime, timezone

import requests

yanit = requests.get(
    "https://hesaplialtin.com/api/v1/public-history",
    params={"kod": "GRAM_ALTIN_TRY", "aralik": "1a"},
    headers={"X-API-Key": "ANAHTARINIZ"},
    timeout=10,
)
yanit.raise_for_status()
veri = yanit.json()

with open("gram-altin.csv", "w", newline="", encoding="utf-8") as dosya:
    yazici = csv.writer(dosya)
    yazici.writerow(["zaman_utc", "satis"])
    for t, satis in veri["seri"]:
        yazici.writerow([datetime.fromtimestamp(t / 1000, tz=timezone.utc).isoformat(), satis])

if veri["ozet"]:
    print("Dönem değişimi (%):", veri["ozet"]["degisimYuzde"])

Düzenli Sorgulama

Fiyatı bir döngüyle izleyecekseniz istekler arasında en az 15 saniye bekleyin; fiyat değiştiği anda veri gerekiyorsa sorgulamak yerine canlı akışı dinleyin. Aynı veriyi başka dillerde görmek için JavaScript ve PHP örneklerine 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ı