İçeriğe geç

Endeksler ve sektörler

GET /v1/indexes, /v1/indexes/{code}, /v1/sectors: endeks değeri ve günlük değişimi, sektör taksonomisi.

Yetki: market:read

GET /v1/indexes

Tüm endeksler (BIST 100, BIST 30, sektör endeksleri). value ve changePercent endeks değeri ve günlük değişimidir; planınıza göre canlı ya da 15 dk gecikmeli. Gecikmeli değer yoksa null döner. Endeks bileşenleri ve ağırlıkları Borsa İstanbul referans verisidir, API ile verilmez.

Parametreler

ParametreTipZorunluAçıklama
searchstringhayırKod ya da ad içinde arama (banka, XU)

Örnek

curl "https://api.istfin.com/v1/indexes?search=XU" \  -H "Authorization: Bearer $ISTFIN_API_KEY"

Yanıt

{
  "data": [
    {
      "code": "XU100",
      "name": "BIST 100",
      "value": 10842.17,
      "changePercent": 0.64,
      "updatedAt": "2026-10-06T14:59:58.000Z"
    }
  ],
  "meta": { "requestId": "req_01jzqk4x8m9b2c5d7e8f9g0h1j" }
}

GET /v1/indexes/{code}

Tek endeksin kodu, adı, değeri ve günlük değişimi; alanlar listedekiyle aynı. Bulunamazsa 404 NOT_FOUND. Endeksin geçmiş değerleri için GET /v1/bars/{code} kullanın.

Örnek

curl "https://api.istfin.com/v1/indexes/XU030" \  -H "Authorization: Bearer $ISTFIN_API_KEY"

GET /v1/sectors

Sektör taksonomisi düz liste olarak gelir; ağaç parentSlug ile kurulur (üst sektörde null).

Örnek

curl "https://api.istfin.com/v1/sectors" \  -H "Authorization: Bearer $ISTFIN_API_KEY"

Yanıt

{
  "data": [
    {
      "slug": "bankacilik",
      "name": "Bankacılık",
      "parentSlug": "mali-kuruluslar",
      "symbols": ["AKBNK", "GARAN", "ISCTR"],
      "stockCount": 3
    }
  ],
  "meta": { "requestId": "req_01jzqk4x8m9b2c5d7e8f9g0h1j" }
}

Bu sayfada