İçeriğe geç

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

ParametreTipZorunluAçıklama
sectorstringhayırSektör adı (tam eşleşme). Değerler yanıt içindeki sectors alanından alınır.
searchstringhayırSembol 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" }
}
AlanTipAçıklama
symbolstringHisse kodu
namestringŞirket adı
sectorsstring[]Sektör(ler)
indexesstring[]Dahil olduğu endeksler
listingDatestring | 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

ParametreTipZorunluAçıklama
symbolstringevetYol 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:

AlanTipAçıklama
citystring | nullMerkez şehri
websiteUrlstring | nullKurumsal web sitesi
descriptionstring | nullFaaliyet açıklaması
sharesOutstandingnumber | nullÖdenmiş sermaye / pay sayısı
freeFloatRationumber | nullFiili dolaşım oranı (yüzde)

Bu sayfada