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
| Parametre | Tip | Zorunlu | Açıklama |
|---|---|---|---|
search | string | hayır | Kod 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" }
}