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
| Parametre | Tip | Zorunlu | Varsayılan | Açıklama |
|---|---|---|---|---|
symbol | string | evet | Yol parametresi | |
statement | string | evet | balance (bilanço), income (gelir tablosu), cashflow (nakit akışı) | |
period | string | hayır | cumulative | cumulative (yıl başından kümülatif, raporlanan), quarterly (bağımsız çeyrek), ttm (son 4 çeyrek) |
limit | integer | hayır | 12 | Dö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
| Parametre | Tip | Zorunlu | Varsayılan | Açıklama |
|---|---|---|---|---|
symbol | string | evet | Yol parametresi | |
metrics | string | hayır | tümü | Virgülle ayrılmış: marketCap, pe, pb, ev, evSales, evEbitda, peg, currentRatio, liquidityRatio, debtToEquity, netDebtToEbitda, profitMargin, grossProfitMargin, ebitdaMargin, roe, roa, assetTurnover |
from | string | hayır | Başlangıç günü YYYY-MM-DD | |
to | string | hayır | Bitiş günü YYYY-MM-DD | |
limit | integer | hayır | 2000 | En 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" }
}