Semboller
GET /v1/symbols: hisse listesi; GET /v1/symbols/{symbol}: tek sembol detayı.
Yetki: market:read
GET /v1/symbols
Borsa İstanbul'da işlem gören hisselerin listesi. Filtre verilmezse tüm liste döner (sembole göre sıralı). Semboller ek sız kısa koddur: THYAO, GARAN.
Parametreler
| Parametre | Tip | Zorunlu | Açıklama |
|---|---|---|---|
sector | string | hayır | Sektör adı (tam eşleşme). Değerler yanıt içindeki sectors alanından alınır. |
search | string | hayır | Sembol ya da şirket adında arama (büyük/küçük harf duyarsız, en fazla 40 karakter). |
Örnek
curl "https://api.istfin.com/v1/symbols?search=THY" \ -H "Authorization: Bearer $ISTFIN_API_KEY"Yanıt
{
"data": [
{
"symbol": "THYAO",
"name": "Türk Hava Yolları",
"sectors": ["Ulaştırma ve Depolama"],
"indexes": ["XU030", "XU050", "XU100", "XUTUM"],
"listingDate": "1990-12-04"
}
],
"meta": { "requestId": "req_01jzqk4x8m9b2c5d7e8f9g0h1j" }
}| Alan | Tip | Açıklama |
|---|---|---|
symbol | string | Hisse kodu |
name | string | Şirket adı |
sectors | string[] | Sektör(ler) |
indexes | string[] | Dahil olduğu endeksler |
listingDate | string | null | İlk işlem günü (YYYY-MM-DD) |
GET /v1/symbols/{symbol}
Tek bir hissenin kimlik ve ortaklık bilgileri. Sembol bulunamazsa 404 NOT_FOUND.
Parametreler
| Parametre | Tip | Zorunlu | Açıklama |
|---|---|---|---|
symbol | string | evet | Yol parametresi, örn. THYAO |
Örnek
curl "https://api.istfin.com/v1/symbols/THYAO" \ -H "Authorization: Bearer $ISTFIN_API_KEY"Yanıt
Liste alanlarına ek olarak:
| Alan | Tip | Açıklama |
|---|---|---|
city | string | null | Merkez şehri |
websiteUrl | string | null | Kurumsal web sitesi |
description | string | null | Faaliyet açıklaması |
sharesOutstanding | number | null | Ödenmiş sermaye / pay sayısı |
freeFloatRatio | number | null | Fiili dolaşım oranı (yüzde) |