Veriler hangi saat diliminde?
Tüm zaman damgaları UTC’dir. Mumlarda t alanı barın başlangıcıdır (epoch saniye); devam eden açık bar yanıta dahil edilmez. İstanbul saati UTC+3’tür.
Borsa İstanbul’dan gelen lisanslı verinin kodunuza ya da yapay zeka asistanınıza ulaşana kadar izlediği yol: kaynak, kimlik doğrulama, limitler ve yanıt biçimi.
Fiyat ve işlem verisi Borsa İstanbul’dan lisanslı olarak akar ve mumlara (1 dakikadan aylığa) işlenir; API’de fiyat ve endeks Canlı planda canlı, Temel planda 15 dk gecikmeli sunulur; hacim iki planda da 15 dk gecikmeli. Finansal tablolar ve bildirimler şirketlerin KAP’ta (Kamuyu Aydınlatma Platformu) yayımladığı raporlardan derlenir; oranlar her gün, o gün kamuya açık olan bilançoyla yeniden hesaplanır.
E-posta koduyla ya da Google ile giriş yapar, aylık plana abone olursunuz. Borsa İstanbul lisansı gereği fatura adresi alınır. Panelden ürettiğiniz istfin_live_ anahtarı yalnızca bir kez gösterilir; sunucuda düz metin olarak değil, özet (hash) olarak saklanır.
Her istek Authorization: Bearer başlığıyla gelir. Sırasıyla anahtar, yetki kapsamı ve kota denetlenir; ardından veri okunur ve her uçta aynı zarfla döner.
Başarıda { data, meta }, hatada { error: { code, message }, meta }. meta.requestId her isteğin kimliğidir; destek taleplerinde bu kimliği paylaşmanız yeterli. Kalan hakkınız yanıt başlıklarında yazar.
Kalan dakikalık ve günlük hakkınız her yanıtın başlığında. Sınırı aşarsanız 429 ve Retry-After döner.
curl -i "https://api.istfin.com/v1/quotes?symbols=THYAO" \
-H "Authorization: Bearer istfin_live_..."
HTTP/2 200
x-ratelimit-limit: 15
x-ratelimit-remaining: 14
x-quota-limit: 500
x-quota-remaining: 473
{ "data": [{ "symbol": "THYAO", "price": 312.5, ... }],
"meta": { "requestId": "req_01jzqk4x8m9b2c5d" } }Limitler plana bağlıdır, değerler /v1/me ucunda. Hata kodları tüm uçlarda aynıdır.
| Durum | Anlamı |
|---|---|
| 400 | Parametre eksik ya da geçersiz (ör. interval, tarih aralığı) |
| 401 | Anahtar yok, hatalı, iptal edilmiş ya da süresi dolmuş |
| 403 | Plan API erişimi içermiyor, istek plan sınırını aşıyor ya da anahtarın yetki kapsamı yetersiz |
| 404 | Sembol ya da kayıt bulunamadı |
| 429 | Dakikalık ya da günlük sınır aşıldı; Retry-After kadar bekleyin |
Tüm zaman damgaları UTC’dir. Mumlarda t alanı barın başlangıcıdır (epoch saniye); devam eden açık bar yanıta dahil edilmez. İstanbul saati UTC+3’tür.
Günlük istek hakkı İstanbul saatiyle gece yarısı sıfırlanır, dakikalık sınır kayan penceredir. Planınızın değerleri /v1/me ucunda.
Evet. Paneldeki Kullanım sayfası günlük istek sayınızı gösterir. REST ve MCP istekleri aynı sayaçtan düşer.
Evet. MCP sunucusu REST API ile aynı veri katmanını, aynı anahtarları ve aynı kotayı kullanır. Claude ve ChatGPT OAuth ile bağlanır; bağlantı arka planda size özel bir erişim anahtarına dönüşür ve panelden kaldırılabilir.
istfin API, Borsa İstanbul veri platformu istfin tarafından geliştirilir.
Abone olun, anahtarınızı üretin, yukarıdaki isteği atın. Birkaç dakika sürer.
BIST 100, sektörlere göre günlük değişim
Hisse haritasını istfin.com’da aç