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:

Piyasadata_delay_secondsKaynakNotlar
BIST hisseleri900 sn (15 dk)Lisanslı veri dağıtıcısıGecikmeli akış; kesintisiz seans 10:00–18:00 TSİ
ABD hisseleri ve ETF'ler60 sn (~1 dk)Gerçek zamanlı piyasa veri sağlayıcısıGerçek zamanlı soket 1 dakikalık barlara toplulaştırılır; fiyat son kapanan dakikayı yansıtır (2026-11-19'dan beri; öncesinde 900 sn)
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)
Kripto (808 coin)300 sn (~5 dk)Piyasa geneli toplulaştırılmış veri7/24 işlem görür; her fiyattaki as_of ve data_delay_seconds alanlarını okuyun
TR fonları (NAV)0 snTEFAS + 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örlertüretilmişhesaplanırBileşen kapanışlarından hesaplanan endeksler; günlük + saatlik gün içi
Dönem istatistikleriönceden hesaplanmışüst kaynakta hesaplanırGö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          // BIST: 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

BIST hisseleri ve endeksleri, döviz ve emtia için gecikmeli kaynaktaki her tik yaklaşık bir saniye içinde API önbelleğine — ve WebSocket'e — ulaşır. Bunun arkasında sıcak-işçi filosu her piyasanın önbelleğini yine kabaca 60 saniyelik bir döngüde yedek olarak yeniler (ABD hisseleri ve kripto bu döngüyle yenilenir); WebSocket'teki BIST kimlikleri değişmese de en az dakikada bir kalp atışı alır. Yani gecikmeli duruş içinde bir REST fiyatı akış kadar tazedir. 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ı.