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
{
"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
Adresi kopyalayın
Kayıt yok, anahtar yok. Tek bir adres tüm fiyatları döner.
GET isteği gönderin
PHP, JavaScript, Python, cURL ya da doğrudan Google Sheets ve Excel'den.
Değeri okuyun
kurlar.ALTIN.satis gibi bir yolla istediğiniz fiyata ulaşın.
Ö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'];
const veri = await fetch('https://api.gramhane.com/v1/prices.json').then(r => r.json());
console.log(veri.kurlar.ALTIN.satis);
console.log(veri.ziynet_ve_diger['Çeyrek (Yeni)'].satis);
import requests
veri = requests.get('https://api.gramhane.com/v1/prices.json',
headers={'User-Agent': 'UygulamaAdiniz/1.0'}, timeout=10).json()
print(veri['kurlar']['ALTIN']['satis'])
print(veri['ziynet_ve_diger']['Çeyrek (Yeni)']['satis'])
curl -s 'https://api.gramhane.com/v1/prices.json' \ -H 'User-Agent: UygulamaAdiniz/1.0' | jq '.kurlar.ALTIN.satis'
// Uzantılar > Apps Script'e yapıştırıp kaydedin.
// Hücrede: =GRAMHANE("ALTIN"; "satis") veya =GRAMHANE("Çeyrek (Yeni)")
function GRAMHANE(kod, alan) {
var onbellek = CacheService.getScriptCache();
var metin = onbellek.get('gramhane');
if (!metin) {
var yanit = UrlFetchApp.fetch('https://api.gramhane.com/v1/prices.json', { muteHttpExceptions: true });
if (yanit.getResponseCode() !== 200) return 'API hatası: ' + yanit.getResponseCode();
metin = yanit.getContentText();
onbellek.put('gramhane', metin, 60);
}
var veri = JSON.parse(metin);
var kalem = veri.kurlar[kod] || veri.ziynet_ve_diger[kod];
return kalem ? Number(kalem[alan || 'satis']) : 'Kod bulunamadı: ' + kod;
}
// Veri > Veri Al > Boş Sorgu > Gelişmiş Düzenleyici'ye yapıştırın.
let
Kaynak = Json.Document(Web.Contents("https://api.gramhane.com/v1/prices.json")),
Kurlar = Record.ToTable(Kaynak[kurlar]),
Ziynet = Record.ToTable(Kaynak[ziynet_ve_diger]),
Tumu = Table.Combine({Kurlar, Ziynet}),
Tablo = Table.ExpandRecordColumn(Tumu, "Value", {"alis", "satis", "yuzde"})
in
Tablo
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ı.
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.
Döviz
kurlar.{KOD}Ayar altın
ziynet_ve_diger["Ad"]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.statussuccessya daerrormeta.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
Retry-After başlığı kaç saniye bekleneceğini söyler.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.