İçeriğe geç

Google Sheets’e BIST verisi çekme (Apps Script + BIST API)

GOOGLEFINANCE bazı BIST hisselerinde gecikmeli ya da eksik veri döndürebilir. Apps Script ile istfin API’yi bağlayın, =ISTFIN_FIYAT("THYAO,ASELS") gibi kendi formülünüzü yazın.

Anahtarı güvenle saklayın

Uzantılar > Apps Script > Proje Ayarları > Komut dosyası özellikleri altında ISTFIN_KEY adında bir özellik ekleyip değerine anahtarınızı yazın. Anahtar hücrelerde görünmez.

Fiyat fonksiyonu

Apps Script düzenleyicisinde Code.gs dosyasına yapıştırıp kaydedin. Sonra herhangi bir hücreye =ISTFIN_FIYAT("THYAO,ASELS,GARAN") yazın.

function istfin_(path) {
  const key = PropertiesService.getScriptProperties().getProperty('ISTFIN_KEY')
  const res = UrlFetchApp.fetch('https://api.istfin.com/v1' + path, {
    headers: { Authorization: 'Bearer ' + key }
  })
  return JSON.parse(res.getContentText()).data
}

/** BIST fiyatları (canlı ya da 15 dk gecikmeli). =ISTFIN_FIYAT("THYAO,ASELS") */
function ISTFIN_FIYAT(symbols) {
  const rows = istfin_('/quotes?symbols=' + encodeURIComponent(symbols))
  return [['Sembol', 'Fiyat', 'Değişim %', 'Hacim']].concat(
    rows.map((q) => [q.symbol, q.price, q.changePercent, q.volume])
  )
}

Geçmiş fiyat barları

Aynı dosyaya ekleyin. =ISTFIN_BAR("THYAO"; "1d"; 100) son 100 günlük OHLCV verisini tarih sütunuyla getirir.

/** BIST fiyat barları. =ISTFIN_BAR("THYAO"; "1d"; 100) */
function ISTFIN_BAR(symbol, interval, limit) {
  const bars = istfin_('/bars/' + symbol + '?interval=' + (interval || '1d') + '&limit=' + (limit || 100))
  return [['Tarih', 'Açılış', 'Yüksek', 'Düşük', 'Kapanış', 'Hacim']].concat(
    bars.map((b) => [new Date(b.t * 1000), b.o, b.h, b.l, b.c, b.v])
  )
}

Kota dostu kullanım

Her formül hücresi ayrı bir istek atar. Sembolleri tek formülde toplayın; tablo yeniden hesaplandıkça istek sayısı artar, günlük kalan hakkınızı panelin Kullanım sayfasından izleyin.

Sık sorulanlar

Google Sheets’e canlı BIST verisi nasıl çekilir?

Apps Script’te UrlFetchApp ile istfin API’nin /v1/quotes ucunu Authorization başlığıyla çağıran bir özel fonksiyon yazın; fonksiyon satır dizisi döndürdüğünde sonuç hücrelere tablo olarak yayılır. Temel planda veriler 15 dk gecikmeli, Canlı planda fiyat canlıdır.

GOOGLEFINANCE ile farkı ne?

GOOGLEFINANCE ücretsizdir ama BIST için gecikmeli ve kapsamı sınırlıdır; finansal tablo ve KAP bildirimi vermez. istfin API lisanslı veri ve temel veri uçları sunar.

Formül hata veriyorsa?

İlk çalıştırmada Apps Script dış bağlantı izni ister; düzenleyicide fonksiyonu bir kez çalıştırıp izin verin. 401 hatası anahtarın yanlış ya da iptal edilmiş olduğunu, 429 dakikalık sınırın aşıldığını gösterir.

Diğer entegrasyonlar

Google Sheets ile ilk isteğiniz birkaç dakika uzakta

Abone olun, panelden anahtarınızı üretin, yukarıdaki kodu yapıştırın.