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
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 | 60 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ış veri | 7/24 işlem görür; her fiyattaki as_of ve data_delay_seconds alanlarını okuyun |
| 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.
{
"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
opendeğeri yoktur. - ABD — canlı fiyatlar ve son günlük barlar
open/high/lowdeğ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
nullolarak sabitlenir. - Döviz — satırlar akışın gönderdiği alanlardan oluşur; iletilmeyen bir alan (önceki kapanış, hacim)
nullolur. - 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ı.