İçeriğe geç

Temel veri

GET /v1/fundamentals, /v1/financials, /v1/ratios: değerleme, finansal tablolar ve oran serisi.

Yetki: fundamentals:read. Temel veri gün sonu (EOD) güncellenir; tutarlar TL, oranlar yüzde ya da kat. Eksik değer null döner.

GET /v1/fundamentals/{symbol}

Son bilançoya göre değerleme, TTM (son 4 çeyrek) gelir tablosu, oranlar, büyüme, bilanço ve nakit akışı özeti. Sembol bulunamazsa 404 NOT_FOUND.

Örnek

curl "https://api.istfin.com/v1/fundamentals/THYAO" \  -H "Authorization: Bearer $ISTFIN_API_KEY"

Yanıt

{
  "data": {
    "symbol": "THYAO",
    "asOfQuarter": "2026Q2",
    "updatedAt": "2026-10-05T21:30:00.000Z",
    "valuation": { "marketCap": 431250000000, "enterpriseValue": 612000000000, "peRatio": 4.8, "pbRatio": 0.9, "evToSales": 0.95, "evToEbitda": 3.7, "pegRatio": null },
    "income": { "revenue": 645000000000, "profit": 89000000000, "ebitda": 165000000000 },
    "incomeQuarterly": { "revenue": 180000000000, "profit": 31000000000, "ebitda": 52000000000 },
    "ratios": { "currentRatio": 1.1, "liquidityRatio": 0.9, "profitMargin": 13.8, "grossProfitMargin": 24.1, "ebitdaMargin": 25.6, "roe": 19.2, "roa": 8.4, "netDebtToEbitda": 1.1, "debtToEquity": 0.6 },
    "growth": { "revenueYoY": 21.4, "profitYoY": -8.2, "ebitdaYoY": 12.9 },
    "balanceSheet": { "totalAssets": 1060000000000, "totalEquity": 470000000000, "totalDebt": 320000000000, "cashAndEquivalents": 140000000000 },
    "cashFlow": { "operating": 150000000000, "investing": -95000000000, "financing": -30000000000, "free": 55000000000 }
  },
  "meta": { "requestId": "req_01jzqk4x8m9b2c5d7e8f9g0h1j" }
}

GET /v1/financials/{symbol}/{statement}

Finansal tablo kalemleri; dönem kolonları en yeniden eskiye.

Parametreler

ParametreTipZorunluVarsayılanAçıklama
symbolstringevetYol parametresi
statementstringevetbalance (bilanço), income (gelir tablosu), cashflow (nakit akışı)
periodstringhayırcumulativecumulative (yıl başından kümülatif, raporlanan), quarterly (bağımsız çeyrek), ttm (son 4 çeyrek)
limitintegerhayır12Dönem (kolon) sayısı, 1 ile 40 arası

Örnek

curl "https://api.istfin.com/v1/financials/THYAO/income?period=quarterly&limit=4" \  -H "Authorization: Bearer $ISTFIN_API_KEY"

Yanıt

{
  "data": {
    "symbol": "THYAO",
    "statement": "income",
    "periodType": "quarterly",
    "template": "industrial",
    "source": "kap",
    "periods": ["2026-06", "2026-03", "2025-12", "2025-09"],
    "items": [
      { "code": "3C", "tr": "Hasılat", "en": "Revenue", "level": 0, "values": { "2026-06": 180000000000, "2026-03": 142000000000, "2025-12": 171000000000, "2025-09": 152000000000 } }
    ]
  },
  "meta": { "requestId": "req_01jzqk4x8m9b2c5d7e8f9g0h1j" }
}

items[].values anahtarları periods ile aynıdır; kolon sırası için periods dizisini kullanın. level kalem hiyerarşisidir (0 ana kalem).

GET /v1/ratios/{symbol}

Günlük değerleme oranı serisi. Her gün için oran, o gün kamuya açık olan bilançoyla hesaplanır (geleceğe bakma yok); asOfQuarter hangi bilançonun kullanıldığını söyler.

Parametreler

ParametreTipZorunluVarsayılanAçıklama
symbolstringevetYol parametresi
metricsstringhayırtümüVirgülle ayrılmış: marketCap, pe, pb, ev, evSales, evEbitda, peg, currentRatio, liquidityRatio, debtToEquity, netDebtToEbitda, profitMargin, grossProfitMargin, ebitdaMargin, roe, roa, assetTurnover
fromstringhayırBaşlangıç günü YYYY-MM-DD
tostringhayırBitiş günü YYYY-MM-DD
limitintegerhayır2000En fazla gün sayısı, 1 ile 5000 arası

Örnek

curl "https://api.istfin.com/v1/ratios/THYAO?metrics=pe,pb&from=2026-09-01&to=2026-09-05" \  -H "Authorization: Bearer $ISTFIN_API_KEY"

Yanıt

{
  "data": [
    { "day": "2026-09-01", "values": { "pe": 4.9, "pb": 0.92 }, "asOfQuarter": "2026Q2", "asOfSource": "kap" },
    { "day": "2026-09-02", "values": { "pe": 4.8, "pb": 0.91 }, "asOfQuarter": "2026Q2", "asOfSource": "kap" }
  ],
  "meta": { "requestId": "req_01jzqk4x8m9b2c5d7e8f9g0h1j" }
}

Bu sayfada