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ç nokta | Kapsam | Açıklama |
|---|---|---|
| GET/v1/markets/bist/breadth?universe=&date=&from=&to=&resolution=&as_of=&fields= | history | Bir evren için genişlik — günlük seanslar ya da ISO haftaları |
| GET/v1/markets/bist/breadth/sectors?date=&from=&to=&as_of= | history | Seans 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= | history | Haftalık piyasa özeti |
| GET/v1/markets/bist/limits?universe=&date= | history | Bir seansta günlük fiyat limitindeki hisseler |
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.
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
| Alan | Tür | Notlar |
|---|---|---|
| universe | string | XUTUM (varsayılan) · XU100 · XU030 · XU050 · index:<kod> · sector:<slug>. |
| date | string (YYYY-MM-DD) | Tek seans, YYYY-MM-DD. from/to ile birlikte kullanılmaz. |
| from / to | string (YYYY-MM-DD) | Aralık; varsayılan son 30 gün; en fazla 366 gün (/breadth/sectors için 31). |
| resolution | 1d | 1w | 1d (seanslar, varsayılan) ya da 1w (ISO haftaları; hafta son seansında biter). |
| as_of | string | Zaman noktası: yalnızca bu ana kadar hesaplanmış revizyonlar (YYYY-MM-DD = o UTC gününün sonu ya da bölgeli ISO-8601). |
| fields | string | Dö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 -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"{
"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ı
| Alan | Tür | Notlar |
|---|---|---|
| n_traded · up · down · flat | int | Sayılan üyeler (bugün ve önceki seansta barı olan, dışlanmayan); yükselen / düşen / değişmeyen. |
| pct_up · pct_down | string | Yükselen / düşen payı, %. |
| up_turnover_share | string | Yükselenlerin cirosu ÷ yükselen + düşenlerin cirosu, %. |
| pct_above_ma20/50/200 | string | 20/50/200 seanslık ortalamasının üstünde kapanan üyelerin yüzdesi. |
| nh · nl | int | Önceki 250 seansın en yüksek kapanışının üstünde / en düşüğünün altında kapanışlar. |
| lim_up · lim_dn | int | Tavanda / tabanda kapanan (limit notuna bakın). |
| ew_ret · index_ret · ew_minus_index | string | Eşit ağırlıklı üye getirisi, resmî endeks getirisi ve farkları, %. |
| narrow_rally | bool | Endeks %0,5'ten fazla yükselirken üyelerin yarısından azı yükseldi (narrow_decline: tersi). |
| turnover · turnover_vs_20d · turnover_top10_share · turnover_hhi | string | Toplam 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 · int | Sektö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
