Google Sheets ve Excel'de Altın Fiyatı: API ile Canlı Fiyatlar

Elektronik tabloda canlı altın fiyatları

Altın fiyatlandırmasının büyük bölümü hâlâ elektronik tablolarda yapılır: bir kuyumcunun fiyat listesi, bir külçe stoğu, bir hurda altın teklif tablosu veya bir portföy takip tablosu. Google Sheets'te ya da Excel'de canlı bir altın fiyatıyla bu sayılar bir web sitesinden kopyalanmak yerine kendiliğinden güncellenir. Bu rehber ikisini de kuruyor: Google Sheets'te Apps Script ile yazılmış bir =GOLDPRICE("EUR", "gram") özel fonksiyonu ve Excel'de bir Power Query tablosu; her ikisi de otomatik olarak yenilenir ve API anahtarı hücrelerin dışında tutulur.

İkisi de biraz kod gerektirir. MetalAPI JSON döndürür ve iki uygulamada da bir URL'den JSON ayrıştırıp header'da API anahtarı gönderen bir çalışma sayfası formülü yoktur. Apps Script ve Power Query ikisini de yapar.

Bir MetalAPI anahtarına ihtiyacınız var: kredi kartı gerektirmeyen, ayda 100 istek ve günlük fiyat güncellemeleri sunan ücretsiz bir hesap oluşturun. Excel için ayrıca Power Query (Al ve Dönüştür / Get & Transform) içeren bir sürüm gerekir; örneğin Microsoft 365 için Excel ya da Windows'ta Excel 2016 ve sonrası. Fiyatlar planınızın izin verdiği kadar günceldir: Free planda günlük, Lite'ta 30 dakikada bir, Standard'da 10 dakikada bir, Enterprise'da ise 5 saniyede bire kadar.

Google Sheets'te canlı altın fiyatları nasıl alınır

Kurulum, tablonuza bağlı küçük bir Apps Script projesinden ibarettir: anahtarı bir komut dosyası özelliğinden okur, fiyatları UrlFetchApp ile alır, CacheService ile önbelleğe alır ve hücreleriniz için özel fonksiyonlar sunar. Zamana dayalı bir tetikleyici fiyatları güncel tutar.

1. Tabloyu açın ve Uzantılar (Extensions) → Apps Script seçeneğini belirleyin. Bu, o dosyaya bağlı bir komut dosyası projesi oluşturur.
2. Apps Script düzenleyicisinde Proje Ayarları (Project Settings) bölümünü (dişli simgesi) açın, Komut Dosyası Özellikleri (Script Properties) bölümüne inin ve Komut dosyası özelliği ekle (Add script property) düğmesini tıklayın. Özellik adı olarak METALAPI_KEY girin, değer olarak anahtarınızı yapıştırın ve Komut dosyası özelliklerini kaydet (Save script properties) düğmesini tıklayın.
3. Düzenleyici (Editor) bölümüne dönün, Code.gs dosyasının içeriğini aşağıdaki iki kod bloğuyla değiştirin ve kaydedin.
4. Fonksiyon menüsünde refreshPrices seçeneğini belirleyin ve Çalıştır (Run) düğmesini tıklayın. Google, komut dosyasının harici bir hizmete bağlanması ve tabloyu düzenlemesi için sizden bir kez yetki ister.

API anahtarınızı hücrelerin dışında tutun

Anahtarı bir hücreye yapıştırıp URL'yi bir formülle oluşturmayın. Hücredeki bir anahtar, tabloyu açabilen herkes tarafından görülebilir, her kopya ve dışa aktarmayla birlikte taşınır ve siz sildikten sonra da sürüm geçmişinde kalır. Ona sahip olan herkes kotanızı harcayabilir.

Komut dosyası özellikleri daha iyi bir yerdir: tablonun ızgarasının parçası olmadıkları için hücrelerde, dışa aktarmalarda veya sürüm geçmişinde görünmezler. Yine de bir kasa değildirler. Tabloda düzenleme erişimi olan herkes Uzantılar (Extensions) → Apps Script menüsünü açıp onları okuyabilir. Bu nedenle:

