İçeriğe geç

istfin API nasıl çalışı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.

Veriden yanıta dört adım

  1. 1. Veri kaynağı

    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.

  2. 2. Hesap ve anahtar

    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.

  3. 3. İstek

    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.

  4. 4. Yanıt

    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.

Bir istek, uçtan uca

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 ve hata kodları

Limitler plana bağlıdır, değerler /v1/me ucunda. Hata kodları tüm uçlarda aynıdır.

DurumAnlamı
400Parametre eksik ya da geçersiz (ör. interval, tarih aralığı)
401Anahtar yok, hatalı, iptal edilmiş ya da süresi dolmuş
403Plan API erişimi içermiyor, istek plan sınırını aşıyor ya da anahtarın yetki kapsamı yetersiz
404Sembol ya da kayıt bulunamadı
429Dakikalık ya da günlük sınır aşıldı; Retry-After kadar bekleyin

Ayrıntılar: Limitler ve Hatalar.

Sık sorulanlar

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.

Günlük kota ne zaman sıfırlanı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.

İsteklerimi görebilir miyim?

Evet. Paneldeki Kullanım sayfası günlük istek sayınızı gösterir. REST ve MCP istekleri aynı sayaçtan düşer.

MCP aynı altyapıyı mı kullanıyor?

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.

Kendiniz deneyin

Abone olun, anahtarınızı üretin, yukarıdaki isteği atın. Birkaç dakika sürer.