Ücretsiz · API anahtarı gerekmez

Altın ve döviz fiyatları için ücretsiz API

Gram altın, çeyrek, ons, gümüş ve döviz kurlarını tek bir JSON yanıtında alın. E-ticaret sitenize, pazaryeri entegrasyonunuza, kuyumcu ekranınıza ya da Excel tablonuza dakikalar içinde bağlayın.

https://api.gramhane.com/v1/prices.json
200 OK10.11.2026 21:56
{
  "meta": {
    "status": "success",
    "tarih": "2026-11-10 21:56:01",
    "yayin_sahibi": "Gramhane"
  },
  "kurlar": {
    "ALTIN": {
      "alis": 6509.2409,
      "satis": 6538.7349,
      "yuzde": -2.24
    },
    "USD": {
      "alis": 50.1678,
      "satis": 50.2451,
      "yuzde": 0.01
    }
  },
  "ziynet_ve_diger": {
    "Çeyrek (Yeni)": {
      "alis": 10166.78,
      "satis": 10919.69,
      "yuzde": -2.24
    }
  }
}
  • ÜcretsizKayıt ve anahtar yok
  • 60 / dkIP başına istek
  • ~60 snGüncelleme sıklığı
  • 21 kalemAltın ve döviz
  • %100,00Erişilebilirlik, 7 gün
1

Adresi kopyalayın

Kayıt yok, anahtar yok. Tek bir adres tüm fiyatları döner.

2

GET isteği gönderin

PHP, JavaScript, Python, cURL ya da doğrudan Google Sheets ve Excel'den.

3

Değeri okuyun

kurlar.ALTIN.satis gibi bir yolla istediğiniz fiyata ulaşın.

Entegrasyon

Örnek istek

Dilinizi seçin, kodu kopyalayın. Örneklerdeki adres canlı API adresidir.

$ctx = stream_context_create(['http' => ['header' => "User-Agent: SiteAdiniz/1.0\r\n"]]);
$veri = json_decode(file_get_contents('https://api.gramhane.com/v1/prices.json', false, $ctx), true);

echo $veri['kurlar']['ALTIN']['satis'];
echo $veri['ziynet_ve_diger']['Çeyrek (Yeni)']['satis'];
Kullanım alanları

Nerelerde kullanılır?

E-ticaret ve pazaryerleri

Trendyol, Hepsiburada, WooCommerce veya Shopify'daki altın ürünlerinin fiyatını gramaja göre otomatik güncelleyin.

Google Sheets ve Excel

Portföy, muhasebe ya da teklif tablolarında fiyatı elle girmek yerine hücreden çekin.

Bot ve bildirimler

Telegram, Discord veya WhatsApp botlarında fiyat alarmı ve günlük özet gönderin.

Kuyumcu ekranı

Kod yazmadan dükkândaki TV'de canlı fiyat için Kuyumcu Fiyat Ekranı.

Kapsam

Desteklenen fiyatlar

Yanıttaki tüm kalemler. Satış fiyatları 10.11.2026 21:56 itibarıyladır; bir kaleme tıklayarak ayrıntılı fiyat sayfasına gidebilirsiniz.

Referans

Yanıt yapısı ve limitler

Her kalem alis, satis ve yuzde alanlarını taşır. ONS dışındaki tüm fiyatlar TL'dir.

meta.status
success ya da error
meta.tarih
Fiyatların yayınlandığı an, Türkiye saati
kurlar
Döviz ve madenler: USD, EUR, GBP, CHF, ALTIN, ONS, GUMUS
ziynet_ve_diger
Ayar ve ziynet altınlar; anahtar ürünün adıdır
alis
Kuyumcunun sizden alış fiyatı (bozdururken aldığınız)
satis
Kuyumcunun size satış fiyatı (alırken ödediğiniz)
yuzde
Önceki günün son fiyatına göre değişim; piyasa kapalıyken 0
60 / dkIP başına istek limiti. Anahtar ya da kayıt gerekmez.
429Limit aşılınca döner; Retry-After başlığı kaç saniye bekleneceğini söyler.
60 snÖnerilen önbellek süresi. Fiyatlar dakikada bir yenilenir, daha sık istek yeni veri getirmez.
Destek

Sık sorulan sorular

Gramhane API ücretsiz mi?

Evet. Kayıt, API anahtarı ya da ödeme bilgisi gerekmez. Yukarıdaki adrese GET isteği göndermeniz yeterlidir.

API hangi fiyatları veriyor?

Gram has altın, ons altın, gram gümüş; ABD doları, euro, sterlin ve İsviçre frangı; 24, 22, 18 ve 14 ayar altın; çeyrek, yarım, ziynet lira, 2,5'luk (yeni ve eski) ile Cumhuriyet altını. Her kalem için alış, satış ve günlük yüzde değişim döner.

Fiyatlar ne sıklıkla güncellenir?

Piyasa açıkken yaklaşık 60 saniyede bir. Piyasa kapalıyken son kapanış fiyatları yayınlanır ve yüzde değişimler 0 olur.

İstek limiti var mı?

IP adresi başına dakikada 60 istek. Limit aşılırsa API 429 kodu ve Retry-After başlığı döner. Fiyatlar zaten dakikada bir yenilendiği için yanıtı kendi tarafınızda 60 saniye önbelleğe almanız yeterlidir.

Google Sheets veya Excel'e altın fiyatı çekebilir miyim?

Evet. Örnek kodlardaki Google Sheets sekmesindeki fonksiyonla hücreye =GRAMHANE("ALTIN"; "satis") yazabilir, Excel sekmesindeki Power Query sorgusuyla fiyatları tabloya alabilirsiniz.

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

Evet, CORS açıktır. fetch ile istemci tarafından çağırabilirsiniz. Çok ziyaretçili sitelerde limit IP başına uygulandığı için sorun çıkmaz.