• Her tablo için ayrı bir anahtar kullanın; böylece diğer entegrasyonları bozmadan onu iptal edebilirsiniz. Kimlik doğrulama rehberi anahtar oluşturmayı ve yenilemeyi anlatır.
• Düzenleme erişimini yalnızca anahtarı vereceğiniz kişilere verin. Görüntüleyenler ve yorumcular komut dosyası düzenleyicisini açamaz, ancak tablonun bir kopyası ona bağlı komut dosyasının da bir kopyasını içerir. Geniş çapta paylaşılan dosyalarda, paylaşım ayarlarından görüntüleyenler ve yorumcular için kopyalamayı kapatın.
• Anahtarı bir header'da gönderin. Komut dosyası api_key parametresi yerine X-API-Key kullanır; böylece anahtar loglanan URL'lere düşmez.
• Şüpheye düştüğünüzde yenileyin: yeni bir anahtar oluşturun, komut dosyası özelliğini güncelleyin, ardından eski anahtarı panelden iptal edin.

Google Sheets için bir GOLDPRICE özel fonksiyonu

Bunu Code.gs dosyasına yapıştırın. METALPRICE dört değerli metali kapsar, GOLDPRICE ise altın için bir kısayoldur. Tek bir istek dört metalin tümünü döndürür; bu nedenle aynı para birimi ve birimdeki altın ve gümüş, önbellekteki tek bir yanıtı paylaşır.

// Google Sheets için MetalAPI fiyatları. API anahtarı bir hücreden değil,
// METALAPI_KEY komut dosyası özelliğinden (Proje Ayarları) okunur.
const API = "https://metalapi.com/api/v1";
const SYMBOLS = ["XAU", "XAG", "XPT", "XPD"];
const CACHE_SECONDS = 3600; // 1 saat; Apps Script en fazla 21600'e izin verir

function fetchLatest_(base, unit) {
  const key = PropertiesService.getScriptProperties().getProperty("METALAPI_KEY");
  if (!key) throw new Error("Add the script property METALAPI_KEY first.");
  const url = API + "/latest?base=" + encodeURIComponent(base) +
    "&currencies=" + SYMBOLS.join(",") + "&unit=" + encodeURIComponent(unit);
  const res = UrlFetchApp.fetch(url, {
    headers: { "X-API-Key": key },
    muteHttpExceptions: true, // hata fırlatmak yerine hata yanıtlarını döndür
  });
  let data;
  try {
    data = JSON.parse(res.getContentText());
  } catch (e) {
    throw new Error("MetalAPI: unexpected HTTP " + res.getResponseCode() + " response");
  }
  if (!data.success) {
    throw new Error("MetalAPI " + data.error.code + " (" + data.error.type + "): " + data.error.info);
  }
  return data;
}

function cachedLatest_(base, unit, refresh) {
  const cache = CacheService.getScriptCache();
  const cacheKey = ["latest", base, unit, refresh].join("|");
  const hit = cache.get(cacheKey);
  if (hit) return JSON.parse(hit);
  const data = fetchLatest_(base, unit);
  cache.put(cacheKey, JSON.stringify(data), CACHE_SECONDS);
  return data;
}

/**
 * MetalAPI'den bir değerli metalin en güncel fiyatı.
 *
 * @param {string} symbol XAU (altın), XAG (gümüş), XPT (platin) veya XPD (paladyum).
 * @param {string} currency USD, EUR veya GBP gibi bir para birimi kodu. Varsayılan USD.
 * @param {string} unit troy_oz (varsayılan), gram veya kilogram.
 * @param {any} refresh Prices!B1 gibi isteğe bağlı bir hücre. Değiştiğinde fiyatlar yeniden alınır.
 * @return Metalin bir biriminin para birimi cinsinden fiyatı.
 * @customfunction
 */
