Giriş
istfin API, Borsa İstanbul hisseleri için fiyat, tarihsel fiyat barları ve temel veri sunan bir REST API'dir. Fiyat ve endeks planınıza göre canlı ya da 15 dk gecikmeli; hacim herkese 15 dk gecikmeli.
Genel bakış
- Base URL:
https://api.istfin.com - Sürüm: tüm uçlar
/v1/ön ekiyle başlar. - Kimlik doğrulama:
Authorization: Bearer istfin_live_...(Kimlik doğrulama) - Biçim: JSON. Başarılı yanıt
{ "data": ..., "meta": { "requestId": "..." } }, hata{ "error": {...}, "meta": {...} }(Hatalar) - Veri gecikmesi: Canlı planda fiyat ve endeks canlı, hacim 15 dk gecikmelidir; Temel planda fiyat, hacim ve endeks 15 dk gecikmelidir. Etkin yetkiniz
/v1/meentitlementsalanında. - Zaman: tüm zaman damgaları UTC'dir. Mumlarda epoch saniye, diğer alanlarda ISO 8601.
- Limitler: plana bağlı; planınızın değerleri
/v1/meyanıtında (Limitler)
Tüm uçlar sadece GET kabul eder. Ürün özeti için Borsa API, KAP API ve Borsa MCP sayfalarına bakın.
5 dakikada başlangıç
API anahtarı alın
Panel üzerinden bir anahtar oluşturun. Ham anahtar yalnızca oluşturma anında gösterilir; güvenli bir yerde saklayın.
İlk isteği atın
export ISTFIN_API_KEY="istfin_live_..."
curl "https://api.istfin.com/v1/quotes?symbols=THYAO,GARAN" \
-H "Authorization: Bearer $ISTFIN_API_KEY"Yanıtı okuyun
{
"data": [
{
"symbol": "THYAO",
"name": "Türk Hava Yolları",
"price": 312.5,
"change": 4.25,
"changePercent": 1.38,
"open": 309.0,
"high": 314.75,
"low": 307.5,
"previousClose": 308.25,
"volume": 48213560,
"marketCap": 431250000000,
"asOf": "2026-10-06T12:41:03.000Z"
}
],
"meta": { "requestId": "req_01jzqk4x8m9b2c5d7e8f9g0h1j" }
}Limitleri takip edin
Her yanıtta X-RateLimit-Remaining (dakika) ve X-Quota-Remaining (gün) başlıkları bulunur. 429 alırsanız Retry-After saniyesi kadar bekleyin.
Uçlar
| Uç | Açıklama | Yetki (scope) |
|---|---|---|
GET /v1/symbols | Sembol listesi, endeks/sektör/arama filtreleri | market:read |
GET /v1/symbols/{symbol} | Tek sembol detayı | market:read |
GET /v1/quotes | Fiyatlar (en fazla 100 sembol) | market:read |
GET /v1/market/movers | Yükselen, düşen ve hacim liderleri | market:read |
GET /v1/bars/{symbol} | Tarihsel OHLCV barlar | market:read |
GET /v1/fundamentals/{symbol} | Değerleme, oranlar, büyüme, bilanço özeti | fundamentals:read |
GET /v1/financials/{symbol}/{statement} | Finansal tablo (bilanço, gelir, nakit akışı) | fundamentals:read |
GET /v1/ratios/{symbol} | Günlük değerleme oranı serisi | fundamentals:read |
GET /v1/me | Anahtar, plan ve günlük kullanım | account:read |
Tam parametre ve şema listesi için OpenAPI referansı sayfalarına bakın. Ham şema: https://api.istfin.com/openapi.json.