CODESCRIPT

Çoklu zaman dilimi

24 işlev. Her kaydın ne aldığı, ne verdiği ve çalışan örneği.

currencyRate(source, target)

Döviz kuru serisi (kaynak==hedef → 1, veri gerekmez). Desteklenen birimler: USD, EUR, GBP, JPY, TRY, AUD, CAD, CHF, NZD ve XAU/XAG (altın/gümüş ons). Doğrudan çift yoksa tersi (1/kur), o da yoksa USD üzerinden çaprazı hesaplanır — böylece bu 11 birimin tüm kombinasyonları çalışır. Değer o barın kapanışındaki kurdur; kur verisinin başladığı bardan öncesinde na (geçmişe kur taşınmaz). Kaynak/hedef DÜZ YAZI olmalı: `currencyRate(a, b)` gibi değişkenli çağrıda na döner. Adlandırılmış argüman adları: `source`/`target` (kanonik). `from`/`to` ve `kaynak`/`hedef` de aynı işi yapar.

İki para birimi arasındaki kur serisini döndürür. Kaynak = hedef ise 1.0; veri yoksa na.

source
string
Kaynak para birimi (örn "EUR").
target
string
Hedef para birimi (örn "USD").

Not

Farklı para birimindeki değerleri karşılaştırılabilir bir birime çevirmek için. Kur verisi terminalden gelir. Doğrudan çift yoksa tersi (1/kur), o da yoksa USD üzerinden çaprazı hesaplanır — desteklenen 11 birimin tüm kombinasyonları çalışır.

Ne zaman kullanılır

Farklı para birimlerinde fiyatlanan iki değeri karşılaştırmadan önce ortak bir birime hizalamak için.

Sınırlar

Desteklenen birimler: USD, EUR, GBP, JPY, TRY, AUD, CAD, CHF, NZD ve XAU/XAG (altın/gümüş ons) — bunların dışındaki bir kod na döner. Kaynak/hedef DÜZ YAZI olmalı: `currencyRate(a, b)` gibi değişkenli çağrıda kur getirilmez, na döner. Kur verisinin başladığı bardan öncesinde na (geçmişe kur taşınmaz). Aynı para birimi kodu verilirse sonuç sabit 1.0'dır (veri gerektirmez). Kodlar büyük/küçük harf duyarsızdır.

Uygun değildir