function METALPRICE(symbol, currency, unit, refresh) {
  const s = String(symbol || "XAU").trim().toUpperCase();
  const base = String(currency || "USD").trim().toUpperCase();
  const u = String(unit || "troy_oz").trim().toLowerCase();
  const data = cachedLatest_(base, u, String(refresh || ""));
  const price = data.rates[data.base + s];
  if (price === undefined) throw new Error("No " + s + " price in " + base + ".");
  return price;
}

/**
 * MetalAPI'den en güncel altın fiyatı, örneğin =GOLDPRICE("EUR", "gram").
 *
 * @param {string} currency USD, EUR veya GBP gibi bir para birimi kodu. Varsayılan USD.
 * @param {string} unit troy_oz (varsayılan), gram veya kilogram.
 * @param {any} refresh Prices!B1 gibi isteğe bağlı bir hücre. Değiştiğinde fiyatlar yeniden alınır.
 * @return Birim başına, para birimi cinsinden altın fiyatı.
 * @customfunction
 */
function GOLDPRICE(currency, unit, refresh) {
  return METALPRICE("XAU", currency, unit, refresh);
}

Şimdi herhangi bir hücreye bir formül yazın (Türkiye yerel ayarlı tablolarda bağımsız değişkenleri virgül yerine noktalı virgülle ayırın):

Perde arkasında:

• @customfunction, fonksiyonları formül otomatik tamamlamasına ekler ve yorumu yardım metni olarak kullanır.
• muteHttpExceptions: true hata fırlatmak yerine hata yanıtlarını döndürür; böylece hücre #ERROR! gösterir ve üzerine gelindiğinde MetalAPI'nin kodu ve mesajı görünür, örneğin bilinmeyen bir para birimi için 201 (invalid_base).
• CacheService her yanıtı CACHE_SECONDS süresince, en fazla altı saat saklar. Aynı para birimi, birim ve yenileme değerine sahip hücreler bu yanıtı paylaşır.
• Önbellekte olmayan her para birimi ve birim bir isteğe mal olur ve her formül hücresi Google sunucularına ayrı bir çağrıdır. Yüzlerce fiyat hücresi olan tablolarda bunun yerine aşağıdaki Prices sayfasına başvurun.

Bilinmeyen bir para birimi gibi doğrulama hataları ücretlendirilir; bu nedenle bozuk formülleri hemen düzeltin. İstek limitleri rehberi nelerin sayıldığını listeler.

Google Sheets'te altın fiyatını zamana dayalı bir tetikleyiciyle yenileyin

Google Sheets bir özel fonksiyonu bir saate göre değil, bağımsız değişkenleri değiştiğinde yeniden çalıştırır; Dosya (File) → Ayarlar (Settings) → Hesaplama (Calculation) altındaki yeniden hesaplama ayarı yalnızca NOW ve RAND gibi fonksiyonları etkiler. Zamanlanmış güncellemeler için fiyatları zamana dayalı bir tetikleyicinin bir sayfaya yazmasını sağlayın. Bunu 1. bölümün altına ekleyin:

/** En güncel fiyatları "Prices" adlı bir sayfaya yazar. Zamana dayalı bir tetikleyiciden çalıştırın. */
function refreshPrices() {
  const data = fetchLatest_("USD", "troy_oz");
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  const sheet = ss.getSheetByName("Prices") || ss.insertSheet("Prices");
  const rows = [
    ["Updated", new Date(data.timestamp * 1000)],
    ["Symbol", data.base + " per troy oz"],
  ];
  SYMBOLS.forEach(function (s) {
    rows.push([s, data.rates[data.base + s]]);
  });
  sheet.getRange(1, 1, rows.length, 2).setValues(rows);
}

/** Düzenleyiciden bir kez çalıştırın. refreshPrices için mevcut zamanlamaların yerini alır. */
function installTrigger() {
  ScriptApp.getProjectTriggers().forEach(function (t) {
    if (t.getHandlerFunction() === "refreshPrices") ScriptApp.deleteTrigger(t);
  });
  ScriptApp.newTrigger("refreshPrices").timeBased().everyHours(1).create();
}

