İçeriğe geç

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/me entitlements alanı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/me yanı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çıklamaYetki (scope)
GET /v1/symbolsSembol listesi, endeks/sektör/arama filtrelerimarket:read
GET /v1/symbols/{symbol}Tek sembol detayımarket:read
GET /v1/quotesFiyatlar (en fazla 100 sembol)market:read
GET /v1/market/moversYükselen, düşen ve hacim liderlerimarket:read
GET /v1/bars/{symbol}Tarihsel OHLCV barlarmarket:read
GET /v1/fundamentals/{symbol}Değerleme, oranlar, büyüme, bilanço özetifundamentals: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ı serisifundamentals:read
GET /v1/meAnahtar, plan ve günlük kullanımaccount:read

Tam parametre ve şema listesi için OpenAPI referansı sayfalarına bakın. Ham şema: https://api.istfin.com/openapi.json.

Bu sayfada