Veri ve tazelik politikası

Tek bir sözümüz var: veri dürüsttür. Her fiyat, ne kadar gecikmeli olduğunu ve ne zaman gözlemlendiğini size söyler; gözlemlemediğimiz bir değer null'dır, asla uydurulmaz. Bu sayfa o gerçekleri tek bir yerde toplar.

Asla uydurmayız

PortGate tahmin etmez. Bir üst kaynak bir değeri gözlemlemezse — bir BIST seans açılışı, ABD canlı akışında gün yüksek/düşük, yeterince eski bir çıpası olmayan bir dönem getirisi — alan null olur ve ilgili sayfa nedenini söyler. Dönüştürülmüş bir fiyat her zaman fx_rate ve fx_as_of değerini açıklar; eksik bir kur, eski bir dönüşüm yerine 503 döner. Bu bir kısıtlama değil, bir ürün kararıdır — null'larımızın üzerine inşa edebilirsiniz.

Piyasaya göre gecikme

Her fiyat, o akışın saniye cinsinden duruşu olan data_delay_seconds değerini taşır. Onu okuyun; varsaymayın:

Piyasa	data_delay_seconds	Kaynak	Notlar
BIST hisseleri	900 sn (15 dk)	Lisanslı veri dağıtıcısı	Gecikmeli akış; kesintisiz seans 10:00–18:00 TSİ
ABD hisseleri ve ETF'ler	900 sn (15 dk)	Lisanslı veri dağıtıcısı	Gecikmeli akış; 1 dakikalık barlar toplulaştırılır
FX (65 parite)	900 sn (15 dk)	Lisanslı veri dağıtıcısı	Paritenin ikinci ayağıyla fiyatlanır; 7/24 kaydedilir; ayrıca ?currency= dönüşümünü besler
Emtia (39)	900 sn (15 dk)	Lisanslı veri dağıtıcısı	Enstrüman başına para birimi/birim katalogdan okunur; *_future kategorileri gecikmeli vadeli fiyatlardır, spot değil
Dünya endeksleri (20)	900 sn (15 dk)	Lisanslı veri dağıtıcısı	Endeks puanı, para değil; sembol başına kaynak etiketi (endeks seviyesi / CFD / vadeli CFD)
TR fonları (NAV)	0 sn	TEFAS + lisanslı veri dağıtıcısı	NAV doğası gereği gün sonudur — canlı bir tik değil; as_of açıklanan değerleme tarihidir
Sektörler	türetilmiş	hesaplanır	Bileşen kapanışlarından hesaplanan endeksler; günlük + saatlik gün içi
Dönem istatistikleri	önceden hesaplanmış	üst kaynakta hesaplanır	Gözlemlenmez — programlı olarak yeniden hesaplanır (hisse/endeks ~15 dk, fonlar ~6 sa, sektörler saatlik). Bu satırlar borsa zaman damgası taşımaz; tek tazelik sinyali calculated_at alanıdır, onu okuyun
BIST finansalları	yok (5 dk önbellek)	Lisanslı veri dağıtıcısı (KAP bildirimleri)	Günde 5 kez taranır: 09:30/13:30/18:30/21:30/23:30 TSİ; tablolar üst kaynak konsolidatörü yayımladıkça görünür — iş günlerinde tipik olarak KAP bildiriminden birkaç saat sonra

Test aşaması her yerde gecikmeli akışı sunar (WebSocket akışı dahil). Bir akışı gerçek canlıya çevirmek yalnızca data_delay_seconds içindeki sayıyı değiştirir — asla bir alan adını veya bir yanıt biçimini değil.

as_of — yazım zamanı değil, gözlem zamanı

as_of değeri, fiyatın kaynakta gözlemlendiği andır (borsa işlem zamanı, NAV değerleme tarihi), ISO-8601 UTC olarak sunulur. Asla satırı önbelleğe aldığımız veya sunduğumuz zaman değildir. “Bu ne kadar eski?” göstermek için as_of değerini şu anla karşılaştırın — ve dürüst tabanın data_delay_seconds olduğunu unutmayın.

a BIST quote

{
  "instrument_id": "bist:THYAO",
  "last": "338.25",
  "as_of": "2026-07-10T15:19:01Z",   // exchange trade time (UTC)
  "data_delay_seconds": 900          // feed is 15-min delayed
}

Hafta sonları ve tatiller

Bir piyasa kapalıyken fiyatlar son seansın değerlerinde, doğru bir as_of ile tutulur — bir BIST adının Cumartesi fiyatı Cuma kapanışını ve Cuma zaman damgasını taşır. Hiçbir şey sıfırlanmaz, hiçbir şey hareket etmez. Bir seansın açık olup olmadığını bilmek için /v1/markets/{market}/status kullanın (ve her durum yanıtının kendisi hakkında beyan ettiği takvim kapsamı için Enstrümanlar ve piyasalar sayfasına bakın).

Neyin null olduğu ve nerede açıklandığı

Kaynağa-dürüst null'lar, onları üreten piyasa sayfasında belgelenir:

BIST — 5dk'lık barların yüksek/düşük değeri yoktur (5 dakikalık ayrıntıda gözlemlenmez); günlük barların seans open değeri yoktur.
ABD — canlı fiyatlar ve son günlük barlar open/high/low değerlerini null yapar (kapanış-dakikası-toplulaştırması dönemi); kapanışlar, hacim ve değişim % kesindir; eski geri-doldurulmuş geçmişte tam OHLC bulunur.
Fonlar — NAV-çıpalı ölçek kapısını geçemeyen bir açıklama dönemi, yanlış sunulmaktansa sunulmaz.
Sektörler — yeterince eski bir kapanışı olmayan bir dönem getirisi, bir tahmin değil null olarak sabitlenir.
Döviz — satırlar akışın gönderdiği alanlardan oluşur; iletilmeyen bir alan (önceki kapanış, hacim) null olur.
Emtia / dünya endeksleri — kaynakta hacim/fiyat bandı verisi yoktur; şu anda dürüstçe sunulabilir değeri olmayan bir sembol 404'tür, asla çevrilmiş veya bayat bir sayı değil.

Önbellek tazeliği

API'nin arkasında, sıcak-işçi filosu her piyasanın önbelleğini kabaca 60 saniyelik bir döngüde yeniler; WebSocket aynı döngüde iter (bir fiyat değişmese bile — akış aynı zamanda bir tazelik kalp atışı görevi görür). Yani gecikmeli duruş içinde, bir REST fiyatı akışın kendisinden en fazla ~60 sn daha eskidir. Bu yüzden birkaç saniyeden hızlı sorgulama size hız-limiti baskısından başka bir şey kazandırmaz — temeldeki değer hareket etmemiştir.

Görüntüleyebileceğiniz kalite bayrakları

Enstrüman kayıtları segment ve price_mechanism değerlerini açar. POİP ve İZL BIST adları price_mechanism: "auction" değerindedir — tek-fiyatlı çağrılı müzayedeler; dolayısıyla fixing'ler arasındaki düz çizgi gerçektir, takılı bir akış değil. Bunu gün yüzüne çıkarmak çoğu sağlayıcının yapmadığı bir şeydir; doğrudan kullanıcılarınıza geçirebilirsiniz.

Logolar ve ticari markalar

/v1/logos/{id} tarafından sunulan enstrüman logoları ilgili sahiplerinin mülkiyetindedir ve yalnızca tanımlama amacıyla sunulur — bkz. Enstrüman logoları.