İçeriğe geç

Python ile Borsa İstanbul verisi çekme (BIST API)

requests ve pandas ile birkaç satırda hisse fiyatları, OHLCV barları ve finansal tablolar. Ekran kazıma yok, kırılan scraper yok: lisanslı veri, tek API anahtarı.

Kurulum

Anahtarınızı panelden üretip ortam değişkenine koyun. Koda gömmeyin; anahtar sizin adınıza kota harcar.

pip install requests pandas
export ISTFIN_API_KEY="istfin_live_..."

Küçük bir istemci

Tüm uçlar aynı { data, meta } zarfını döner. Dakikalık sınır aşılırsa API 429 ve Retry-After başlığı döner; istemci bekleyip tekrar dener.

import os, time, requests

API = "https://api.istfin.com/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['ISTFIN_API_KEY']}"}

def get(path, **params):
    while True:
        r = requests.get(f"{API}{path}", params=params, headers=HEADERS, timeout=10)
        if r.status_code == 429:
            time.sleep(int(r.headers.get("Retry-After", "1")))
            continue
        r.raise_for_status()
        return r.json()["data"]

Hisse fiyatları

Virgülle ayrılmış semboller tek istekte gelir. Fiyat planınıza göre canlı ya da 15 dk gecikmelidir; asOf alanı verinin zamanını verir.

import pandas as pd

quotes = pd.DataFrame(get("/quotes", symbols="THYAO,ASELS,GARAN"))
print(quotes[["symbol", "price", "changePercent", "volume", "asOf"]])

Fiyat barları ve hareketli ortalama

interval 1m, 5m, 15m, 30m, 1h, 4h, 1d, 1w ve 1mo değerlerini alır. t alanı barın başlangıcıdır (UTC epoch saniye).

bars = pd.DataFrame(get("/bars/THYAO", interval="1d", limit=500))
bars["t"] = pd.to_datetime(bars["t"], unit="s", utc=True).dt.tz_convert("Europe/Istanbul")
bars = bars.set_index("t")
bars["sma20"] = bars["c"].rolling(20).mean()
print(bars.tail())

Gelir tablosu

Bilanço (balance), gelir tablosu (income) ve nakit akışı (cashflow) çeyreklik ya da yıllık gelir. periods kolon sırasını verir.

income = get("/financials/THYAO/income", period="quarterly", limit=4)
table = pd.DataFrame(
    {item["tr"]: item["values"] for item in income["items"]},
    index=income["periods"],
).T
print(table.head())

yfinance’ten geçiş

yfinance, Yahoo’nun resmi olmayan arayüzünü kullanır; BIST verisi genellikle gecikmeli gelir ve lisans kapsamı yoktur. Sembolde .IS eki gerekmez: yf.download("THYAO.IS") yerine get("/bars/THYAO", interval="1d") yeterli.

Sık sorulanlar

Python ile Borsa İstanbul verisi nasıl çekilir?

istfin API’ye abone olup panelden anahtar üretin, ardından requests ile https://api.istfin.com/v1 altındaki uçlara Authorization: Bearer başlığıyla istek atın. Yanıt JSON’dur ve doğrudan pandas DataFrame’e çevrilebilir.

Dakikalık BIST verisi alabilir miyim?

Evet. /v1/bars/{symbol} ucu 1 dakikadan aylığa kadar OHLCV bar verir. Tek istekte en fazla 5000 bar döner; daha eskiye gitmek için to parametresini en eski barın zamanına çekin.

Hazır bir Python paketi var mı?

Şu an resmi paket yok; API düz REST olduğu için yukarıdaki on satırlık istemci yeterli. Tüm uçların şeması https://api.istfin.com/openapi.json adresinde, istemci üretmek için kullanılabilir.

Diğer entegrasyonlar

Python ile ilk isteğiniz birkaç dakika uzakta

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