installTrigger fonksiyonunu düzenleyiciden bir kez çalıştırın ya da tetikleyiciyi Tetikleyiciler (Triggers) (saat simgesi) → Tetikleyici Ekle (Add Trigger) altında refreshPrices, Zamana dayalı (Time-driven) ve bir aralık seçerek elle ekleyin.

Her çalıştırma bir isteğe mal olur; veri zamanını Prices!B1 hücresine, altına da her metal için bir satır yazar; Prices!B3, troy ons başına ABD doları cinsinden altındır. Bu hücrelere doğrudan başvurun ya da Prices!B1 hücresini yenileme bağımsız değişkeni olarak verin: =GOLDPRICE("EUR", "gram", Prices!B1), tetikleyici yeni bir veri zamanı yazdığında para birimi ve birim başına bir kez yeniden veri alır; zamanın değişmediği hafta sonlarında ise hiç almaz. Prices sayfasını başka bir para birimi veya birimde istiyorsanız refreshPrices içindeki fetchLatest_ çağrısının bağımsız değişkenlerini değiştirin.

Aralığı planınıza göre ayarlayın; fiyatların güncellenmesinden daha sık yenilemek yalnızca aynı değerleri tekrarlar:

Yenileme bağımsız değişkeni kullanan özel fonksiyonlar, her para birimi ve birim için yenileme başına bir istek ekler. Lite'ta saatlik bir tetikleyici ile GOLDPRICE("EUR", "gram", Prices!B1) birlikte ayda yaklaşık 1.500 isteğe ulaşabilir; bu, planın 1.000 isteklik kotasını aşar. .everyHours(2) kullanın ya da yalnızca Prices sayfasıyla yetinin. Tetikleyiciler tam olarak planlanan zamanda değil, ona yakın bir zamanda çalışır ve atHour komut dosyasının saat dilimini kullanır.

Excel'de Power Query ile altın fiyatı

Excel'de Power Query API'yi çağırır, JSON'u ayrıştırır ve zamanlamaya göre yenilenen bir tablo yükler:

1. Veri (Data) sekmesinde Veri Al (Get Data) → Diğer Kaynaklardan (From Other Sources) → Boş Sorgu (Blank Query) seçeneğini belirleyin.
2. Power Query Düzenleyicisi'nde Giriş (Home) → Gelişmiş Düzenleyici (Advanced Editor) seçeneğini belirleyin, aşağıdaki sorguyu yapıştırın ve Bitti (Done) düğmesini tıklayın.
3. https://metalapi.com/ adresine nasıl bağlanılacağı sorulduğunda Kimlik Bilgilerini Düzenle (Edit Credentials) düğmesini tıklayın, Web API seçeneğini belirleyin, anahtarınızı Anahtar (Key) alanına yapıştırın ve Bağlan (Connect) düğmesini tıklayın.
4. Sorguyu GoldPrices olarak yeniden adlandırın ve Giriş (Home) → Kapat ve Yükle (Close & Load) seçeneğini belirleyin. Excel sorguyu yeni bir sayfaya, sorgunun adını taşıyan bir tablo olarak yükler.

let
    BaseCurrency = "EUR",
    MassUnit = "gram",
    Symbols = {"XAU", "XAG", "XPT", "XPD"},
    Response = Json.Document(
        Web.Contents(
            "https://metalapi.com/api/v1/latest",
            [
                Query = [base = BaseCurrency, currencies = Text.Combine(Symbols, ","), unit = MassUnit],
                ApiKeyName = "api_key"
            ]
        )
    ),
    Updated = #datetime(1970, 1, 1, 0, 0, 0) + #duration(0, 0, 0, Response[timestamp]),
    Prices = Table.FromRecords(
        List.Transform(
            Symbols,
            (symbol) => [
                Symbol = symbol,
                Price = Record.Field(Response[rates], Response[base] & symbol),
                Currency = Response[base],
                Unit = MassUnit,
                #"Updated (UTC)" = Updated
            ]
        )
    ),
    Typed = Table.TransformColumnTypes(
        Prices,
        {{"Symbol", type text}, {"Price", type number}, {"Currency", type text},
         {"Unit", type text}, {"Updated (UTC)", type datetime}}
    )