Bir stratejinin kâr/zararını hesap para birimine çevirmek için değil (o iş convertToAccount'ın); bir fiyat beslemesi de değildir.

Farklı para birimindeki değerleri karşılaştırılabilir bir birime çevirmek için. Kur verisi bir kaynağa bağlıysa terminalden gelir; şu an bağlı değil (bkz. sınırlar).

CODESCRIPT
plot(currencyRate("EUR", "USD"), "EURUSD Kuru")

Şu an her zaman na (boş çizgi) — veri kaynağı henüz bağlı değil.

CODESCRIPT
plot(currencyRate("USD", "USD"), "Aynı para")

Aynı para birimi verildiği için sabit 1.0 çizer.

dividends(symbol, field?)

Temettü serisi. Alanlar: "gross" (brüt), "net" (stopaj sonrası), "yield" (verim %), "paid" (ödenen toplam). BIST hisselerinde brüt ve net, Borsa İstanbul'un hak kullanım duyurusundaki 1 TL nominale düşen tutarlardan okunur (ör. brüt 2,00 / net 1,70 — %15 stopaj; gayrimenkul yatırım ortaklıkları gibi stopajsız durumlarda ikisi eşittir). Değer YALNIZ temettünün hak kullanım gününden itibaren görünür, öncesinde na. "yield" ve "paid" şirket takviminden gelir.

Şirketin temettü ödemelerini, ödeme barlarına hizalı seri olarak döndürür.

symbol
string
Şirket sembolü.
field
string
İsteğe bağlı. "gross"/"net" vb. (varsayılan "gross").

Not

Ödeme olmayan barlarda na; veri yoksa tüm seri na.

Sınırlar

"gross"/"net" Borsa İstanbul hak kullanım duyurusundan gelir (1 TL nominale düşen tutar). Aradaki fark stopajdır (ör. brüt 2,00 → net 1,70); gayrimenkul yatırım ortaklıkları gibi stopajsız durumlarda ikisi eşit olur, bu hata değildir. "yield"/"paid" şirket takviminden gelir ve yalnız güncel dönemi kapsar. Arşivin kapsamadığı eski tarihlerde na.

CODESCRIPT
plot(dividends("THYAO", "gross"), "Temettü")

Şu an her zaman na (boş çizgi) — veri kaynağı henüz bağlı değil.

earnings(symbol, field?)

Kâr açıklaması. "actual" = açıklanan hisse başına kâr (son 12 ay), şirket takviminden gelir ve YALNIZ açıklama tarihinden itibaren görünür, öncesinde na. "estimate" (beklenti) ve "surprise" (sapma) için elimizde veri yok — bu ikisi na döner.

Şirketin kâr açıklamalarını (EPS vb.), açıklama barlarına hizalı seri olarak döndürür.

symbol
string
Şirket sembolü.
field
string
İsteğe bağlı. "actual"/"estimate" vb. (varsayılan "actual").

Not

Açıklama olmayan barlarda na; veri yoksa na.

Sınırlar

Şu anda bir veri kaynağına bağlı DEĞİL — her barda na döner (sessiz, hata vermez; ilk kullanımda tek-seferlik uyarı verir).

CODESCRIPT
plot(earnings("THYAO", "actual"), "Açıklanan Kâr")

Şu an her zaman na (boş çizgi) — veri kaynağı henüz bağlı değil.

economic(country, field)

Makro gösterge (faiz kararı, enflasyon, güven endeksi...). Değer, açıklandığı andan SONRAKİ barlarda görünür; öncesinde na (yarınki karar bugünkü barda görünmez). Ülke: TR/US/EU/DE/GB/JP/CN. Kod, referans platform'in makro kod sözlüğüdür — TR için INTR (politika faizi), DIR, LR, CCI (tüketici güveni), FER (rezervler); US/EU/DE/GB/JP/CN için de kendi kodları. Yalnız AÇIKLANMIŞ veriler gelir: beklenti (forecast) ve önceki dönem değeri kullanılmaz. Takvim kaynağı yakın dönemi kapsar; daha eski barlarda na.

Bir ülkenin makro göstergesini (faiz kararı, enflasyon, güven endeksi vb.), açıklandığı barlara hizalı seri olarak döndürür.

country
string
İKİ harfli ülke kodu: "TR", "US", "EU", "DE", "GB", "JP", "CN". ("TUR"/"USA" gibi üç harfli yazım çalışmaz.)
field
string
Gösterge kodu. Türkiye için: INTR (politika faizi), DIR, LR, CCI (tüketici güveni), FER (rezervler), UR (işsizlik), BOT (dış ticaret dengesi), EXP/IMP. Diğer ülkelerin kendi kodları vardır (ör. EU: INTR, CPI, GDPYY · US: CPI, NFP karşılıkları). Kod büyük harf yazılır.

Not

Değer YALNIZ açıklandığı andan sonraki barlarda görünür, öncesinde na — yarınki faiz kararı bugünkü barda görünmez. Makro göstergeler seyrek açıklanır; değer bir sonraki açıklamaya dek sabit taşınır.

Sınırlar

Yalnız AÇIKLANMIŞ veriler gelir. Beklenti (forecast) ve önceki dönem değeri KULLANILMAZ: takvimde bunların ne zaman yayımlandığı yazmıyor, geçmiş bir bara bugünkü beklentiyi koymak geriye dönük sızıntı olurdu. Takvim kaynağı yakın dönemi kapsar (yaklaşık son bir hafta + önümüzdeki hafta) → daha eski barlarda na döner; uzun geçmişli backtest için henüz uygun değildir. Takvimde kodu (ticker) olmayan olaylar da adreslenemez.

Veri yoksa na; makro göstergeler seyrek açıklanır (değer bir sonraki açıklamaya dek sabit taşınır).

CODESCRIPT
plot(economic("TUR", "GDP"), "GSYİH")

Şu an her zaman na (boş çizgi) — veri kaynağı henüz bağlı değil.

financial(symbol, item, period?)

Bilanço/gelir tablosu kalemi. BIST hisselerinde KAP'ın resmi mali tablolarından okunur; değer, o tablonun yakalandığı tarihten SONRAKİ barlarda görünür (öncesinde na — geçmişe dönük sızıntı yok). Kalemler: TOTAL_ASSETS, TOTAL_LIABILITIES, TOTAL_CURRENT_ASSETS, TOTAL_CURRENT_LIABILITIES, TOTAL_EQUITY, COMMON_STOCK_PAR, TOTAL_REVENUE, GROSS_PROFIT, OPER_INCOME, PRETAX_INCOME, NET_INCOME; ayrıca net_income_parent, equity_parent, noncurrent_assets, noncurrent_liabilities. TOTAL_REVENUE şirket tipine göre doğru satırdan okunur: banka → faiz geliri, finansal kiralama/faktoring → faaliyet geliri, sigorta → teknik gelirlerin toplamı, holding → konsolide hasılat, diğer → hasılat. Dönem: FY (yıllık) ve FQ (çeyrek) — FQ'da gelir kalemleri yıl-içi birikimden ayrıştırılır, bilanço kalemleri çeyrek-sonu değeridir. TTM/FH ve verisi olmayan sembol/kalem na döner. Değerler tam TL. Normal çalıştırma, optimizasyon, ileri-test, bot ve tarama — hepsinde AYNI veri gelir.

Bir şirketin temel (finansal tablo) kalemini, açıklandığı barlara hizalı seri olarak döndürür. Değerler tam TL.

symbol
string
Şirket sembolü (örn "THYAO").
item
string
Kalem kodu. Bilanço: TOTAL_ASSETS, TOTAL_LIABILITIES, TOTAL_CURRENT_ASSETS, TOTAL_CURRENT_LIABILITIES, TOTAL_EQUITY, COMMON_STOCK_PAR. Gelir tablosu: TOTAL_REVENUE, GROSS_PROFIT, OPER_INCOME, PRETAX_INCOME, NET_INCOME. Ayrıca ana-ortaklık ve duran kalemler: net_income_parent, equity_parent, noncurrent_assets, noncurrent_liabilities. TOTAL_REVENUE şirket tipine göre doğru satırdan okunur: bankada faiz geliri, finansal kiralama/faktoringde faaliyet geliri, sigortada teknik gelirlerin toplamı, holdingde konsolide hasılat, diğerlerinde hasılat — yani bankada "ciro" beklemek yerine faiz gelirini görürsünüz, bu KAP'ın tablo yapısı gereğidir.
period
string
İsteğe bağlı, varsayılan "FY". "FY" = yıllık (yıl sonu tablosu). "FQ" = çeyrek; gelir kalemleri yıl içinde birikerek açıklandığı için çeyreğin kendisi ayrıştırılır, bilanço kalemleri çeyrek-sonu değeridir. "TTM" (son 12 ay) ve yarıyıl şu an na döner.

Not

Değer yalnız rapor tarihinden itibaren geçerlidir (look-ahead yok); veri yoksa na.

Ne zaman kullanılır

Fiyatı temel büyüklüklerle (gelir, kâr, borç) birleştiren stratejilerde.

Sınırlar

BIST hisselerinde KAP'ın resmi mali tablolarından okunur. Bir tablo, ancak KAYITLARA GEÇTİĞİ tarihten sonraki barlarda görünür; arşiv 18 Mayıs 2026'da başladığı için daha eski barlarda na döner (bu bilinçli: eski bir tarihte, o gün henüz bilinmeyen bir bilançoyu göstermek geriye dönük sızıntı olurdu). Verisi olmayan sembol/kalem/dönem na döner. Normal çalıştırma, optimizasyon, ileri-test, bot ve tarama — hepsinde AYNI veri gelir (optimize edilen parametre, botun gerçekten göreceği veriye dayanır).

CODESCRIPT
plot(financial("THYAO", "TOTAL_REVENUE", "FY"), "Yıllık Gelir")

Şu an her zaman na (boş çizgi) — veri kaynağı henüz bağlı değil.

htf(timeframe, source)

source'u üst zaman dilimine örnekler (her üst zaman dilimi barı kapandıkça güncellenir; ileriye bakmaz). Örn: htf("1D", close) = günlük kapanış.

Kaynağı üst zaman dilimine örnekler: her HTF barı TAMAMLANINCA o barın son değeri ileriye taşınır (bar-boyunca sabit).

timeframe
string
Üst zaman dilimi (örn "60", "1D", "1W").
source
series
Üst-TF'ye örneklenecek seri (örn close).

Not

Look-ahead YOKTUR — değer yalnız üst-TF barı kapandıktan sonra görünür, bu yüzden geçmişe bakmaz (repaint güvenli). Aynı-sembol üst-TF için `security`'ye göre daha sade bir kısayoldur.

Ne zaman kullanılır

Alt-TF grafikte üst-TF trendini/seviyesini (örn günlük kapanış, haftalık ortalama) süzgeç olarak kullanmak için.

Sınırlar

HTF barı kapanana dek değer önceki tamamlanmış bardan gelir (güncel oluşan HTF barını göstermez). timeframe geçerli bir süre olmalı.

CODESCRIPT
gunluk_kapanis = htf("1D", close)
plot(gunluk_kapanis, "Günlük Kapanış")

Günlük kapanışı alt-TF grafiğe basamak-çizgi olarak taşır.

CODESCRIPT
plot(close > htf("1D", sma(close, 20)) ? 1 : 0, "Günlük SMA üstünde")

Fiyat günlük 20-SMA üstündeyse 1 (üst-TF trend süzgeci).

quandl(code,...)

Harici Quandl verisi (kapandı → boş).

Her zaman boş (na) seri döndürür — kaynak (NASDAQ Data Link) kapandığından veri sağlanmaz.

code
string
Veri kümesi kodu.

Not

Geriye-uyum için mevcut; kaynak kapandığı için işlevsel veri döndürmez (kaynağın kendisi de kapalıdır).

Sınırlar

Her zaman na. Alternatif için `seed`/`financial`/`economic` kullanın.

CODESCRIPT
plot(quandl("FRED/GDP"), "Quandl")

Boş (na) seri döner — kaynak kapalı.

security(symbol, timeframe, source, gaps?, lookahead?, ignore_invalid_symbol?)

Başka sembol/üst-zaman dilimi serisi (source metin=alan adı veya seri). Parametre adları İngilizcedir: symbol, timeframe, source. 4. konumsal gaps (barmerge.gaps_on/off), 5. lookahead (barmerge.lookahead_on/off). ignore_invalid_symbol yalnız adlandırılmış argümandır: true → geçersiz/yüklenmemiş sembolde hata yerine na döner. (currency ve calc_bars_count parametreleri bu sürümde desteklenmez.)

İfadenin üst zaman diliminde hesaplanıp mevcut bara, geleceği görmeden hizalanmış serisi.

symbol
string
Sembol; genellikle syminfo.tickerid (mevcut sembol) ya da sabit kod. Parametre adı İngilizcedir (symbol).
timeframe
string
Zaman dilimi (örn. "60", "240", "D"). Boş = grafik zaman dilimi. Parametre adı İngilizcedir (timeframe).
source
series
Üst zaman diliminde hesaplanacak ifade (örn. close, sma(close,20)). Parametre adı İngilizcedir (source).
gaps
string
İsteğe bağlı (4. konumsal). barmerge.gaps_on = ara barlarda boşluk (na) bırakın; barmerge.gaps_off (varsayılan) = son değeri taşıyın.
lookahead
string
İsteğe bağlı (5. konumsal). barmerge.lookahead_off (varsayılan) = ileriye bakmaz. barmerge.lookahead_on ileriye-bakma sızıntısı yaratır — backtest'te ÖNERİLMEZ.
ignore_invalid_symbol
bool
İsteğe bağlı, YALNIZ adlandırılmış argüman (konumsal değil). true ise geçersiz/yüklenmemiş sembolde hata fırlatılmaz, na (boş) döner. Varsayılan false (hata verir).

Not

Üst zaman dilimi değeri, o bar KAPANDIKTAN sonra hizalanır (ileriye bakmaz, sonradan değişmez). `currency` (para birimi dönüşümü) ve `calc_bars_count` parametreleri bu sürümde DESTEKLENMEZ — verilirse sessizce yok sayılır. Üst zaman dilimi değeri, o bar kapandıktan sonra hizalanır; sembol ve zaman dilimi çalışma boyunca sabit olmalıdır.

Ne zaman kullanılır

Çoklu zaman dilimi filtresi için (örn. 1 saatlik trend yönüne göre 5 dakikalıkta işlem).

Sınırlar

Sembol ve zaman dilimi çalışma boyunca sabit olmalı (bar bar değişen sembol desteklenmez). Üst zaman dilimi barı kapanana kadar son kapanan üst zaman dilimi değeri taşınır — bu yüzden oluşmakta olan son barda sabit görünür.

Uygun değildir

Bar bar değişen bir sembol ya da zaman dilimiyle uygun değil — sembol ve dilim çalışma boyunca sabit olmalı. Grafik zaman dilimiyle aynı veriyi istiyorsanız security'ye gerek yok; doğrudan close/sma(...) kullanın. Alt (daha kısa) zaman dilimine inip erken veri okumak için değildir; üst zaman dilimi değeri ancak o bar kapandıktan sonra hizalanır.

İpucu

Üst zaman dilimi değeri, o bar kapandıktan sonra hizalanır; sembol ve zaman dilimi çalışma boyunca sabit olmalıdır.

Üst zaman dilimi değeri, o bar KAPANDIKTAN sonra hizalanır (ileriye bakmaz, sonradan değişmez). `currency` (para birimi dönüşümü) ve `calc_bars_count` parametreleri bu sürümde DESTEKLENMEZ — verilirse sessizce yok sayılır.

Üst zaman dilimi değeri, o bar kapandıktan sonra hizalanır; sembol ve zaman dilimi çalışma boyunca sabit olmalıdır.

CODESCRIPT
plot(security(syminfo.tickerid, "60", close), "1s kapanış", "#ff9800")

5dk grafikte 1 saatlik kapanışın basamaklı çizgisi (her saat güncellenir).

CODESCRIPT
htf = security(syminfo.tickerid, "60", sma(close,20))
enterLong(crossover(close, htf))
exit(crossunder(close, htf))

Fiyat 1 saatlik SMA20'yi yukarı kesince AL — üst zaman dilimi trend filtresi.

securityLowerTf(symbol, tf, source)

Alt zaman diliminden (LTF) intrabar veri: her bar için o barın içindeki alt-TF değerlerini bir dizi olarak döndürür. request.security_lower_tf ad-uzayı biçimi de aynıdır.

Her ana-grafik barı için, o barın içine düşen alt-TF değerlerini kronolojik sırayla içeren bir dizi.

symbol
string
Literal sembol dizesi (PRIMARY veya boş desteklenmez).
tf
string
Ana grafikten DAHA KÜÇÜK bir zaman dilimi (LTF) olmalı.
source
series
LTF bağlamında hesaplanacak ifade (ör. `close`).

Not

`request.security_lower_tf(sembol, tf, kaynak)` ile aynı işlevi görür (ad-uzayı biçimi). `kaynak` ifadesi yalnız yerleşik fonksiyonlar, kullanıcı fonksiyonları (`fn`) ve bağımlı olmayan üst-seviye değişkenler içerebilir.

Sınırlar

Yalnız DAHA KÜÇÜK bir zaman dilimi kabul eder — aynı ya da daha büyük TF verilirse net hata verir (onun için `request.security` kullanılır). İç-içe `request.security*` çağrıları için bir derinlik sınırı vardır, aşılırsa hata verir.

CODESCRIPT
ltfCloses = securityLowerTf("BTCUSDT", "1", close)
plot(ltfCloses.size() > 0 ? ltfCloses.get(ltfCloses.size() - 1) : na)

Her ana-grafik barı için 1 dakikalık alt-TF kapanışlarının dizisini döner; son elemanı çizer.

seed(source, symbol)

Harici (seed) veri serisi. Veri yoksa boş.

Özel bir seed (tohum) veri kümesinden bir sembolün serisini, barlara hizalı döndürür.

source
string
Seed veri kümesi/kaynak adı.
symbol
string
Kaynak içindeki sembol.

Not

Yalnız terminal ilgili seed verisini sağladıysa dolu; yoksa na.

Sınırlar

Bu veri terminal tarafından sağlanmadıysa seri boştur (na). Temel veri kapsamı sembole/piyasaya göre değişir.

CODESCRIPT
plot(seed("BIST_DELAY", "THYAO"), "Seed Serisi")

Seed kaynağından seriyi çizer (veri varsa).

splits(symbol, field?)

Bedelsiz pay (bölünme) oranı. BIST hisselerinde Borsa İstanbul'un hak kullanım duyurusundan okunur; değer YALNIZ hak kullanımının başladığı (payların dağıtıldığı) günden itibaren görünür, öncesinde na. "numerator" = 1 payın kaç paya dönüştüğü (%100 bedelsiz → 2, %300 → 4, %7,829 → 1,07829), "denominator" = 1. Oran = numerator/denominator. Bedelli (rüçhan) sermaye artırımı BURAYA GİRMEZ — o pay bölünmesi değil, ortaktan para toplamadır. Fiyat serisi zaten bedelsize göre düzeltilmiş gelir; bu fonksiyon fiyatı düzeltmek için değil, olayı görmek içindir.

Şirketin bedelsiz pay dağıtımlarını, dağıtımın gerçekleştiği barlara hizalı seri olarak döndürür. "numerator" 1 payın kaç paya dönüştüğüdür (%100 bedelsiz → 2), "denominator" 1'dir.

symbol
string
Şirket sembolü.
field
string
İsteğe bağlı. "numerator"/"denominator" (varsayılan "numerator").

Not

Değer, hak kullanımının başladığı günden itibaren görünür ve bir sonraki olaya kadar taşınır; öncesinde na.

Sınırlar

Yalnız BEDELSİZ pay dağıtımı kaydedilir. Bedelli (rüçhan) sermaye artırımı bilinçli olarak DIŞARIDA — o pay bölünmesi değil, ortaktan para toplamadır ve fiyata etkisi farklı hesaplanır. Kaynak arşivi Borsa İstanbul duyurularından günlük toplanır; arşivin kapsamadığı eski tarihlerde na döner. Fiyat serisi zaten bedelsize göre düzeltilmiş gelir — bu fonksiyon fiyatı düzeltmek için değil, olayın hangi gün gerçekleştiğini görmek içindir.

Bölünme olmayan barlarda na.

CODESCRIPT
plot(splits("THYAO", "numerator"), "Bölünme Payı")

Şu an her zaman na (boş çizgi) — veri kaynağı henüz bağlı değil.

sym("SYMBOL")

Başka sembolün serileri (.open/.high/.low/.close/.volume), bu chart'ın zamanına hizalı. Pair-RV için.

Başka bir sembolün serileri (.open/.high/.low/.close/.volume), bu grafiğin zamanına hizalı.

symbol
string
Sembol kodu, örn. "LTCUSDT".

Not

Pair/oran stratejileri için: oran = close / sym("LTCUSDT").close. Dönen nesnenin alanları normal seri gibi hesaplamada kullanılır.

Ne zaman kullanılır

İki enstrümanı aynı grafikte karşılaştırmak, oran/spread kurmak, göreli güç ya da korelasyon ölçmek için (piyasa-nötr çiftler).

Sınırlar

En fazla 4 ek sembol kullanılabilir. Verinin terminalce sağlanması gerekir; yüklü değilse çağrı hata verir. Seriler bu grafiğin bar zamanlarına hizalanır (ikincil sembolün kendi boşlukları hizalı ızgaraya taşınır).

Uygun değildir

Aynı sembolün üst zaman dilimi için değil — onun için htf ya da security kullanın. Temel veri (bilanço/temettü) için de değil.

CODESCRIPT
oran = close / sym("LTCUSDT").close
plot(oran, "Oran")

İki sembolün fiyat oranını çizer (pair/oran stratejisinin temeli).

CODESCRIPT
plot(correlation(close, sym("LTCUSDT").close, 30), "Korelasyon")

Bu sembol ile LTCUSDT arasındaki 30 barlık korelasyonu çizer.

syminfoPrefix(symbol)

Borsa öneki (':' öncesi). Sonuc: BINANCE

Ticker'ın ":" öncesi önekini döndürür (örn "BIST"); ":" yoksa boş metin.

symbol
string
Tam ticker (örn "BIST:THYAO").

Not

Bir sembolün hangi borsa/sağlayıcıya ait olduğunu ayıklamak için.

Ne zaman kullanılır

Ticker'ın borsa/sağlayıcı bölümüne göre dallanmak ya da etiketlemek için (örn. yalnız "BIST" sembollerine bir kural uygulamak).

Sınırlar

İlk ":" karakterine göre böler; ":" içermeyen sembolde boş metin döner.

CODESCRIPT
label(close, syminfoPrefix("BIST:THYAO"))

Etiket olarak "BIST" yazar.

syminfoTicker(symbol)

Sembol kodu (':' sonrası). Sonuc: BTCUSDT

Argüman verilirse ":" sonrası sembol kısmını döndürür (örn "THYAO"); argümansız çağrıda o an işlenen sembolü döndürür.

symbol
string
İsteğe bağlı. Tam ticker (örn "BIST:THYAO"). Verilmezse aktif bağlam sembolü.

Not

Argümansız syminfoTicker() çoklu-sembol taramalarında aktif sembolü verir (request.security döngülerinde ve securityLowerTf ifadelerinde işe yarar).

Ne zaman kullanılır

Önek olmadan salt sembol kodunu almak, ya da bir taramada o an işlenen sembolü öğrenip etiketlemek/kaydetmek için.

Sınırlar

Argümanlı biçim ilk ":" sonrasını alır (":" yoksa dizeyi olduğu gibi). Argümansız biçimde aktif sembol tanımlı değilse boş metin döner.

CODESCRIPT
label(close, syminfoTicker("BIST:THYAO"))

Etiket olarak "THYAO" yazar.

tickerHeikinashi(symbol)

Heikin-Ashi 'sanal ticker' işaretçisi — TEK BAŞINA hesap yapmaz, security(tickerHeikinashi(sembol), tf, kaynak) içine SEMBOL yerine verilir; kaynak (close/open/high/low) o sembolün Heikin-Ashi'ye dönüştürülmüş halini döner. sembol boş veya syminfo.ticker ise mevcut grafiğin kendisi — yalnız grafiğin KENDİ zaman-diliminde (tf boş/aynı); farklı tf verilirse net hata.

Hesap yapmaz — security()'nin SEMBOL argümanına verilen bir 'sanal ticker' işaretçisi (metin) döner. Gerçek Heikin-Ashi dönüşümü security() çağrıldığında uygulanır.

symbol
string
Heikin-Ashi'si alınacak sembol. Boş bırakılırsa veya syminfo.ticker verilirse mevcut grafiğin kendisi.

Not

Yaygın idiyomun karşılığı: security(tickerHeikinashi(syminfo.ticker), timeframe.period yerine "", close). O çağrıdaki close/open/high/low, standart bar DEĞİL, Heikin-Ashi formülüyle (close=(o+h+l+c)/4, open=önceki HA-open/HA-close ortalaması, high/low=gerçek değer ile HA-open/HA-close'un max/minı) hesaplanmış değeri döner.

Ne zaman kullanılır

Ana grafiği Heikin-Ashi'ye çevirmeden HA-tabanlı bir kaynak (örn HA-close ile crossover) hesaplamak istediğinde.

Sınırlar

Yalnız mevcut grafiğin KENDİ zaman-diliminde çalışır — timeframe farklı verilirse (örn 1sa grafikte "1D") net hata verir (yaklaşık/yanlış sonuç ÜRETMEZ). Başka bir sembolün Heikin-Ashi'si isteniyorsa o sembol kod içinde ayrıca sym()/security() ile yüklenmiş olmalı.

CodeScript standart (zaman) barları üzerinde çalışır; Heikin-Ashi barları üretilmez. Sessizce yanlış (standart-bar) sonuç vermek yerine net hata verir.

CODESCRIPT
haClose = security(tickerHeikinashi(syminfo.ticker), "", close)

Sembolün Heikin-Ashi barlarından kapanışı alır; grafik normal barları gösterirken hesap yumuşatılmış barlar üzerinden yapılır.

tickerInherit(symbol, source)

Sembol ayarlarını miras alır. Sonuc: BTCUSDT

İlk ticker'ı DEĞİŞTİRMEDEN geri döndürür (birebir).

symbol
string
Ticker dizesi.
source
string
Ayarların miras alınacağı kaynak ticker.

Not

Bir sembolün ayarlarını başka bir sembolden miras alması amaçlıdır; standart barlarda etkisizdir (yer tutucu).

Ne zaman kullanılır

Bir sembolün ayarlarını başka birinden miras aldığı kodları taşırken sözdizimi uyumu için.

Sınırlar

İlk ticker'ı değiştirmeden döndürür; kaynak ticker'dan gerçek bir ayar aktarımı yapılmaz.

CODESCRIPT
label(close, tickerInherit("BIST:GARAN", "BIST:THYAO"))

İlk ticker'ı olduğu gibi döndürür ("BIST:GARAN").

CodeScript standart (zaman) barları üzerinde çalışır; Kagi barları üretilmez. Sessizce yanlış (standart-bar) sonuç vermek yerine net hata verir.

CodeScript standart (zaman) barları üzerinde çalışır; Line-break barları üretilmez. Sessizce yanlış (standart-bar) sonuç vermek yerine net hata verir.

tickerModify(symbol,...)

Sembol kodunu değiştirir. Sonuc: BTCUSDT

Ticker'ı DEĞİŞTİRMEDEN geri döndürür (birebir).

symbol
string
Ticker dizesi.

Not

Ticker'a oturum/düzeltme ayarı iliştirmek amaçlıdır; standart barlar üzerinde çalışıldığından bu dönüşüm sembolü olduğu gibi bırakır (yer tutucu).

Ne zaman kullanılır

Oturum/düzeltme ayarı iliştiren kodları taşırken sözdizimi uyumu için bulunur.

Sınırlar

Ticker'ı değiştirmeden döndürür; herhangi bir oturum/düzeltme dönüşümü uygulanmaz.

Uygun değildir

Bar tipini (renko/heikin-ashi vb.) değiştirmek için değil — o dönüşümler burada hata verir.

CODESCRIPT
label(close, tickerModify("BIST:THYAO"))

Ticker'ı olduğu gibi döndürür ("BIST:THYAO").

tickerNew(prefix, symbol)

'ÖNEK:SEMBOL' birleşik sembol kodu. Sonuc: BINANCE:BTCUSDT

"ÖNEK:SEMBOL" biçiminde tam ticker dizesi döndürür (önek boşsa yalnız sembol).

prefix
string
Borsa/veri sağlayıcı öneki (örn "BINANCE", "BIST").
symbol
string
Sembol kodu (örn "BTCUSDT").

Not

security ya da sym için tam ticker üretmekte kullanılır. Sonuç bir metindir, seri değil.

Ne zaman kullanılır

security/sym'e verilecek tam nitelikli ticker'ı borsa öneki + sembolden birleştirmek için.

Sınırlar

Yalnızca metin birleştirir (önek + ":" + sembol); tek başına veri çekmez. Önek boşsa sonuç yalnız semboldür.

CODESCRIPT
label(close, tickerNew("BINANCE", "BTCUSDT"))

Öneki sembole ekleyip "BINANCE:BTCUSDT" ticker'ını üretir; security'de kullanılır.

CodeScript standart (zaman) barları üzerinde çalışır; Point & Figure barları üretilmez. Sessizce yanlış (standart-bar) sonuç vermek yerine net hata verir.

CodeScript standart (zaman) barları üzerinde çalışır; Renko barları üretilmez. Sessizce yanlış (standart-bar) sonuç vermek yerine net hata verir.

tickerStandard(symbol)

Standart sembol kodu. Sonuc: BTCUSDT

Ticker'ı DEĞİŞTİRMEDEN geri döndürür (birebir).

symbol
string
Ticker dizesi.

Not

Sembolü standart (dönüşümsüz) ticker'a çevirmek amaçlıdır; standart barlar üzerinde çalışıldığından bu dönüşüm sembolü olduğu gibi bırakır (yer tutucu).

Ne zaman kullanılır

Bir sembolü açıkça standart bar tipinde istediğini belirtmek için (davranış zaten standarttır).

Sınırlar

Ticker'ı değiştirmeden döndürür; CodeScript zaten standart barlar ürettiğinden etkisizdir.

CODESCRIPT
label(close, tickerStandard("BIST:THYAO"))

Ticker'ı olduğu gibi döndürür ("BIST:THYAO").

trade(series)

Backtest'in P&L yapacağı enstrüman (close yerine). Pair/spread modu. Adlandırılmış argüman olarak `price` de kullanılabilir (series ile birebir aynı, örn. trade(price=oran)).

Değer döndürmez; backtest'in kâr/zararı bu seri üzerinden hesaplanır.

series
series
Backtest'in kâr/zararı hesaplayacağı enstrüman (örn. bir oran/spread). Adlandırılmış argüman olarak `price` de kullanılabilir (birebir aynı).

Not

close yerine bir oran/spread üzerinde işlem simüle etmek için (pair modu). Çağrılmazsa backtest close'u kullanır.

Ne zaman kullanılır

Sinyaller çift/oran üzerinde üretilip P&L de o çift üzerinden hesaplanacağında (piyasa-nötr backtest).

Sınırlar

Bir kodda yalnız bir kez çağrılabilir (ikinci çağrı hata verir). Argüman bir seri olmalıdır.

Uygun değildir

Bir şey çizmez; görsel çıktı için plot kullanın. Grafik sembolünün kendisiyle işlem yapıyorsanız gerekmez (close varsayılan enstrümandır).

CODESCRIPT
x = sym("LTCUSDT")
oran = close / x.close
trade(oran)
enterLong(crossover(ema(oran,5), ema(oran,13)))
enterShort(crossunder(ema(oran,5), ema(oran,13)))

Oran üzerinde EMA kesişimiyle işlem açar; P&L close yerine oran üzerinden hesaplanır.

securityLast(symbol, timeframe, source)

Başka sembol/periyodun SON bilinen değeri — tek sayı. Değer her barda AYNIDIR, bu yüzden panel/etiket gibi tek değer gösteren yerler içindir. Geçmişe bakan bir hesapta kullanmayın: o durumda ileri-bakış üretir, security() kullanın.

Son bilinen değer (tek sayı). Her barda aynıdır.

symbol
Değeri alınacak sembol, örn. "BTCUSDT". Grafiğin kendi sembolü için "" bırakın.
timeframe
Hangi periyot, örn. "1D" ya da "60". Boş bırakılırsa grafiğin periyodu kullanılır.
source
Okunacak seri ya da alan adı: close, high, low, volume.

Not

security() ikincil seriyi grafiğin HER barına hizalar ve tüm aralığı çektirir. Panelde tek sayı gösterecekseniz bu form çok daha az veri çeker: ölçümde 3.270 barlık grafikte ~1.360.000 bar yerine 4.200 bar yetti, çıktı birebir aynıydı.

CODESCRIPT
plot(securityLast(syminfo.tickerid, "", close))

Başka bir zaman diliminden son kapanışı alıp çizer; bekleyen bar yerine tamamlanmış son değeri verir.