Piyasa trendleri (BIST)

Borsa İstanbul için piyasa geneli günlük ve haftalık göstergeler, tüm piyasa için bir kez hesaplanır: kaç hisse yükseldi, tavan/taban sayıları, ciro ve yoğunlaşması, eşit ağırlıklı getiri ile endeks farkı (“dar ralli”), sektör rotasyonu ve haftalık özet. Geçmiş 2024-09-26'dan.

Uç noktalar

Uç noktaKapsamAçıklama
GET/v1/markets/bist/breadth?universe=&date=&from=&to=&resolution=&as_of=&fields=historyBir evren için genişlik — günlük seanslar ya da ISO haftaları
GET/v1/markets/bist/breadth/sectors?date=&from=&to=&as_of=historySeans başına sektör rotasyonu ve sektör genişliği, ilk 5 lider ile
GET/v1/markets/bist/trends/weekly?universe=&week=&from=&to=historyHaftalık piyasa özeti
GET/v1/markets/bist/limits?universe=&date=historyBir seansta günlük fiyat limitindeki hisseler

Deneme Alanı'nda deneyin →

Sayılar nasıl hesaplanır

Getiriler yalnızca kapanış fiyatlarından: kapanış ÷ önceki seans kapanışı − 1. Saklanan günlük değişim yüzdeleri kullanılmaz. Tatil günlerinin noktası yoktur; bir hisse o gün yalnızca hem o gün hem önceki seansta barı varsa sayılır. %15'ten fazla sıçrayıp ertesi gün geri dönen bar veri hatası sayılır ve dışlanır (n_excluded).

Evrenler: XUTUM, XU100, XU030, XU050, doğrulanmış her BIST endeksi index:<kod> olarak ve PortGate sektörleri sector:<slug> olarak. Yüzdeler yüzde cinsindendir; ondalıklar tam metin.

Limitler yaklaşıktır: bant, önceki kapanış ±%10'un fiyat adımına yuvarlanmış hâlidir (limit_basis: approx_10pct); pazar ve tedbir istisnaları modellenmez. lim_up / lim_dn limitte kapanışları, *_touch gün içi değmeleri de, *_9_5 ±%9,5'i aşan getirileri sayar.

Zaman noktası ve revizyonlar

Her nokta nasıl üretildiğini söyler. vintage live (seansın akşamı hesaplandı) ya da backfill'dir (sonradan, o günün barlarıyla hesaplandı). Bir bar sonradan düzeltilirse yeni bir revizyon yazılır (revision, revised_at, revision_reason); önceki revizyonlar as_of ile okunabilir. membership_basis pit (o sabahın endeks listesi) ya da today'dir (bugünkü listenin geçmiş bir güne uygulanması — survivorship bayrağı). coverage_ratio ve quality_flags (partial_universe, half_day, holiday_adjacent, small_n, warmup) resmi tamamlar.

Sorgu parametreleri — /breadth

AlanTürNotlar
universestringXUTUM (varsayılan) · XU100 · XU030 · XU050 · index:<kod> · sector:<slug>.
datestring (YYYY-MM-DD)Tek seans, YYYY-MM-DD. from/to ile birlikte kullanılmaz.
from / tostring (YYYY-MM-DD)Aralık; varsayılan son 30 gün; en fazla 366 gün (/breadth/sectors için 31).
resolution1d | 1w1d (seanslar, varsayılan) ya da 1w (ISO haftaları; hafta son seansında biter).
as_ofstringZaman noktası: yalnızca bu ana kadar hesaplanmış revizyonlar (YYYY-MM-DD = o UTC gününün sonu ya da bölgeli ISO-8601).
fieldsstringDöndürülecek metrik adları, virgülle; meta alanlar her zaman gelir.

Örnek — 2026-10-05 dar rallisi

XU100 %1,42 yükselirken BIST hisselerinin yarısından azı yükseldi. XU100 kendi içinde geniş görünüyor (%66 yükselen); piyasanın tamamı öyle değil:

curl (scope: history)
curl -H "X-API-Key: $PORTGATE_KEY" \
  "https://api.theportfoy.com/portgate/v1/markets/bist/breadth?universe=XUTUM&date=2026-10-05&fields=n_traded,pct_up,lim_up,lim_dn"
response (excerpt)
{
  "market": "bist",
  "universe": "XUTUM",
  "resolution": "1d",
  "points": [
    {
      "date": "2026-10-05",
      "n_traded": 580,
      "pct_up": "46.90",
      "lim_up": 30,
      "lim_dn": 31,
      "membership_basis": "today",
      "coverage_ratio": "1.0000",
      "quality_flags": ["survivorship"],
      "vintage": "backfill",
      "computed_at": "…",
      "revision": 0
    }
  ],
  "count": 1
}

Başlıca nokta alanları

AlanTürNotlar
n_traded · up · down · flatintSayılan üyeler (bugün ve önceki seansta barı olan, dışlanmayan); yükselen / düşen / değişmeyen.
pct_up · pct_downstringYükselen / düşen payı, %.
up_turnover_sharestringYükselenlerin cirosu ÷ yükselen + düşenlerin cirosu, %.
pct_above_ma20/50/200string20/50/200 seanslık ortalamasının üstünde kapanan üyelerin yüzdesi.
nh · nlintÖnceki 250 seansın en yüksek kapanışının üstünde / en düşüğünün altında kapanışlar.
lim_up · lim_dnintTavanda / tabanda kapanan (limit notuna bakın).
ew_ret · index_ret · ew_minus_indexstringEşit ağırlıklı üye getirisi, resmî endeks getirisi ve farkları, %.
narrow_rallyboolEndeks %0,5'ten fazla yükselirken üyelerin yarısından azı yükseldi (narrow_decline: tersi).
turnover · turnover_vs_20d · turnover_top10_share · turnover_hhistringToplam ciro (TL), 20 seanslık ortalamasına oranı, ilk 10 payı ve HHI.
…ad_line (kümülatif), dispersion_std/iqr, avg_pair_corr_20d (XU100/XU030), seriler, McClellan, breadth_thrust.
rs_1w · rank_1w (sectors)string · intSektör satırları ret_1d/1w/1m, rs_* (piyasanın eşit ağırlıklı getirisine göre), rank_1w (1 = en güçlü) ve rank_change_1w ekler.

Kapsam ve planlar

Uç noktalar history kapsamıyla korunur; her planda dahildir. Test anahtarları test geçmiş penceresini alır. 100 nokta başına 1 birim ölçülür (sektör satırları tek tek sayılır).

Ayrıca bakınız: /docs/sectors · /docs/indices · /docs/stocks/bist