in
    Typed

Sorgu, yanıttaki base ile öneklenmiş anahtarı okur (EUR için EURXAU) ve Unix timestamp değerini UTC'ye dönüştürür. BaseCurrency ve MassUnit değerlerini ihtiyacınıza göre değiştirin.

ApiKeyName = "api_key" anahtarı dosyanın dışında tutar: Power Query onu Web API kimlik bilgisinden alır ve MetalAPI'nin anahtarı kabul ettiği üç yoldan biri olan api_key sorgu parametresi olarak ekler. Kimlik bilgisi çalışma kitabında değil, bilgisayarınızdaki Excel veri kaynağı ayarlarında saklanır; bu nedenle dosyayı açan bir iş arkadaşınızdan kendi anahtarı istenir. Onu Veri (Data) → Veri Al (Get Data) → Veri Kaynağı Ayarları (Data Source Settings) altından değiştirebilir veya kaldırabilirsiniz.

Web.Contents, Headers = [#"X-API-Key" = "..."] seçeneğini de kabul eder, ancak bu, anahtarı çalışma kitabının içine kaydeder. Bunu yalnızca bilgisayarınızdan hiç çıkmayacak dosyalar için kullanın.

Formüllerde fiyatları tablodan arayın: =XLOOKUP("XAU", GoldPrices[Symbol], GoldPrices[Price]) gram başına euro cinsinden altını döndürür (Türkçe Excel'de işlevin adı ÇAPRAZARA'dır ve bağımsız değişkenler noktalı virgülle ayrılır); eski sürümlerde INDEX ile MATCH (İNDİS ve KAÇINCI) aynı işi görür.

Excel'de altın fiyatlarını otomatik olarak yenileyin

Bir Power Query tablosu kendi kendine yenilenmez. Veri (Data) → Sorgular ve Bağlantılar (Queries & Connections) bölümünü açın, GoldPrices sorgusuna sağ tıklayın ve Özellikler (Properties) seçeneğini belirleyin. Yenileme denetimi (Refresh control) altında:

• Her N dakikada bir yenile (Refresh every N minutes) sorguyu bir zamanlayıcıyla yeniden çalıştırır.
• Dosyayı açarken verileri yenile (Refresh data when opening the file) çalışma kitabı her açıldığında güncel fiyatları alır.
• Arka planda yenilemeyi etkinleştir (Enable background refresh) sorgu çalışırken Excel'in kullanılabilir kalmasını sağlar.

Veri (Data) → Tümünü Yenile (Refresh All) (Ctrl+Alt+F5) istediğiniz anda yeniler. Zamanlayıcı yalnızca çalışma kitabı açıkken çalışır.

Her yenileme bir istektir. Sekiz saatlik bir iş gününde saatte bir yenileme ayda yaklaşık 180, 10 dakikada bir yenileme yaklaşık 1.050 istek eder. Fiyatların günlük güncellendiği Free planda dosya açılırken yenilemek yeterlidir.

Sheets ve Excel'de geçmiş altın fiyatları

Geçmiş kapanış fiyatları /timeframe endpoint'inden gelir: start_date ile end_date arasındaki her işlem günü için bir kayıt; istek başına Free planda en fazla 30, ücretli planlarda 365 gün. Excel'de ikinci bir sorgu bir tarih sütunu ve her metal için bir sütun verir:

let
    Response = Json.Document(
        Web.Contents(
            "https://metalapi.com/api/v1/timeframe",
            [
                Query = [start_date = "2026-09-24", end_date = "2026-10-23", currencies = "XAU,XAG"],
                ApiKeyName = "api_key"
            ]
        )
    ),
    Days = Record.ToTable(Response[rates]),
    History = Table.FromRecords(
        List.Transform(
            Table.ToRecords(Days),
            (row) => [
                Date = Date.FromText(row[Name]),
                Gold = Record.FieldOrDefault(row[Value], Response[base] & "XAU", null),
                Silver = Record.FieldOrDefault(row[Value], Response[base] & "XAG", null)
            ]
        )
    ),
    Typed = Table.TransformColumnTypes(History, {{"Date", type date}, {"Gold", type number}, {"Silver", type number}})
in
    Typed

Hafta sonları ve piyasa tatilleri yer almaz; bu nedenle takvim günlerinden daha az satır bekleyin. Apps Script'te /timeframe endpoint'ini, fetchLatest_ fonksiyonunun /latest çağrısını yaptığı gibi UrlFetchApp ile çağırın ve tüm satırları tek bir setValues çağrısıyla yazın.

Geçmiş kapanışlar hiç değişmez; bu nedenle bir aralığı bir kez yükleyip saklayın. API ile geçmiş altın ve gümüş fiyatları yazısı uzun geriye dönük veri doldurmayı, depolamayı ve grafikleri ele alır.

Sonraki adımlar

Ücretsiz bir hesap oluşturun, anahtarı bir komut dosyası özelliği veya Web API kimlik bilgisi olarak ekleyin; yaklaşık on dakika içinde tablonuzda bir altın fiyatı olur. Free planın günlük fiyatları günlük bir fiyat listesine veya portföy tablosuna uygundur; daha güncel fiyatlar veya daha fazla yenileme için planları fiyatlandırma sayfasında karşılaştırın. API dokümantasyonu, aynı şekilde çağırabileceğiniz tüm endpoint'leri listeler; bunlara /convert ve ücretli planlarda ayar altın fiyatları için /carat da dahildir.

Sık sorulan sorular

Altın fiyatlarını bunun yerine IMPORTDATA veya IMPORTXML ile içe aktarabilir miyim?

MetalAPI'den hayır. Bu fonksiyonlar CSV, TSV, XML veya HTML okur, API ise JSON döndürür; ayrıca header gönderemezler, dolayısıyla anahtar formülün içinde durur ve her görüntüleyen onu görebilir.

Tablomdaki altın fiyatı ne sıklıkla güncellenir?

Sizin yenilediğiniz ve planınızın izin verdiği sıklıkta: Free planda günlük, Lite'ta 30 dakikada bir, Standard'da 10 dakikada bir, daha üst planlarda daha sık. New York saatiyle cuma 17:00'den pazar 17:00'ye kadar spot piyasa kapalıdır ve fiyat cuma kapanışında kalır.

Tablom kaç API isteği kullanır?

Prices sayfasının veya Power Query tablosunun her yenilemesi için bir istek; buna ek olarak özel fonksiyonlar güncel fiyat aldığında her para birimi ve birim için bir istek. Saatlik bir tetikleyici ayda yaklaşık 744, günlük bir tetikleyici yaklaşık 31 istek kullanır. /usage, tüketiminizi kotadan düşülmeden raporlar.

Altın fiyatlarını çeken bir tabloyu paylaşmak güvenli mi?

Evet, anahtar hücrelerin dışında kaldığı sürece: Google Sheets'te düzenleme erişimi yalnızca anahtar konusunda güvendiğiniz kişilere verilmiş bir komut dosyası özelliği, Excel'de ise Web API kimlik bilgisi. Paylaşılan her dosya için ayrı bir anahtar kullanın; böylece onu tek başına iptal edebilirsiniz.

Altın fiyatını gram başına veya yerel para birimimde alabilir miyim?

Evet. =GOLDPRICE("INR", "gram") örneğinde olduğu gibi bir para birimi kodu ve gram ya da kilogram verin veya Power Query'de BaseCurrency ve MassUnit değerlerini değiştirin. API her ikisini de aynı anlık görüntüden dönüştürür.