← Դեպի փաստաթղթեր
LootX

Язык Loot

LootScript — սեփական Ինդիկատորներ և ալերտներ տերմինալում, ստրատեգիաների թեստավորում պատմության վրա

Կազմվել է: 2026-11-21 docs.lootx.trade
Основы

1LootScript լեզուն

Ի՞նչ է LootScript-ը՝ ինդիկատորներ, ռազմավարություններ և գրադարաններ, որոնք աշխատում են անմիջապես տերմինալում՝ գրաֆիկի տվյալների վրա։ Ի՞նչ տվյալներ են հասանելի, ինչպե՞ս միացնել սկրիպտները և ինչ նրանք չեն անում։

LootScript-ը LootX տերմինալի սկրիպտավորման լեզուն է։ Դրանով գրում են սեփական ինդիկատորներ, ռազմավարություններ՝ գաղափարները պատմության վրա ստուգելու համար, և ընդհանուր ֆունկցիաների գրադարաններ։ Սկրիպտը տեքստային ֆայլ է, որը կատարվում է անմիջապես տերմինալում՝ այն գրաֆիկի տվյալների վրա, որտեղ դուք այն ավելացրել եք՝ մոմեր, ծավալ, delta, footprint cluster-ներ, open interest, funding rate։

Ահա ամբողջական ինդիկատորի օրինակ՝ յուրաքանչյուր բարի delta-ն՝ սյուներով գրաֆիկի տակ.

Loot
indicator("Բարի delta", overlay = false)

d = delta.available ? delta.value : na
plot(d, "Delta", style = plot.style_columns, color = d >= 0 ? color.teal : color.red)

Ինչ կարելի է գրել

Սկրիպտի առաջին տողը հայտարարում է նրա տեսակը, և տեսակից կախված է, թե ինչ է թույլատրվում սկրիպտին։

Տեսակ Առաջին տող Ինչ է անում
Ինդիկատոր indicator("Անվանում") Հաշվում է արժեքներ ըստ բարերի և գծում դրանք՝ գծեր, հիստոգրամներ, մակարդակներ, մարկերներ, ֆոն, պիտակներ։ Գծում է գնի վրա կամ առանձին pane-ում գրաֆիկի տակ։
Ռազմավարություն strategy("Անվանում") Նույնը, ինչ ինդիկատորը, գումարած մուտքի և ելքի կանոններ։ Ռազմավարության հայտերը վիրտուալ են. դրանք կատարում է Ռազմավարության փորձարկիչը պատմության վրա և ցույց է տալիս գործարքները, կապիտալի կորը և ցուցանիշները։
Գրադարան library("Անվանում", 1) Պահում է ֆունկցիաներ, որոնք միացնում են ձեր մյուս սկրիպտները։ Գրաֆիկին չի ավելացվում և ոչինչ չի գծում։

Բացի սեփական սկրիպտներից, կարելի է տեղափոխել պատրաստիները Pine Script ձևաչափից. տերմինալը դրանք կթարգմանի LootScript-ի ներմուծման ժամանակ։ Ինչպես է դա աշխատում և ինչ ստուգել թարգմանությունից հետո՝ Pine Script-ից ներմուծում էջում։

Ինչ տվյալներ են հասանելի սկրիպտին

  • Գրաֆիկի մոմերը. open, high, low, close, volume, բարի ժամանակը և ածանցյալներ, ինչպիսին է hl2-ը։
  • Օրդերների հոսքը. ագրեսիվ գնումների և վաճառքների delta, footprint cluster-ներ ըստ գնի մակարդակների, open interest, funding rate, order book-ի գրանցված պատմությունը, screener-ի մետրիկները։
  • Կենդանի order book և time and sales — միայն ընթացիկ, դեռ չփակված բարի վրա. դրանց պատմությունը չի գրանցվում։
  • Այլ timeframes և գործիքներ — ավագ timeframe-ից կամ այլ մետաղադրամից շարքի հարցման միջոցով։

Եթե բորսան չի տալիս որևէ ցուցանիշ կամ տվյալներ չկան բարի համար, սկրիպտը ստանում է ոչ թե զրո, այլ հատուկ արժեք na — «արժեք չկա»։ Գրաֆիկի վրա դա գծի ընդհատում է, ոչ թե կեղծ զրո։ Մանրամասներն ու ծածկույթն ըստ բորսաների՝ Շուկայի տվյալներ էջում։

Որտեղ է կատարվում սկրիպտը

Սկրիպտն աշխատում է տերմինալի ներսում՝ ձեր համակարգչում։ LootX սերվերին այն չի ուղարկվում և այնտեղ չի կատարվում։

  • Մեկուսացում։ Սկրիպտը մուտք չունի ցանց, ֆայլեր, բորսաների միացումներ և API բանալիներ։ Այդպիսի ֆունկցիաներ լեզվում պարզապես չկան. ոչ պատահաբար, ոչ դիտավորյալ սկրիպտը չի կարող որևէ տեղ փոխանցել ձեր տվյալները։
  • Սահմանափակումներ։ Չափազանց երկար ցիկլը կամ հսկայական զանգվածը կանգնեցնում է միայն այդ սկրիպտը։ Մյուս ինդիկատորները, վահանակները և տերմինալն ինքը շարունակում են աշխատել, իսկ կանգնելու պատճառը տեսանելի է խմբագրիչում։
  • Ֆայլեր։ Յուրաքանչյուր սկրիպտ առանձին ֆայլ է .loot ընդլայնմամբ։ Windows-ում դրանք գտնվում են %APPDATA%\TradingTerminal\scripts\ պանակում՝ տեղադրման պանակից դուրս, այնպես որ տերմինալի թարմացումները նրանց չեն ազդում։ Սկրիպտն այլ համակարգիչ տեղափոխել նշանակում է պատճենել ֆայլը։

Ինչպես միացնել սկրիպտները

Սկրիպտներն առանձին մոդուլ են, որը միացվում է ձեր LootX հաշվի համար։ Որպեսզի այն աշխատի, մուտք գործեք հաշիվ տերմինալում։

Երբ մոդուլը միացված է, գրաֆիկի ինդիկատորների պատուհանում (գրաֆիկի վրա ƒ կոճակը) հայտնվում են Ընտրյալներ, Իմ սկրիպտները, Ներկառուցված և Ռազմավարություններ բաժինները, իսկ վերևում՝ Ներմուծում… և Խմբագրիչ… կոճակները։

Երբ մոդուլը միացված չէ, սկրիպտներն ընդհանրապես չեն ցուցադրվում. ինդիկատորների պատուհանը պարունակում է միայն ներկառուցված ինդիկատորները, խմբագրիչ և ներմուծում չկա։ Կողպեքներ և գնելու առաջարկներ նույնպես չկան. տերմինալն այնպիսի տեսք ունի, կարծես սկրիպտներ նրանում գոյություն չունեն։ Հենց հասանելիությունը հայտնվի, ինդիկատորների պատուհանն ինքն իրեն կվերակառուցվի, տերմինալը վերագործարկել պետք չէ։

Հասանելիությունը տրվում է հաշվին՝ սակագնի կազմում կամ առանձին։ Ընթացիկ սակագները՝ Բաժանորդագրություններ էջում։

Ինչ սկրիպտները չեն անում

  • Չի մտնում ինտերնետ և չի կարդում ֆայլեր։ Այն ամենը, ինչ սկրիպտը գիտի, այն գրաֆիկի տվյալներն են, որի վրա նա կանգնած է։
  • Չի հրապարակվում և չի վաճառվում։ Սկրիպտների կատալոգ չկա. սկրիպտը ձեր լոկալ ֆայլն է, կիսվել դրանով կարելի է միայն ֆայլը փոխանցելով։
  • Չի կատարում Pine Script-ն ուղղակիորեն։ Այս ձևաչափի սկրիպտները նախ թարգմանվում են LootScript-ի ներմուծման ժամանակ. նույն թվերը այլ հարթակների հետ երաշխավորված չեն։

Հաջորդը

https://docs.lootx.trade/hy/loot/overview

Справочник

2Ֆունկցիաների ձեռնարկ

LootScript-ի բոլոր մուտք {built‑in} ֆունկցիաները, շարքերը և կոնստանտները՝ ta, math, str, color, input, գծազարդումներ, հավաքածուներ, ստրատեգիաներ և orderflow տվյալներ՝ հետագա պարամետրերով և լռելյայն արժեքներով։

Այստեղ перечислено всё, что встроено в LootScript: объявления скрипта, ряды бара, функции по пространствам имён, константы и данные ордерфлоу. Список собран по таблице встроенных имён самого компилятора — того, чего нет на этой странице, нет и в языке, и вызов такого имени закончится ошибкой LS2002.

Справочник не учит языку: как устроены типы, na, история x[1] и повторный запуск бара, рассказано в Синтаксис и типы, а рисование и настройки — в Настройки и отрисовка.

Как читать справочник

Каждая функция записана одной строкой: имя, параметры в том порядке, в каком их разбирает позиционный вызов, и тип результата.

Loot
ta.stdev(source, length, biased = true) → float
  • Параметр без = … обязателен. Параметр со значением необязателен: если его пропустить, подставится указанное значение.
  • = na у необязательного параметра значит «не задан»: функция поведёт себя так, как описано в строке.
  • Имена параметров можно писать в вызове явно: ta.stdev(close, 20, biased = false). Имена — часть языка, их нельзя сокращать.
  • Результат [float, float, float] — несколько значений сразу. Их разбирают в переменные: [mid, up, dn] = ta.bb(close, 20, 2).
  • Имя без скобок (close, ta.obv, strategy.equity) — ряд или константа, его читают без вызова.
  • Результат — означает, что функция ничего не возвращает и пишется отдельной строкой.

Объявление скрипта

Первой строкой скрипта стоит ровно одно объявление: indicator, strategy или library. Его аргументы читаются до первого бара, поэтому годятся только литералы и константы.

Объявление Что создаёт
indicator(title, …) Индикатор на графике
strategy(title, …) Ստրատեգիա для тестера: те же возможности, что у индикатора, плюс заявки strategy.*
library(title, version) Библиотеку функций. Её подключают строкой import Имя/версия as псевдоним. В библиотеке нельзя рисовать и объявлять настройки

Параметры indicator

Параметр По умолчанию Что задаёт
title — Название в списке индикаторов и в легенде
shortTitle na Короткое название для легенды
overlay false true — рисовать поверх свечей, false — в отдельной области под графиком
format, precision, scale na Принимаются ради совместимости: шкалу и формат чисел ведёт терминал
maxBarsBack na Принимается и не действует: история всегда загружается целиком
timeframe na Принимается и не действует: скрипт считается на таймфрейме графика, другой таймфрейм даёт request.security
maxLinesCount, maxLabelsCount, maxBoxesCount 500 Сколько линий, меток и прямоугольников одного вида живут одновременно. Сверх предела удаляется самый старый
maxPolylinesCount 500 Зарезервирован: объектов polyline в языке пока нет

Константы для format: format.inherit, format.price, format.volume, format.percent, format.mintick. Для scale: scale.right, scale.left, scale.none. Строки format.* понимает и str.tostring.

Параметры strategy

У strategy те же title, shortTitle, overlay и пределы объектов рисования, что у indicator, плюс параметры тестера:

Параметр По умолчанию Что задаёт
initialCapital 10000 Стартовый капитал
currency "USD" Принимается; на расчёт не влияет
defaultQtyType strategy.qty.fixed Как читать размер заявки по умолчанию: strategy.qty.fixed — штуки, strategy.qty.cash — сумма, strategy.qty.percent_of_equity — процент капитала, strategy.qty.risk_percent — процент риска до стопа
defaultQtyValue 1 Размер заявки по умолчанию
commissionType strategy.commission.percent Комиссия в процентах, strategy.commission.cash_per_contract — за единицу, strategy.commission.cash_per_order — за заявку
commissionValue na Размер комиссии. na — ставки мейкера и тейкера инструмента
slippageTicks 0 Проскальзывание в шагах цены
pyramiding 0 Сколько дополнительных входов в ту же сторону разрешено
positionModel strategy.model.netting Одна общая позиция или раздельные (strategy.model.hedging)
calcOnEveryTick false Считать заявки на каждом тике живого бара, а не только на закрытии
calcOnOrderFills false Принимается; эта версия его не использует
processOrdersOnClose false Исполнять заявки по цене закрытия того же бара. Отчёт помечается как недостижимый вживую
marginLong, marginShort 0 Начальная մարժա лонга и шорта в процентах от позиции. 0 — без симуляции մարզա и լիկվիդացիաների
leverage 1 Плечо
applyFunding true Учитывать funding rate бессрочных фьючерсов в результате
fillModel strategy.fill.conservative Путь цены внутри бара. Осторожная модель считает, что цена сначала сходила в худшую сторону: если стоп и тейк оба внутри бара, исполнится стоп. strategy.fill.optimistic — наоборот

Бар и инструмент

Ряды бара

Имя Тип Что содержит
open, high, low, close, volume float Цены и объём бара
hl2, hlc3, ohlc4, hlcc4 float Средние цены бара: (H+L)/2, (H+L+C)/3, (O+H+L+C)/4, (H+L+2C)/4
time, time_close int Время открытия и закрытия бара, миллисекунды UTC
bar_index int Номер бара от начала загруженной истории, с нуля
last_bar_index int Номер последнего загруженного бара
timenow int Текущее время терминала, миллисекунды UTC

Состояние бара: barstate

Имя Истинно, когда
barstate.isfirst Первый բար загруженной истории
barstate.islast Последний загруженный բար
barstate.ishistory Бар из истории, а не формирующийся
barstate.isrealtime Бар формируется в реальном времени
barstate.isnew Первый проход по новому բար
barstate.isconfirmed Бар закрылся — значение больше не изменится

isrealtime, isnew и значения, зависящие от них, отличаются на истории и вживую — компилятор предупредит, если они доходят до графика.

Инструмент: sym

Имя Тип Что содержит
sym.ticker string Площадка и символ в том виде, какой принимает request.security
sym.exchange string Код площадки
sym.base, sym.quote string Базовый и котируемый актив: BTC и USDT у BTCUSDT. na, если котировку не удалось выделить
sym.tick_size float Шаг цены
sym.qty_step, sym.min_qty float Шаг и минимум количества
sym.maker_fee, sym.taker_fee float Комиссии մեյքեր и տեյքեր долей: 0.0002 — это 0,02 %

Таймфрейм: tf

Имя Тип Что содержит
tf.period string Таймфрейм графика текстом: "5", "60", "1D"
tf.ms, tf.seconds int Длина бара в миллисекундах и секундах
tf.isintraday, tf.isdaily bool Бар короче суток; бар — ровно сутки
tf.in_ms(period) int Длина произвольного таймфрейма в миллисекундах; na, если строка не разобрана
tf.in_seconds(period = na) int То же в секундах; без аргумента — таймфрейм графика

Время и календарь

Все календарные функции по умолчанию считают в UTC, а не в часовом поясе компьютера: так индикатор выглядит одинаково у всех.

Функция Возвращает Что делает
year, month, dayofmonth, weekofyear (timestamp = time, timezone = "UTC") int Год, месяц, число, номер недели по ISO
dayofweek(timestamp = time, timezone = "UTC") int День недели: воскресенье — 1, суббота — 7
hour, minute, second (timestamp = time, timezone = "UTC") int Час, минута, секунда
time_of_day(timestamp = time, timezone = "UTC") int Миллисекунды от полуночи в заданном поясе
timestamp(year, month, day, hour = 0, minute = 0, second = 0, timezone = "UTC") int Метка времени из даты
time_in_range(session, timezone = "UTC") bool Бар попадает в интервал вида "0930-1600"
session.ismarket, session.isfirstbar, session.islastbar bool Бар внутри сессии, первый и последний бар сессии. У круглосуточных рынков сессия — сутки UTC

Константы дней совпадают с тем, что возвращает dayofweek: dayofweek.sunday (1), dayofweek.monday, dayofweek.tuesday, dayofweek.wednesday, dayofweek.thursday, dayofweek.friday, dayofweek.saturday (7). Часовой пояс задаётся идентификатором IANA, например "Europe/Moscow".

ta — технический анализ

Функции ta.* помнят своё состояние между барами, поэтому компилятор вычисляет их на каждом баре, даже если вызов стоит внутри if. Первые бары, пока окно не заполнилось, функции возвращают na.

Скользящие средние

Функция Возвращает Что делает
ta.sma(source, length) float Простое среднее за length баров
ta.ema(source, length) float Экспоненциальное среднее: вес нового значения 2/(length+1)
ta.rma(source, length) float Сглаживание Уайлдера, вес 1/length. На нём построены RSI и ATR; это не то же, что ta.ema той же длины
ta.wma(source, length) float Линейно взвешенное: свежие бары весят больше
ta.vwma(source, length) float Среднее, взвешенное по объёму
ta.hma(source, length) float Среднее Халла: меньше запаздывает на разворотах
ta.swma(source) float Симметрично взвешенное среднее по четырём барам
ta.alma(source, length, offset = 0.85, sigma = 6) float Среднее с гауссовым окном; offset сдвигает пик к свежим барам, sigma задаёт ширину
ta.linreg(source, length, offset = 0) float Точка на линии регрессии по последним length значениям

Осцилляторы

Функция Возвращает Что делает
ta.rsi(source, length) float Индекс относительной силы, 0…100
ta.stoch(source, high, low, length) float Где source находится внутри диапазона high–low за length баров, 0…100
ta.cci(source, length) float Отклонение от среднего, нормированное средним абсолютным отклонением
ta.mfi(source, length) float Индекс денежного потока: RSI с учётом объёма
ta.cmo(source, length) float Осциллятор Чанде, −100…100
ta.roc(source, length) float Изменение в процентах к значению length баров назад
ta.mom(source, length) float Разница с значением length баров назад
ta.tsi(source, shortLength, longLength) float Индекс истинной силы: дважды сглаженный импульс к дважды сглаженному модулю импульса
ta.wpr(length) float Williams %R, −100…0
ta.bop(length = 1) float Баланс сил: какую часть диапазона бара заняло тело, со сглаживанием
ta.cog(source, length) float Центр тяжести окна

Волатильность и каналы

Функция Возвращает Что делает
ta.tr(handle_na = true) float Истинный диапазон бара
ta.atr(length) float Средний истинный диапазон
ta.natr(length) float ATR в процентах от цены закрытия
ta.stdev(source, length, biased = true) float Стандартное отклонение. biased = false — выборочное, с делителем length−1
ta.variance(source, length, biased = true) float Дисперсия, с тем же выбором делителя
ta.dev(source, length) float Среднее абсолютное отклонение от среднего
ta.bb(source, length, mult) [float, float, float] Полосы Боллинджера: средняя, верхняя, нижняя
ta.bbw(source, length, mult) float Ширина полос Боллинджера относительно средней
ta.kc(source, length, mult, useTrueRange = true) [float, float, float] Канал Кельтнера: средняя, верхняя, нижняя
ta.kcw(source, length, mult, useTrueRange = true) float Ширина канала Кельтнера относительно средней
ta.range(length) float Высота последних length баров: максимум high минус минимум low

Тренд

Функция Возвращает Что делает
ta.macd(source, fastLength, slowLength, signalLength) [float, float, float] MACD: линия, сигнальная линия, гистограмма
ta.dmi(diLength, adxLength) [float, float, float] Индекс направленного движения: +DI, −DI, ADX
ta.adx(diLength, adxLength) float Только ADX
ta.supertrend(factor, atrLength) [float, int] Линия супертренда и направление: 1 — тренд вверх, −1 — вниз
ta.sar(start = 0.02, increment = 0.02, maximum = 0.2) float Параболик SAR
ta.vortex(length) [float, float] Индикатор вихря: VI+ и VI−
ta.aroon(length) [float, float] Арун вверх и вниз: как давно были максимум и минимум окна, 0…100

Объём

Функция Возвращает Что делает
ta.obv, ta.pvt, ta.nvi, ta.pvi, ta.ad float Накопительные ряды без скобок: балансовый объём, объём по изменению цены, индексы отрицательного и положительного объёма, накопление/распределение
ta.cmf(length) float Денежный поток Чайкина
ta.eom(length = 14, divisor = 10000) float Лёгкость движения: сдвиг цены на единицу объёма
ta.vwap(source = hlc3, anchor = session.isfirstbar) float VWAP от последнего бара, на котором anchor было истинно

Структура и события

Функция Возвращает Что делает
ta.highest(source, length), ta.lowest(source, length) float Максимум и минимум за length баров
ta.highestbars(source, length), ta.lowestbars(source, length) int Смещение до бара с максимумом или минимумом: 0 — текущий бар, дальше отрицательные числа
ta.crossover(a, b) bool a пересекло b снизу вверх на этом баре
ta.crossunder(a, b) bool a пересекло b сверху вниз
ta.cross(a, b) bool Любое из двух пересечений
ta.change(source, length = 1) float Разница с значением length баров назад
ta.rising(source, length), ta.falling(source, length) bool Значение росло (падало) на каждом из последних length баров
ta.barssince(condition) int Сколько баров прошло с последнего раза, когда условие было истинным
ta.valuewhen(condition, source, occurrence = 0) float Значение source на баре, где условие было истинным; occurrence = 1 — на предпоследнем таком баре
ta.pivothigh(source, leftBars, rightBars), ta.pivotlow(…) float Подтверждённая вершина или впадина. Появляется через rightBars баров после самой точки
ta.percentrank(source, length) float Какой процентpast` прошлых значений окна не больше текущего
ta.median(source, length), ta.mode(source, length) float Медиана и самое частое значение окна
ta.correlation(source1, source2, length) float Корреляция двух рядов, −1…1
ta.sum(source, length) float Сумма за length баров
ta.cum(source) float Сумма с первого загруженного бара

Отсутствие значения: na

Функция Возвращает Что делает
na(x) bool Истинно, если значения нет. Работает с любым типом, в том числе с объектами и коллекциями
nz(x, replacement = 0) float Заменяет na на replacement
fixnan(x) float Протягивает последнее существующее значение через пропуски

Сравнение x == na компилятор не пропустит: оно всегда ложно. Проверяйте через na(x), а подставляйте значение по умолчанию оператором a ?? b.

math

Функция Возвращает Что делает
math.abs(x), math.sign(x) float Модуль и знак (−1, 0, 1). math.abs от целого остаётся целым
math.round(x, precision = na) int или float Без precision — до целого, результат int. С precision — до знаков после запятой, результат float
math.floor(x), math.ceil(x), math.trunc(x) int Вниз, вверх, отбрасывание дробной части
math.min(a, b, c = na, d = na), math.max(…) float Минимум и максимум из 2–4 значений; na пропускается. От целых — целое
math.sum(a, b, c = na, d = na), math.avg(…) float Сумма и среднее из 2–4 значений
math.clamp(x, lower, upper) float Зажимает значение в границы
math.pow(base, exponent) float Степень
math.sqrt(x), math.cbrt(x) float Квадратный и кубический корень
math.exp(x), math.log(x), math.log10(x), math.log2(x) float Экспонента и логарифмы
math.hypot(x, y) float Длина гипотенузы
math.gcd(a, b), math.lcm(a, b) int Наибольший общий делитель, наименьшее общее кратное
math.approx(a, b, tolerance = 1e-9) bool Числа равны с относительной точностью tolerance
math.random(min = 0, max = 1, seed = na) float Случайное число в [min, max). У каждого вызова своя последовательность
math.pi, math.e, math.phi, math.rphi, math.inf, math.epsilon float Константы: π, e, золотое сечение и обратное к нему, бесконечность, машинный эпсилон
Тригонометрия
Функция Возвращает Что делает
math.sin(x), math.cos(x), math.tan(x) float Синус, косинус, тангенс; угол в радианах
math.asin(x), math.acos(x), math.atan(x) float Обратные функции
math.atan2(y, x) float Угол точки (x, y) с учётом четверти
math.sinh(x), math.cosh(x), math.tanh(x) float Гиперболические функции
math.todegrees(radians), math.toradians(degrees) float Перевод радиан в градусы и обратно

str — строки

Функция Возвращает Что делает
str.tostring(value, format = na) string Число в текст; format — format.* или шаблон
str.tonumber(text) float Текст в число; na, если не разобрано
str.format(pattern, arg0, arg1 = na, arg2 = na, arg3 = na) string Подставляет значения в шаблон вида "RSI {0}, ATR {1}"
str.format_time(timestamp, format = "yyyy-MM-dd HH:mm:ss", timezone = "UTC") string Метка времени в текст
str.length(text) int Длина строки
str.substring(text, begin, end = na) string Часть строки; без end — до конца
str.pos(text, needle) int Позиция первого вхождения
str.contains(text, needle), str.startswith(text, prefix), str.endswith(text, suffix) bool Проверки вхождения, начала и конца
str.replace(text, target, replacement, occurrence = 0) string Заменяет одно вхождение, по умолчанию первое
str.replace_all(text, target, replacement) string Заменяет все вхождения
str.split(text, separator) array<string> Режет строку на части
str.join(parts, separator = "") string Склеивает массив строк
str.upper(text), str.lower(text), str.trim(text) string Регистр и обрезка пробелов по краям
str.repeat(text, count, separator = "") string Повторяет строку count раз
str.match(text, pattern) string Первое совпадение с регулярным выражением или na
str.escape_regex(text) string Экранирует спецсимволы, чтобы искать текст буквально

Строку нельзя сложить с числом через + — переведите число в текст через str.tostring.

color — цвета

Функция Возвращает Что делает
color.rgb(red, green, blue, alpha = 255) color Цвет из каналов 0…255
color.new(base, alpha) color Тот же цвет с другой непрозрачностью
color.from_gradient(value, bottomValue, topValue, bottomColor, topColor) color Цвет между двумя по положению value в диапазоне
color.r(c), color.g(c), color.b(c), color.t(c) int Красный, зелёный, синий канал и альфа, 0…255

Альфа в LootScript — это непрозрачность: 255 — сплошной цвет, 0 — полностью прозрачный. Готовые цвета: color.red, color.green, color.blue, color.teal, color.orange, color.purple, color.yellow, color.white, color.black, color.gray, color.silver, color.maroon, color.navy, color.olive, color.lime, color.aqua, color.fuchsia. Цвет можно записать и литералом: #FF9800 или #FF980080.

input — настройки скрипта

Каждый вызов input.* добавляет строку в окно настроек индикатора. Значение постоянно за весь прогон, поэтому годится в длину окна ta.*.

Функция Возвращает Строка настроек
input.int(defval, title = na, minval = na, maxval = na, step = 1, tooltip = na, group = na, inline = na) int Целое число
input.float(defval, title = na, minval = na, maxval = na, step = 0.1, tooltip = na, group = na, inline = na) float Дробное число
input.bool(defval, title = na, tooltip = na, group = na, inline = na) bool Флажок
input.string(defval, title = na, options = na, tooltip = na, group = na, inline = na) string Текст или список из options
input.color(defval, title = na, tooltip = na, group = na, inline = na) color Выбор цвета
input.source(defval, title = na, tooltip = na, group = na, inline = na) float Выбор ряда: close, hl2, volume и другие
input.enum(defval, title = na, tooltip = na, group = na, inline = na) тип перечисления Список из членов вашего enum
input.symbol(defval, title = na, tooltip = na, group = na, inline = na) string Инструмент в формате "ПЛОЩАДКА:СИМВОЛ"
input.timeframe(defval, title = na, options = na, tooltip = na, group = na, inline = na) string Таймфрейм: "5", "60", "1D"

group объединяет строки под общим заголовком, inline ставит несколько строк в один ряд, tooltip показывает հուշում. Сохранённое значение привязано к имени переменной: переименуете переменную — настройка вернётся к defval.

Вывод на график

Эти функции пишутся отдельной строкой. Всего у скрипта может быть до 64 выводов, но панель графика рисует только первые три ряда plot.

Функция Что рисует
plot(series, title = na, color = #2196F3, linewidth = na, style = plot.style_line, offset = 0, join = false, editable = true, show_last = na, display = display.all) Ряд значений. na даёт разрыв линии. Без linewidth берётся толщина панели
plotshape(condition, title = na, style = shape.triangleup, location = location.belowbar, color = color.blue, text = na, size = size.small, offset = 0) Значок на барах, где условие истинно
plotchar(condition, title = na, char = "▲", location = location.abovebar, color = color.blue, text = na, size = size.auto, offset = 0) Символ на барах, где условие истинно
hline(price, title = na, color = color.gray, linestyle = hline.style_dashed, linewidth = na) Горизонтальный уровень. Цена — постоянная
fill(plot1, plot2, color = na, title = na, top_value = na, bottom_value = na, top_color = na, bottom_color = na) Заливка между двумя plot или hline: одним цветом либо градиентом по четырём последним параметрам
bgcolor(color, offset = 0, title = na) Фон бара; na — без фона
barcolor(color, offset = 0, title = na) Цвет свечи

plot и hline возвращают ссылку, которую передают в fill: p1 = plot(a), затем fill(p1, p2, color = …).

Стили plot: plot.style_line, plot.style_linebr, plot.style_stepline, plot.style_stepline_diamond, plot.style_histogram, plot.style_columns, plot.style_area, plot.style_areabr, plot.style_circles, plot.style_cross. Стили hline: hline.style_solid, hline.style_dashed, hline.style_dotted. Значки: shape.triangleup, shape.triangledown, shape.circle, shape.square, shape.diamond, shape.arrowup, shape.arrowdown, shape.cross, shape.xcross, shape.flag, shape.labelup, shape.labeldown. Положение значка: location.abovebar, location.belowbar, location.top, location.bottom, location.absolute. Размер: size.auto, size.tiny, size.small, size.normal, size.large, size.huge. Где показывать ряд: display.all, display.pane, display.price_scale, display.status_line, display.data_window, display.none.

Объекты рисования

Линии, прямоугольники, метки и таблицы создаются вызовом .new и живут, пока их не удалят или не вытеснит предел (по умолчанию 500 объектов одного вида). .new возвращает ссылку, через которую объект меняют. Сеттер на na ничего не делает, поэтому шаблон «удалить и создать заново» не требует проверок. Все объекты одного вида — массив line.all, box.all, label.all, table.all.

Координата X по умолчанию — номер бара (xloc.bar_index); с xloc.bar_time — время бара в миллисекундах. Координата Y — цена или значение шкалы панели.

line

Функция Возвращает Что делает
line.new(x1, y1, x2, y2, xloc = xloc.bar_index, extend = extend.none, color = color.blue, style = line.style_solid, width = 1) line Отрезок между двумя точками
line.set_x1(id, x), line.set_y1(id, y), line.set_x2(id, x), line.set_y2(id, y) — Меняет один конец
line.set_xy1(id, x, y), line.set_xy2(id, x, y) — Меняет точку целиком
line.set_xloc(id, x1, x2, xloc) — Меняет обе X и способ их чтения
line.set_extend(id, extend), line.set_color(id, color), line.set_style(id, style), line.set_width(id, width) — Продление, цвет, стиль, толщина
line.get_x1(id), line.get_x2(id) int Координаты X концов
line.get_y1(id), line.get_y2(id) float Координаты Y концов
line.get_price(id, x) float Цена на линии в точке x
line.copy(id) line Копия линии
line.delete(id) — Удаляет линию

Продление: extend.none, extend.left, extend.right, extend.both. Стили: line.style_solid, line.style_dotted, line.style_dashed, line.style_arrow_left, line.style_arrow_right, line.style_arrow_both.

label

Функция Возвращает Что делает
label.new(x, y, text = na, xloc = xloc.bar_index, yloc = yloc.price, color = color.blue, style = label.style_label_down, textcolor = color.white, size = size.normal, textalign = text.align_center, tooltip = na, text_font_family = font.family_default) label Метка с текстом
label.set_x(id, x), label.set_y(id, y), label.set_xy(id, x, y) — Положение
label.set_text(id, text), label.set_tooltip(id, text) — Текст и հուշում
label.set_color(id, color), label.set_textcolor(id, color) — Цвет фона и текста
label.set_style(id, style), label.set_size(id, size), label.set_textalign(id, align), label.set_text_font_family(id, family) — Форма, размер, выравнивание, шрифт
label.set_xloc(id, x, xloc), label.set_yloc(id, yloc) — Способ чтения координат
label.get_x(id) int Координата X
label.get_y(id) float Координата Y
label.get_text(id) string Текст
label.copy(id) label Копия метки
label.delete(id) — Удаляет метку

Привязка по Y: yloc.price, yloc.abovebar, yloc.belowbar. Формы: label.style_none, label.style_label_up, label.style_label_down, label.style_label_left, label.style_label_right, label.style_label_center, label.style_circle, label.style_square, label.style_diamond, label.style_arrowup, label.style_arrowdown, label.style_triangleup, label.style_triangledown, label.style_flag, label.style_cross, label.style_xcross, label.style_text_outline. Шрифт: font.family_default, font.family_monospace.

box — прямоугольники
Функция Возвращает Что делает
box.new(left, top, right, bottom, border_color = color.blue, border_width = 1, border_style = line.style_solid, extend = extend.none, xloc = xloc.bar_index, bgcolor = na, text = na, text_size = size.auto, text_color = color.white, text_halign = text.align_center, text_valign = text.align_center, text_wrap = text.wrap_none) box Прямоугольник с необязательным текстом
box.set_left(id, x), box.set_right(id, x), box.set_top(id, y), box.set_bottom(id, y) — Одна сторона
box.set_lefttop(id, x, y), box.set_rightbottom(id, x, y) — Угол целиком
box.set_xloc(id, left, right, xloc) — Обе X и способ их чтения
box.set_border_color(id, color), box.set_border_width(id, width), box.set_border_style(id, style) — Рамка
box.set_bgcolor(id, color), box.set_extend(id, extend) — Заливка и продление
box.set_text(id, text), box.set_text_color(id, color), box.set_text_size(id, size), box.set_text_halign(id, align), box.set_text_valign(id, align) — Текст внутри
box.get_left(id), box.get_right(id) int Координаты X
box.get_top(id), box.get_bottom(id) float Координаты Y
box.copy(id) box Копия
box.delete(id) — Удаляет прямоугольник

Выравнивание текста: text.align_left, text.align_center, text.align_right, text.align_top, text.align_bottom. Перенос: text.wrap_none, text.wrap_auto.

table — таблицы

Таблица закреплена в углу панели и не двигается вместе со свечами. Ячеек — не больше 2000.

Функция Возвращает Что делает
table.new(position, columns, rows, bgcolor = na, frame_color = na, frame_width = 0, border_color = na, border_width = 0) table Таблица заданного размера
table.cell(id, column, row, text = "", width = 0, height = 0, text_color = color.black, text_halign = text.align_center, text_valign = text.align_center, text_size = size.normal, bgcolor = na, tooltip = na, text_font_family = font.family_default) — Заполняет ячейку
table.cell_set_text(id, column, row, text), table.cell_set_tooltip(…, text) — Текст и հուշում ячейки
table.cell_set_text_color(…, color), table.cell_set_bgcolor(…, color) — Цвета ячейки
table.cell_set_text_size(…, size), table.cell_set_text_halign(…, align), table.cell_set_text_valign(…, align), table.cell_set_text_font_family(…, family) — Оформление текста
table.cell_set_width(…, width), table.cell_set_height(…, height) — Размер ячейки
table.set_position(id, position) — Угол панели
table.set_bgcolor(id, color), table.set_frame_color(id, color), table.set_frame_width(id, width), table.set_border_color(id, color), table.set_border_width(id, width) — Фон, рамка, линии между ячейками
table.merge_cells(id, start_column, start_row, end_column, end_row) — Объединяет прямоугольник ячеек
table.clear(id, start_column, start_row, end_column = na, end_row = na) — Очищает ячейку или диапазон
table.delete(id) — Удаляет таблицу

Положение: position.top_left, position.top_center, position.top_right, position.middle_left, position.middle_center, position.middle_right, position.bottom_left, position.bottom_center, position.bottom_right.

heatmap — тепловое поле

Рисует ячейки «цена × бар» под свечами тем же способом, что встроенная теплокарта. Работает только в скрипте с overlay = true. До четырёх слоёв (layer от 0 до 3).

Функция Что делает
heatmap.cell(price, value, layer = 0) Кладёт значение в ячейку на цене price текущего бара
heatmap.depth(side = 0, min_qty = na, layer = 0) Заливает слой записанным order book этого бара. side: 1 — только bid-եր, −1 — только ask-եր, 0 — обе стороны
heatmap.config(layer = 0, grid = na, palette = na, opacity = na, gamma = na, low = na, high = na, scale = na, cut = na, merge = na) Оформление слоя: шаг цены, палитра, непрозрачность в процентах, контраст, пороги палитры в процентах, верх шкалы, отсечение слабых ячеек, способ сложения повторов

Палитры: heatmap.viridis (по умолчанию), heatmap.magma, heatmap.inferno, heatmap.plasma, heatmap.turbo, heatmap.cividis, heatmap.ocean, heatmap.fire, heatmap.mono, heatmap.spectrum, heatmap.forest, heatmap.violet. Повторы ячейки на баре: heatmap.merge_max (по умолчанию) или heatmap.merge_sum.

Коллекции: array, map, matrix

Тип элемента указывают при создании: array.new<float>(0), map.new<string, float>(). Чтобы коллекция жила между барами, создавайте её через var. Функции можно звать и как методы: a.push(x) — то же, что array.push(a, x).

array

Функция Возвращает Что делает
array.new<T>(size = 0, initial = na) array<T> Массив из size элементов со значением initial
array.from(v0, v1, …) array<T> Массив из перечисленных значений, до десяти
array.size(id) int Число элементов
array.get(id, index), array.set(id, index, value) T, — Чтение и запись по индексу
array.push(id, value), array.pop(id) —, T Добавить в конец, снять с конца
array.unshift(id, value), array.shift(id) —, T Добавить в начало, снять с начала
array.insert(id, index, value), array.remove(id, index) —, T Вставить и удалить по индексу
array.clear(id) — Очистить
array.includes(id, value) bool Есть ли значение
array.indexof(id, value), array.lastindexof(id, value) int Первая и последняя позиция значения
array.sort(id, order = order.ascending) — Сортирует на месте; order.descending — по убыванию
array.sum(id), array.avg(id) float Сумма и среднее; na пропускаются
array.min(id, nth = 0), array.max(id, nth = 0) float Наименьшее и наибольшее; nth = 1 — второе по порядку
array.join(id, separator = ",") string Элементы через разделитель
Остальные функции array
Функция Возвращает Что делает
array.fill(id, value, index_from = 0, index_to = na) — Заполняет диапазон одним значением
array.slice(id, index_from, index_to) array<T> Часть массива
array.concat(id1, id2) array<T> Дописывает второй массив к первому
array.copy(id) array<T> Копия
array.reverse(id) — Переворачивает на месте
array.sort_indices(id, order = order.ascending) array<int> Индексы элементов в порядке сортировки
array.binary_search(id, value), array.binary_search_leftmost(…), array.binary_search_rightmost(…) int Двоичный поиск в отсортированном массиве
array.equals(id1, id2) bool Массивы совпадают поэлементно
array.median(id), array.mode(id), array.range(id) float Медиана, самое частое значение, размах
array.stdev(id, biased = true), array.variance(id, biased = true) float Стандартное отклонение и дисперсия
array.covariance(id1, id2, biased = true) float Ковариация двух массивов
array.abs(id) array<float> Массив модулей
array.percentile_linear_interpolation(id, percentage) float Перцентиль с интерполяцией
array.percentrank(id, index) float Процентный ранг элемента

map

Функция Возвращает Что делает
map.new<K, V>() map<K, V> Пустой словарь
map.put(id, key, value) V Записывает значение, возвращает прежнее
map.get(id, key) V Значение по ключу или na
map.contains(id, key) bool Есть ли ключ
map.remove(id, key) V Удаляет ключ, возвращает значение
map.clear(id), map.size(id) —, int Очистить; число пар
map.keys(id), map.values(id) array<K>, array<V> Ключи и значения массивом
map.copy(id) map<K, V> Копия
matrix — матрицы
Функция Возвращает Что делает
matrix.new<T>(rows = 0, columns = 0, initial = na) matrix<T> Матрица заданного размера
matrix.get(id, row, column), matrix.set(id, row, column, value) T, — Чтение и запись элемента
matrix.rows(id), matrix.columns(id) int Размеры
matrix.add_row(id, row = na, values = na), matrix.add_col(id, column = na, values = na) — Добавляет строку или столбец; без номера — в конец
matrix.remove_row(id, row = na), matrix.remove_col(id, column = na) array<T> Удаляет строку или столбец и возвращает его
matrix.row(id, row), matrix.col(id, column) array<T> Строка или столбец массивом
matrix.fill(id, value, from_row = 0, to_row = na, from_column = 0, to_column = na) — Заполняет область
matrix.copy(id), matrix.transpose(id) matrix<T> Копия и транспонирование
matrix.mult(id1, id2), matrix.sum(id1, id2), matrix.diff(id1, id2) matrix<float> Произведение, сумма, разность двух матриц
matrix.det(id), matrix.trace(id) float Определитель и след
matrix.inv(id) matrix<float> Обратная матрица
matrix.is_square(id) bool Матрица квадратная

Пределы: массив — 100 000 элементов, словарь — 50 000 пар, матрица — 1 000 000 элементов.

request.security — другой таймфрейм и инструмент

Функция Возвращает Что делает
request.security(symbol, timeframe, expression, gaps = false, lookahead = false, ignore_invalid_symbol = false) float Считает expression на другом таймфрейме или инструменте и возвращает результат на барах графика
Loot
htfEma = request.security(sym.ticker, "60", ta.ema(close, 20))
  • symbol — "ПЛОЩАДКА:СИМВОЛ" или sym.ticker, timeframe — строка вида "5", "60", "4h", "1D", "1W".
  • Незакрытый бар старшего таймфрейма меняется до своего закрытия — берите expression[1], если нужна неизменная история.
  • lookahead = true заглядывает в будущее на истории; компилятор предупреждает об этом.
  • Внутри expression нельзя читать order book и time and sales и переменные графика — только входы и сами ряды.
  • Предел — 8 разных пар «инструмент + таймфрейм» и 32 вызова на скрипт.

Примеры — в разделе Другой таймфрейм и другой инструмент.

Алерты и журнал

Функция Что делает
alert(message, freq = alert.freq_once_per_bar_close) Отправляет ալերտ с текстом. Работает только вживую, на истории молчит
alertcondition(condition, title, message = na) Объявляет условие, на которое пользователь сам ставит ալерт в терминале. Срабатывает по закрытию бара
log.info(message), log.warning(message), log.error(message) Пишет строку во вкладку «Մատյան» редактора. На истории молчит

Частота alert: alert.freq_all — на каждом проходе, alert.freq_once_per_bar — раз за бар при первом срабатывании, alert.freq_once_per_bar_close — раз за бар на закрытии. Подробнее — Алерты из скриптов.

strategy — стратегии

Работает только в скрипте, объявленном через strategy(...). Заявки исполняет эмулятор тестера по истории — на бирже они не выставляются. Как устроен тестер, рассказано в Стратегии и тестер.

Заявки

Функция Что делает
strategy.entry(id, direction, qty = na, limit = na, stop = na, oca_name = na, oca_type = strategy.oca.none, comment = na, when = true) Вход в strategy.long или strategy.short. Учитывает модель позиции и pyramiding; вход против позиции разворачивает её
strategy.order(id, direction, qty = na, limit = na, stop = na, oca_name = na, oca_type = strategy.oca.none, comment = na, when = true) Заявка в обход правил входа: не учитывает модель позиции и pyramiding
strategy.exit(id, from_entry = na, qty = na, qty_percent = na, profit = na, limit = na, loss = na, stop = na, trail_price = na, trail_points = na, trail_offset = na, oca_name = na, comment = na, when = true) Выход по тейку, стопу или трейлингу. profit, loss, trail_points — в шагах цены, limit, stop, trail_price — ценой
strategy.close(id, comment = na, qty = na, qty_percent = na, when = true) Закрывает позицию входа id по рынку
strategy.close_all(comment = na, when = true) Закрывает всё
strategy.cancel(id, when = true), strategy.cancel_all(when = true) Отменяет неисполненные заявки

Если qty не задан, размер берётся из defaultQtyType и defaultQtyValue объявления. Группы OCA: strategy.oca.none, strategy.oca.cancel, strategy.oca.reduce.

Состояние

Имя Тип Что содержит
strategy.position_size float Размер позиции: плюс — լոնг, минус — շորտ
strategy.position_avg_price float Средняя цена входа
strategy.position_entry_name string Имя входа, открывшего позицию
strategy.openprofit, strategy.netprofit float Нереализованный и реализованный результат
strategy.grossprofit, strategy.grossloss float Сумма прибылей и сумма убытков
strategy.equity, strategy.initial_capital float Текущий и стартовый капитал
strategy.max_drawdown, strategy.max_runup float Наибольшая просадка и наибольший рост
strategy.wintrades, strategy.losstrades, strategy.eventrades int Сделки в плюс, в минус, в ноль
strategy.opentrades, strategy.closedtrades int Открытые и закрытые сделки
strategy.margin_liquidation_price float Цена լիկվիդացիայի при заданной մարժա
strategy.funding_paid float funding rate, уплаченный и полученный
Поля сделок и константы

Поля открытой сделки по индексу i — strategy.opentrades.<поле>(i), закрытой — strategy.closedtrades.<поле>(i):

Поле Тип Что содержит
entry_price, entry_bar_index, entry_time, entry_id float, int, int, string Цена, бар, время и имя входа
size float Размер сделки
profit, max_runup, max_drawdown float Результат, лучший и худший момент сделки
commission, funding float Комиссия и funding rate по сделке
exit_price, exit_bar_index, exit_time, exit_id, exit_reason float, int, int, string, int Только у закрытых: цена, бар, время, имя и причина выхода

Причины выхода: strategy.exit_reason.stop_loss, take_profit, trailing_stop, market_order, reverse, oca, liquidation, end_of_data. Причину oca эта версия не возвращает.

Константы объявления: strategy.long, strategy.short, strategy.model.netting, strategy.model.hedging, strategy.qty.fixed, strategy.qty.cash, strategy.qty.percent_of_equity, strategy.qty.risk_percent, strategy.commission.percent, strategy.commission.cash_per_contract, strategy.commission.cash_per_order, strategy.fill.conservative, strategy.fill.optimistic.

Данные ордерфлоу

Эти пространства — то, чего нет в обычных языках индикаторов: footprint cluster-ներ, delta, open interest, funding rate, история order book и живые данные. Если данных для бара нет, значение — na, а не ноль. Откуда берутся данные и как проверять их наличие, рассказано в Данные рынка: кластерներ, delta, open interest, funding rate, история order book, живой order book и time and sales, screener.

История: есть на каждом баре

Пространство Имена
cluster — кластеры бара available (данные загружены), levels (число уровней), total (объём бара), delta, poc и poc_index (цена и номер уровня с наибольшим объёмом), max_cell (объём самой крупной ячейки), grid_step (шаг цены), stacked_buy / stacked_sell (цена начала серии дисбалансов), stacked_buy_steps / stacked_sell_steps (длина серии в уровнях)
cluster — функции cluster.price(index), cluster.bid(index), cluster.ask(index) — цена и объёмы уровня, счёт снизу; cluster.imbalance(index) → int: 1 — перевес покупок, −1 — продаж, 0 — нет; cluster.value_area(coverage) → [low, high] — зона стоимости с долей объёма coverage
delta — дельта бара available, value (покупки минус продажи), buy, sell, cum (накопленная), min / max (экстремумы внутри бара), open / high / low / close (дельта как свеча), trades (число сделок), usd (в котируемой валюте)
oi — open interest available, open, high, low, close, usd, coins, change (изменение к прошлому бару)
funding — funding rate available, rate (прогноз ставки), interval_hours (int, часы между расчётами), settled (на баре был расчёт), settled_rate (применённая ставка), cum (накопленная)
depth — история order book available, levels, grid_step, best_bid, best_ask, max_cell; depth.price(index), depth.qty(index), depth.side(index) (1 — բիդ, −1 —​អասկ); depth.at(price); depth.bid_sum(percent), depth.ask_sum(percent), depth.imbalance(percent) — в полосе percent % от середины; depth.max_bid(percent), depth.max_ask(percent) → [price, qty]

Только вживую: на истории всегда na

Пространство Имена
book — order book available, spread, mid; book.bid(index), book.ask(index) — цены уровней от лучшей; book.bid_qty(index), book.ask_qty(index) — объёмы; book.imbalance(depth) — перекос по depth уровням, −1…1
tape — time and sales available, last_price, last_qty, last_side (1 — покупатель, −1 — продавец); tape.count(window_ms) → int, tape.buy_volume(window_ms), tape.sell_volume(window_ms), tape.max_print(window_ms) — за последние window_ms миллисекунд
screener — метрики screener available; screener.natr(window), screener.rvol(window), screener.avg_vol(window), screener.btc_corr(window), screener.change(window), screener.oi_delta(window), screener.vol(window)

Окна screener — строки: natr — "1m", "5m"; rvol — "1h", "24h"; avg_vol — "1m", "5m", "15m", "1h"; btc_corr — "1m", "5m"; change и oi_delta — "1m", "5m", "1h", "24h", у change ещё "15m"; vol — "1m", "5m", "15m", "1h", "24h". Окно, которого нет в списке, даёт na.

Дальше

https://docs.lootx.trade/hy/loot/reference

Основы

3Առաջին սկրիպտը

Քայլ առ քայլ՝ ինչպես բացել LootScript խմբագրիչը, գրել երկու տողից բաղկացած ինդիկատոր, ավելացնել այն գրաֆիկին, կարդալ սխալները և գտնել սկրիպտի ֆայլը։ Երկրորդ օրինակը՝ կարգավորումներով ալիք։

Այս էջում դուք կանցնեք դատարկ խմբագրիչից մինչ ձեր ինդիկատորը գրաֆիկի վրա. կգրեք երկու տողից բաղկացած սկրիպտ, կտեսնեք, թե խմբագրիչն ինչպես է որսում սխալները, կիմանաք, թե որտեղ է գտնվում ֆայլը, և կավելացնեք կարգավորումների պատուհան։ Պետք կգա բաց գրաֆիկ և միացված սկրիպտներ — եթե դրանք ինդիկատորների պատուհանում չկան, կարդացեք Ինչպես միացնել սկրիպտները բաժինը։

Բացեք խմբագրիչը

Բացեք ինդիկատորների պատուհանը

Գրաֆիկի վահանակի վրա սեղմեք ƒ կոճակը, որի հուշումն է «Ինդիկատորներ»։

Գործարկեք խմբագրիչը

Սեղմեք Խմբագրիչ… որոնման դաշտի կողքին կամ Նոր սկրիպտ պատուհանի ներքևում։ Արդեն գոյություն ունեցող սկրիպտ բացելու համար գտեք այն Իմ սկրիպտները բաժնում և սեղմեք նրա տողում գտնվող Խմբագրել սկրիպտը մատիտը (կամ ընտրեք տողը և սեղմեք Ctrl+E)։

Գտեք անհրաժեշտ կոճակները

Խմբագրիչը բացվում է առանձին պատուհանով՝ իր կոճակով առաջադրանքների տողում. այն կարելի է տեղափոխել երկրորդ մոնիտոր։ Վերևում՝ սկրիպտների բացվող ցուցակը և Նոր, Պահպանել և Ավելացնել գրաֆիկին կոճակները, ներքևում՝ Խնդիրներ, Մատյան և Արդյունք ներդիրները։

Խմբագրիչը կհիշի այն վահանակը, որի ինդիկատորների պատուհանից այն բացվել է՝ այնտեղ էլ կավելացնի սկրիպտը։ Եթե խմբագրիչն այլ կերպ է բացվել, սկրիպտը կհայտնվի գրաֆիկի ակտիվ վահանակի վրա։

Գրեք ինդիկատոր

Նոր կոճակը (Ctrl+N) ստեղծում է սկրիպտ ձևանմուշից՝ մեկ կարգավորմամբ շարժվող միջին.

Loot
indicator("Без названия", overlay = true)

length = input.int(20, "Length", minval = 1)
plot(ta.ema(close, length), "EMA", color = color.orange)

Տեքստը փոխարինեք ամենակարճ աշխատող ինդիկատորով՝ 20 բարի պարզ միջինով.

Loot
indicator("Мой первый индикатор", overlay = true)

plot(ta.sma(close, 20), "Средняя 20", color = color.orange)

Ահա թե ինչ է գրված այստեղ.

  • indicator(...) — հայտարարություն, ցանկացած սկրիպտի պարտադիր առաջին տողը։ Անունը կհայտնվի Իմ скрипտները ցուցակում և գրաֆիկի լեգենդում։ overlay = true նկարում է մոմերի վրա; overlay = false դեպքում ինդիկատորը կստանա առանձին վահանակ գրաֆիկի տակ։
  • ta.sma(close, 20) — վերջին 20 բարի փակման գների միջինը։
  • plot(...) — գիծ է նկարում՝ մեկ արժեք յուրաքանչյուր բարի համար։ Երկրորդ արգումենտը գծի անունն է կարգավորումներում, color-ը՝ գույնը։

Սկրիպտը կատարվում է յուրաքանչյուր բարի համար հերթով՝ ամենահինից մինչև ընթացիկը։ Առաջին 19 բարերին միջինի համար պատմություն չի բավականացնում, ուստի գիծը սկսվում է ոչ ձախ եզրից. դա նորմալ է։ Քանի բար է ծախսվում այդպիսի «տաքացման» վրա՝ խմբագրիչը գրում է pane-ի վերնամասում կամ ներքևի կարգավիճակի տողում։

Մուտքագրման ընթացքում խմբագրիչն առաջարկում է ֆունկցիաների և հաստատունների անուններ, բացվող փակագծից հետո ցույց է տալիս ֆունկցիայի պարամետրերը, իսկ անունի վրա սավառնելիս՝ դրա նկարագրությունը։ Հուշումների ցուցակը կարելի է ձեռքով կանչել Ctrl+Space համադրությամբ։

Պահպանեք և ավելացրեք գրաֆիկին

  • Պահպանել (Ctrl+S) գրանցում է սկրիպտը սկրիպտների թղթապանակում։ Իսկ մինչև չպահված փոփոխություններ կմնան՝ պատուհանի վերնագրում ֆայլի անվան դիմաց կտեղադրվի կետ •։
  • Ավելացնել գրաֆիկին (Ctrl+Enter) ստուգում է սկրիպտը, պահպանում այն և տեղադրում գրաֆիկի վահանակի վրա։ Խմբագրիչի վահանակում կհայտնվի գրություն՝ «Мой первый индикатор» добавлен на график։

Պատրաստ է. գիծը գրաֆիկի վրա է, ինդիկատորի անունը՝ լեգենդում։ Ինդիկատորը պահպանվում է դասավորության մեջ և կվերադառնա տերմինալի վերագործարկումից հետո։

Ինչպես է խմբագրիչը ցույց տալիս սխալները

Սկրիպտը ստուգվում է ինքնաբերաբար՝ տպելը դադարեցնելուց մի ակնթարթ անց։ Արդյունքը երևում է խմբագրիչի pane-ի վերնամասում՝ компиляция…, այնուհետև ok · 12 ms կամ, եթե ինչ-որ բան այն չէ, սխալներ՝ 1 կամ զգուշացումներ՝ 1։

Փորձեք սխալվել՝ գրեք ta.smaa՝ ta.sma-ի փոխարեն։ Սխալի տեղը ալիքաձև գծով կընդգծվի, վերնամասի հաշվիչը ցույց կտա սխալներ՝ 1, իսկ Խնդիրներ ներդիրում կհայտնվի սխալի կոդով, բացատրությամբ և դիրքով տող։

TEXT
LS2002  Неизвестное имя «ta.smaa» — проверьте написание или объявите его выше   Стр 3:6

Տողի վրա կրկնակի սեղմումը կտեղափոխի կուրսորը սխալի տեղը։ Յուրաքանչյուր սխալ ունի LS#### տեսքի մշտական կոդ, իսկ տեքստն անմիջապես հուշում է, թե ինչպես այն ուղղել։ Հաճախակի սխալների վերլուծությունը՝ Компиляции и выполнения — Ошибки էջում։

Սխալներով սկրիպտը գրաֆիկի վրա չի հայտնվի. Ավելացնել գրաֆիկին կպատասխանի «Սխալներով սկրիպտը գրաֆիկի վրա չի դրվում — տե՛ս «Խնդիրներ»» և կտեղափոխի կուրսորը առաջին սխալին։ Ինդիկատորների պատուհանում այդպիսի սկրիպտը նշվում է կարմիր պիտակով՝ սխալների քանակով Ս్కրիպտ պիտակի փոխարեն։

Կատարման ժամանակ նույնպես լինում են սխալներ՝ օրինակ՝ ցիկլ, որը չի տեղավորվում հատկացված ժամանակում։ Այդ դեպքում սկրիպտը կանգ է առնում, իսկ պատճառը երևում է Արդյունք ներդիրում՝ «Սկրիպտը կանգնեցված է: …»։ Մնացած ինդիկատորներն ու տերմինալը շարունակում են աշխատել։

Գրաֆիկի վրա արդեն գտնվող սկրիպտի խմբագրում

Քանի դեռ խմբագրում եք, գրաֆիկը շարունակում է ցույց տալ այն տարբերակը, որը դուք ավելացրել էիք։ Հենց որ խմբագրիչում հայտնվում է տոկուն, սխալազերծ տարբերակ, տարբերվող գրաֆիկից, տեղի է ունենում երկու բան.

  • Խմբագրչի վահանակում կհայտնվի Թարմացնել ինդիկատորը կոճակը;
  • Գրաֆիկի լեգենդում կհայտնվի թարմացման պատկերակ։

Դրանցից ցանկացածը պահպանում է սկրիպտը և փոխարինում այն բոլոր վահանակներում, որտեղ այն կա։ Ավելացնել գրաֆիկին արդեն որևէ տեղ ավելացված սկրիպտի համար անում է նույնը՝ թարմացնում է բոլոր պատճենները, այլ ոչ թե ավելացնում երկրորդ անգամ։ Քանի վահանակ կստանա նոր տարբերակը՝ ցույց է տալիս խմբագրիչի pane-ի վերնամասում գտնվող գրաֆիկներում: N պիտակը։

Որտեղ են գտնվում ֆայլերը

Windows-ում սկրիպտները պահվում են %APPDATA%\TradingTerminal\scripts\ թղթապանակում՝ յուրաքանչյուր սկրիպտի համար մեկ .loot ֆայլ։ Սա սովորական տեքստ է։ Այն կարելի է բացել ցանկացած խմբագրիչով, պատճենել, տեղադրել պահպանման պատճենում։ Թղթապանակը գտնվում է տեղադրման պանակից դուրս, ուստի տերմինալի թարմացումները նրան չեն վերաբերում։

Ֆայլի անունը ստացվում է առաջին պահպանման ժամանակ վերնագրից՝ բացատները փոխարինվում են ընդգծմամբ, ու կիրիլիցան պահպանվում է։ «Мой первый индикатор» կդառնա Мой_первый_индикатор.loot ֆայլ։

Երբ թղթապանակն առաջին անգամ է ստեղծվում, դրա մեջ դրվում են վեց մեկնարկային սկրիպտներ՝ Две скользящие, RSI с зонами, Импульс объёма, Кумулятивная delta, Open interest против цены և Фандинг годовых։ Դրանք տեղադրված են Իմ скрипտները բաժնում. հարմար է բացել և վերլուծել դրանք։

Երկրորդ օրինակ՝ կարգավորումների ալիք

Սկրիպտն ավելի օգտակար դարձնենք՝ ալիք՝ միջինից և երկու սահմաններից՝ մի քանի ստանդարտ շեղումների հեռավորության վրա։ Պարբերությունը, լայնությունը և գնի աղբյուրը դուրս կապենք կարգավորումների մեջ, իսկ վերին ու ստորին սահմանները կկարմրեն, երբ գինը դրանցից դուրս գա։

Loot
indicator("Канал вокруг средней", overlay = true)

length = input.int(20, "Период", minval = 2)
mult   = input.float(2.0, "Ширина в сигмах", minval = 0.1, step = 0.1)
src    = input.source(close, "Источник")

basis = ta.sma(src, length)
dev   = mult * ta.stdev(src, length)
upper = basis + dev
lower = basis - dev

plot(basis, "Середина", color = color.gray)
plot(upper, "Верх", color = close > upper ? color.red : color.teal)
plot(lower, "Низ", color = close < lower ? color.red : color.teal)

Ինչ նորություն կա.

  • Յուրաքանչյուր input.* կանչ դառնում է ինդիկատորի կարգավորումների պատուհանի տող՝ գրված հերթականությամբ։ minval-ը թույլ չի տա երկուսից փոքր պարբերություն մուտքագրել, իսկ step = 0.1 նշանակում է, որ լայնության դաշտը ցույց է տալիս մեկ տասնորդական տեղ։
  • input.source-ը վերածվում է տվյալ շարքերի բացվող ցուցակի՝ close, open, hl2, volume և այլն։
  • Սահմանների գույնը արտահայտություն է, ուստի այն հաշվվում է յուրաքանչյուր բարի համար առանձին։

Ավելացրեք սկրիպտը գրաֆիկին և կրկնակի սեղմեք լեգենդում նրա տողի վրա (կամ սեղմեք նրա կարգավորումների պատկերակը)։ Մուտքային տվյալներ ներդիրում կգտնեք ձեր երեք կարգավորումները՝ փոխեք պարբերությունը, և գծերը անմիջապես կվերահաշվարկվեն։ Արժեքները հիշվում են այս ինդիկատորի համար այս գրաֆիկի վրա։ По умолчанию կոճակը կվերադարձնի կոդում գրված արժեքները։ Ոճ ներդիրը կարգավորում է միջինի գույնն ու յուրաքանչյուր գծի հաստությունը, Տեսանելիություն ներդիրը՝ երեք գծերից յուրաքանչյուրն անհատապես թաքցնելու պատճենակալիչներն է։ Սահմանների գույնը կարգավորումներում չկա՝ այն ընտրում է հենց սկրիպտը յուրաքանչյուր բարի վրա։

Հաջորդը

https://docs.lootx.trade/hy/loot/first-script

Основы

4Սինտաքսիս և տիպերը

Ինչպես կառուցված է LootScript-ը՝ հաշվարկը ըստ բարերի, script-ի հայտարարում, հնգակողմ ձևեր վերագրելու, տիպեր և որակագրիչներ, na, x[n]‑ի պատմությունը, օպերատորներ, պայմաններ, switch, ցիկլեր, ֆունկցիաներ և սեփական տիպեր։

Այս էջը — լեզվի կարճ նկարագիրը. ինչպես կամ չափով հաշվարկվում է script‑ը բարերով, ինչպես հայտարարել փոփոխականներ, ինչպիսի տիպեր կան, ինչ է na, ինչպես կարդալ անցյալ բարերը, ինչպես գրել պայմաններ, ցիկլեր և ֆունկցիաներ։ Բոլոր օրինակները ամբողջական աշխատանքային script‑ներ են․ դրանք կարելի է քպել խմբագրում և ավելացնել գրաֆիկին.

Как выполняется скрипт

Բ ملف‑ի վերին մակարդակում գտնվող ամեն ինչ կատարվում է մի անգամ յուրաքանչյուր բարի համար — ամենադրանից հնագույնից մինչեւ ներկա, տող առ տող։ Ուստի LootScript‑ում փոփոխականը չպահպանում է մեկ թիվ, այլ ունի արժեք յուրաքանչյուր բարի համար, և կարելի է փորձել անցյալ արժեքներին։

Loot
indicator("Тело свечи")

body = close - open          // считается заново на каждом баре
plot(body, "Тело", style = plot.style_columns)

Ներկա, դեռ չփակված բարի վրա script‑ը վերագնահատվում է յուրաքանչյուր նոր tick‑ի հետ, սկսելով նույն состояния‑ից, որը գոյություն ուներ նախորդ բարի փակման պահին։ Փակված բարերը այդ դեպքում չեն վերագնահատվում։

Объявление

Script‑ի առաջին հրամանը — ճիշտ մեկ հայտարարություն՝ indicator(...), strategy(...) կամ library(...)։ Նրա վերևում կարող են լինել միայն մեկնաբանություններ և միայնակ #version 1 տողի ընտրովի գրությունը։ Եթե հայտարարություն չկա, script‑ը չի կոմպիլացվի և կտպի սխալ՝ «Нет объявления скрипта — начните с indicator(“Название”)»։

Loot
#version 1
// Комментарии и строка версии могут стоять выше объявления.
indicator("Размах бара", shortTitle = "Размах", overlay = false)

plot(high - low, "Размах", style = plot.style_histogram)

Ինդիկատորի գլխավոր պարամետրերը՝ title — անունը script‑ների ցանկում, shortTitle — կարճ անունը լեգենդայի համար, overlay — նկարել գնի վրայի՞ (true) թե առանձին վահանակում (false, ըստ էության)։ Ստրատեգիայի պարամետրերը նկարագրված են Стратегии и тестер էջում։

Переменные и присваивание

Форма Что делает
x = выражение Հայտարարում է փոփոխական։ Յուրաքանչյուր բարում այն հաշվվում է նորից։
x := выражение Վերագրում է արդեն հայտարարված փոփոխականի նոր արժեքը։ Տիպը պետք է հապատառվի։
var x = выражение Հայտարարում է փոփոխականը մեկ անգամ՝ առաջին բարում։ Արժեքը փոխանցվում է հաջորդ բարերին։
varip x = выражение Ինչպես var, բայց արժեքը պահպանվում է նաև ներկա բարի ներսում tick‑երի միջով։
[a, b, c] = функция(...) Բազմաթիվ վերադարձների դեպքում տեղավորում է արդյունքները փոփոխականների մեջ։

Կարճ ձևեր արդեն հայտարարված փոփոխականի փոփոխման համար՝ +=, -=, *=, /=, %=. Տիպը կարելի է նշեl բացահայտ՝ float level = 0։ Վстроенные շարքերի և տարածությունների անունները (close, volume, ta և այլն) զբաղված են — տո Ձեր փոփոխականը այդ անունով կոչել нельзя։

Գլխավոր տարբերությունը սովորական լեզուներից՝ սովորական փոփոխականը չի կուտակում արժեքը բարերի միջև։ Ընդհանրական հաշիչների և գումարների համար պահանջվում է var:

Loot
indicator("Счётчик зелёных свечей")

var greens = 0          // объявляется один раз и переживает переход к следующему бару
if close > open {
    greens += 1
}

today = 0               // а эта переменная равна 0 на каждом новом баре
today := today + 1      // поэтому здесь всегда 1

plot(greens, "Зелёных с начала истории")

varip‑ը հազվադեպ է պետք — օրինակ՝ բարում tick‑երը հաշելու համար։ Tick‑երի պատմություն չկա, այնպես որ նման արժեքը անցյալ բարերում կարող է տարբեր լինել այն արժեքից, որը եղել է կենդան ժամանակında։ Եթե varip արժեքը գծապատկերին արտասերվի, խմբագիրը կհուշի հնարավոր վերագր绘։

Типы

Тип Что хранит Пример
int ամբողջ թիվ 14, 1_000_000, 0xFF
float հորիզոնական թիվ 2.5, .5, 1e-9
bool ճշմարիտ կամ կեղծ true, false
string տեքստ "BTC", 'BTC'
color գույն թափանցիկությամբ #FF9800, #FF980080, color.teal

Կան նաև բաղադրյալ տիպեր՝ զանգվածներ array<float>, բառարաններ map<string, float>, մատրիցներ matrix<float>, ինչպես նաև ձեր սեփական տիպերը և enum‑ները (տես հետին՝), և գրաֆիկական օբյեկտներ line, box, label, table։

Հաճախ հայտնվող կանոնները՝

  • Տիպը ֆիքսվում է հայտարարման պահին. Եթե x = 1 եք գրել, ապա x := 2.5 գրել չեք կարող — x ամբողջ է։ Գրեք x = 1.0 կամ float x = 1։
  • Ամբողջը ինքնից չի դառնում բուծային, իսկ դառնալը՝ միայն ուղղակիորեն. Օգտագործեք math.round, math.floor, math.ceil, math.trunc։
  • Ամբողջների բաժանումը՝ ամբողջ է. 7 / 2 = 3. Սպասարկման համար մեկ թիվը դարձրեք բութ՝ 7.0 / 2։
  • Թեքում ^ միշտ տալիս է բութ թիվ. 2 ^ 3 = 8.0։
  • Տողը нельзя գումարել թվի հետ. "Цена: " + close չի կոմպիլացվի — օգտագործեք "Цена: " + str.tostring(close)։
  • Պայմանը միայն bool կարող է լինել. if volume { … } — սխալ, վերջացրեք if volume > 0 { … }։

Կвалификատորներ՝ որքան հաստատուն է արժեքը

Տիպից բացի յուրաքանչյուր արժեք ունի որակագրիչ՝ որքանով է այն փոփոխական թեր ժամանակի ընթացքում։ Սխալից դեպի ուժեղը՝

Квалификатор Когда известно значение Пример
const արդեն կոմպիլացիայի ընթացքում 14, "EMA"
input կարգավորումների ընթերցումից հետո, ավելի չի փոխվում input.int(14, "Период")
simple պրոցեսի մեկնարկի պահին, հետո չի փոխվում գործիքի արժեքի քայլը
series կարող է փոխվել յուրաքանչյուր բարի վրա close, bar_index

Նախնական կիրառման մեջ կարևոր է մեկ տեղ՝ ta.* ֆունկցիաների հաշվարկային տևողությունները պետք է լինեն հաստատուն — լիտերալ կամ input։ Ոչ այդպիսկ՝ ֆունկցիաները ստիպված կլինեին վերակառուցել իրենց վիճակը յուրաքանչյուր բարի վրա։

Loot
indicator("Период из настроек")

len = input.int(14, "Период", minval = 2)
plot(ta.rsi(close, len), "RSI")

// ta.rsi(close, bar_index) не скомпилируется:
// «length» в «ta.rsi» требует значение не слабее input, а передано series

na — չկա արժեք

na նշանակում է «արժեք չկա»՝ ոչ բավական հին պատմություն հաշվարկի համար, բորսան չի վերադարձնում ցուցանիշը, տվյալներում բաց է։ na կարող է լինել ցանկացած տիպում։

  • Арифметика с na дает na: na + 1 → na.
  • Любое сравнение с na ложно, այնպես որ if x > 0 при x = na չի կատարվի։
  • Միակապես բացակայությունը ստուգեք na(x)-ով. Գրությունը x == na կոմպիլյատորը մերժում է սխալով՝ «Сравнение с na всегда ложно — используйте na(x)»։
  • nz(x) վերադարձնում է 0‑ը na‑ի փոխարեն, nz(x, v) վերաճում է v։ Հարմար կարճ ձևը՝ x ?? v.
  • Ցանկացած na գծապատկերին կդիմացնի գծի կտրուկ դադար, ոչ զրո։
Loot
indicator("Средняя без пустого начала", overlay = true)

avg = ta.sma(close, 50)             // на первых 49 барах — na

line1 = na(avg) ? close : avg       // проверка через na(x)
line2 = avg ?? close                // то же короче

plot(line2, "Средняя или цена", color = color.orange)

История: x[n]

x[n] — արժեքը x‑ի այն բարի վրա, որը եղել է n բարեր առաջ; x[0] — ներկա բարը։ Աշխատում է ցանկացած շարքի հետ, այդ թվում ձեր փոփոխականների։

Loot
indicator("Наклон средней")

ma    = ta.ema(close, 20)
slope = ma - ma[1]                  // изменение за один бар

plot(slope, "Наклон", style = plot.style_histogram,
     color = slope >= 0 ? color.teal : color.red)
  • Եթե n‑ը մեծ է պատմության սկզբից մինչեւ ընթացիկ բարի քանակից, արդյունքը na է, ոչ սխալ։
  • n կարող է փոխվել բարից բար. close[len] при переменном len թույլատված է։
  • Սխալ է օգտագործել բացասական ինդեքս՝ անցնել ապագա բարերը։
  • Պատմության խորությունը կարգավորելու կարիք չկա․ script‑ին հասանելի է ամբողջ պատմությունը, որը լեցված է գրաֆիկում։

Операторы

Տարանջատման կարգը՝ բարձրից դեպի ցածր․

Приоритет Операторы
1 x[n], вызов f(…), доступ через точку a.b
2 ^ — степень, вычисляется справа налево
3 унарные -, +, not
4 *, /, %
5 +, -
6 <, >, <=, >=
7 ==, !=
8 and
9 or
10 ?? — замена na
11 ? : — условное выражение
  • Сравнения не сцепляются: вместо a < b < c գրեք a < b and b < c.
  • and և or אינם հաշվարկում աջ կողմը, եթե լուծումը արդեն հայտնի է ձախից։
  • Դասավորություն՝ степень ավելի բարձր է унарного минуса से։ -2 ^ 2 = -4. Եթե պետք է 4՝ գրեք (-2) ^ 2։
  • Բութ թվեր համեմատեք թույլատրելիությամբ՝ math.approx(a, b), որովհետև 0.1 + 0.2 == 0.3 կարող է կեղծ լինել։

Պայմաններ

Բլոկները միշտ ուղված են ծալքավոր բրակետներով {}։ if կարող է լինել և՛ հրահանգ, և՛ արտահայտություն; երկուսի դեպքում արագ ընտրությունն անում է ? :։

Loot
indicator("Направление бара")

dir = 0
if close > open {
    dir := 1
} else if close < open {
    dir := -1
}

// if как выражение: обе ветки обязательны
bodySize = if close >= open { close - open } else { open - close }

// условный оператор для простых случаев
barColor = dir > 0 ? color.teal : color.red

plot(bodySize, "Тело", style = plot.style_columns, color = barColor)

switch

switch‑ը ընտրում է առաջին համընկնող շերտը։ Օբյեկտով ձևը համեմատում է այն շերտերի արժեքների հետ, առանց օբյեկտի ձևը հերթով ստուգում է պայմանները։ => առանց պայմանի — ստանդարտ (default) ճյուղն է։ Ցածրացման (fallthrough) механիզմ չկա. Եթե switch արժեք է վերադարձնում՝ default ճյուղը պարտադիր է։

Loot
indicator("Средняя на выбор", overlay = true)

kind = input.string("EMA", "Тип средней", options = ["EMA", "SMA", "WMA"])

ma = switch kind {
    "EMA" => ta.ema(close, 20)
    "SMA" => ta.sma(close, 20)
    =>       ta.wma(close, 20)
}

zone = switch {
    close > ma * 1.02 => 1
    close < ma * 0.98 => -1
    =>                   0
}

plot(ma, "Средняя", color = zone == 1 ? color.teal : zone == -1 ? color.red : color.gray)

Циклы

for i in a .. b անցնում է թվերի միջոցով՝ սկսելով {a}‑ից ներառյալ մինչև {b} անընդմեջ չմասնակցելով։ Քայլը задаётся словом by, կարող է լինել բացասական։ Ցիկլի փոփոխականը գոյություն ունի միայն ցիկլի ներսում և չի փոփոխվում մարմնում։

Loot
indicator("Зелёные свечи за N баров")

n = input.int(10, "Сколько баров", minval = 1, maxval = 200)

greens = 0
for i in 0 .. n {               // i = 0, 1, …, n − 1
    if close[i] > open[i] {
        greens += 1
    }
}

plot(greens, "Зелёных", style = plot.style_columns)
Loot
indicator("Виды циклов")

total = 0
for i in 0 .. 10 by 2 {         // 0, 2, 4, 6, 8
    total += i
}
for i in 10 .. 0 by -1 {        // 10, 9, …, 1
    if i % 3 == 0 {
        continue                // сразу к следующему шагу
    }
    total += i
}

var closes = array.new<float>(0)
closes.push(close)
if closes.size() > 20 {
    closes.shift()
}
sum = 0.0
for v in closes {               // по элементам массива; for [i, v] in … — с индексом
    sum += v
}

k = 0
while k < 100 {
    k += 7
    if k > 50 {
        break                   // выход из цикла
    }
}

plot(sum / closes.size(), "Средняя из массива")

Անվերջ ցիկլը սրա համար հանգեցուցիչ չի լինի, տերմինալը չի կախվի՝ script‑ին հատկացված է օպերացիաների բյուջե յուրաքանչյուր բարի համար և ժամանակի սահմանակ։ Դրանք հն تجاوزելու դեպքում script‑ը կանգ կտա և ցույց կտա հաղորդագրություն՝ «Скрипт исчерпал бюджет операций на бар — упростите цикл» կամ «Скрипт превысил лимит времени на проход»։

Функции

Ֆունկցիան հայտարարում են func‑ով։ Կարճ ձեւը՝ արտահայտություն =>‑ից հետո, երկար ձեւը՝ մարմինով {} և return‑ով։ Փարամետրերի տիպերը կարելի է չնշել — դրանք ինքնաբերաբար ենթադրվում են կանչերից; պարամետրերը կարող են ունենալ նախնական արժեքներ։ Պարգևները փոխանցվում են ըստ կարգի կամ ըստ անունի։

Loot
indicator("Z-оценка объёма")

func barRange(h, l) => h - l

func zscore(series float src, input int len) => float {
    m = ta.sma(src, len)
    s = ta.stdev(src, len)
    return s == 0 ? na : (src - m) / s
}

func scaled(x, k = 2.0) => x * k

z = zscore(volume, 50)
plot(z, "Z объёма", style = plot.style_columns, color = z > 2 ? color.orange : color.gray)
plot(scaled(barRange(high, low), k = 0.5), "Полразмаха")
  • Ռեկուրսիա չկա. Ֆունկցիան չի կարող կանչել ինքն իրեն, ուղղակի կամ միջանկյալ միջոցով։ Վերադարձից կրկնությունը սրվում է ցիկլով։
  • Վիճակը յուրաքանչյուր կանչի համար առանձին է. Եթե ֆունկցիայի մեջ կան ta.* կամ var, երկու կանչերը նույն ֆունկցիայի տարբեր անկախ հաշվարկներ կիրականացնեն։
Loot
indicator("Два вызова одной функции", overlay = true)

func smooth(src, len) => ta.ema(src, len)

fast = smooth(close, 10)        // своя средняя
slow = smooth(close, 30)        // другая, независимая средняя

plot(fast, "Быстрая", color = color.teal)
plot(slow, "Медленная", color = color.orange)

Նույն ֆունկցիաները, որոնց պետք է մի քանի script‑երում, կարելի է տեղափոխել գրադարան՝ հայտարարությամբ library("Имя", 1), ֆունկցիաների առաջ տեղադրել export, այլ script‑ում օգտագործել import Имя/1 as имя։ Գրադարանն առնվում է ձեր script‑ների فولդերից։

Несколько результатов

Որոշ ֆունկցիաներ վերադարձնում են միանգամից մի քանի շարքեր՝ ta.bb, ta.macd, ta.kc, ta.dmi, ta.supertrend և այլն։ Արդյունքը բաշխվում է փակագծերով ցուցադրված փոփոխականների մեջ; անունների թիվը պետք է համընկնի վերադարձվող արդյունքների թվի հետ։

Loot
indicator("Полосы Боллинджера", overlay = true)

[basis, upper, lower] = ta.bb(close, 20, 2.0)

plot(basis, "Середина", color = color.gray)
plot(upper, "Верх", color = color.teal)
plot(lower, "Низ", color = color.teal)

Свои типы и перечисления

type‑ը հավաքում է մի քանի դաշտ մեկ կառուցվածքի մեջ։ Օբյեկտը ստեղծվում է Имя.new(...) միջոցով, դաշտերը ընթերցվում և վերագրվում են կետով։

Loot
indicator("Последний локальный максимум", overlay = true)

type Swing {
    int   barIndex
    float price
}

var Swing last = Swing.new(barIndex = 0, price = high)

ph = ta.pivothigh(high, 5, 5)
if not na(ph) {
    last.barIndex := bar_index - 5
    last.price := ph
}

plot(last.price, "Максимум", style = plot.style_stepline, color = color.orange)

enum — փակ տարբերակների ցուցակլեյբլներով։ Սխալներ տարբերակների անուններում ավելի լավ է դարձնել կոմպիլյացիոն սխալ, քան լռելյայն սխալով անցնել։ Միասինinput.enum`‑ի հետ enum‑ը կդառնա dropdown կարգավորումներում — տես Настройки и отрисовка։

Loot
indicator("Режим рынка")

enum Regime {
    trend = "Тренд"
    flat  = "Флэт"
}

regime = math.abs(close - close[20]) > ta.atr(14) * 3 ? Regime.trend : Regime.flat

plot(regime == Regime.trend ? 1 : 0, "Тренд", style = plot.style_stepline)

Функции ta.* внутри условий

Ֆունկցիաներ՝ ինչպիսիք են ta.ema, ta.rsi կամ ta.atr, հիշում են իրենց վիճակը նախորդ բարի մակարդակից։ Եթե այդպիսի կանչ կատարեր միայն որոշ բարերի վրա՝ օրինակ if‑ի ներսում կամ ? :-ի մի ճյուղում, հաշվարկը կսակավեցնի բարերը և կտա թերարժեքներ։

LootScript‑ը դա չէր թույլատրում՝ կոմպիլյատորը ինքն է դուրս բերում յուրաքանչյուր ta.* կանչը պայմաններից և կատարում այն յուրաքանչյուր բարի վրա, իսկ պայմանը միայն ընտրում է՝ օգտագործել արդյո՞ք արդյունքը։ Ուստի նման օրինակը ճիշտ կպատգամի RSI‑ը։

Loot
indicator("RSI только на зелёных барах")

r = close > open ? ta.rsi(close, 14) : na

plot(r, "RSI", style = plot.style_circles)

Կհեռացվի միայն այն դեպքում, եթե նրա սննխահարկի (argument) ինքնը ծնվում է ճյուղի ներսում։ Այդ դեպքում կոմպիլյատորը չի կարող կանխատեսել և կտա սխալ՝ «Аргумент «len» нельзя вычислить вне ветки — вынесите вызов ta.* на верхний уровень». Իրականացումը՝ հաշվարկել արգումենտը նախ պայմանից դուրս։

Loot
indicator("Аргумент до условия")

// Так нельзя — len объявлена внутри ветки:
// if close > open {
//     len = 10
//     e = ta.ema(close, len)
// }

len = 10
e = ta.ema(close, len)

plot(close > open ? e : na, "EMA на зелёных барах", style = plot.style_circles)

Комментарии и перенос строк

  • // — մեկնաբանություն մինչև տողի վերջը, /* … */ — բլոկային մեկնաբանություն, բլոկները կարելի է ներարկել։
  • Հրամանն ավարտվում է տողի վերջում, կետակի պարզապես չի պահանջվում։
  • Երկար արտահայտությունը շարունակվում է հաջորդ տողում, եթե տողը կտրվել է փակագծում, ավարտվում է օպերատորով կամ հաջորդ տողը սկսվում է օպերատորով, ? կամ :։
Loot
indicator("Перенос строк")

typical = high
        + low
        + close

signal = close > open
    ? typical / 3
    : na

plot(signal, "Типичная цена на зелёных барах", style = plot.style_circles)

Дальше

https://docs.lootx.trade/hy/loot/syntax

Основы

5Կարգավորումներ և արտապատկերում

input.* կարգավորումները ցուցիչի պատուհանում, plot գծերը և դրանց ոճերը, hline մակարդակները, fill լցոնումները, ֆոնը և մոմերի գույնը, մարկերները, ստորագրությունները, հատվածները, ուղղանկյունները, աղյուսակները, գույներն ու թափանցիկությունը։ Սահմանափակումներ՝ երեք պատկերվող plot և 500 օբյեկտ յուրաքանչյուր տեսակից։

Այս էջը վերաբերում է նրան, ինչ օգտատերը տեսնում է և կարող է փոխել։ Այստեղ նկարագրված են կարգավորումները, որոնք սկրիպտը տեղադրում է ցուցիչի պատուհանում, գծերը և դրանց ոճերը, մակարդակներն ու լցոնումները, ֆոնը և մոմերի գույնը, մարկերները, ստորագրությունները, հատվածները, ուղղանկյուններն ու աղյուսակները, ինչպես նաև գույներն ու թափանցիկությունը։ Վերջում կա բաժին սահմանափակումների մասին, որոնք արժե իմանալ նախապես։

Կարգավորումներ. input.*

Յուրաքանչյուր input.* կանչ դառնում է տող Մուտքային տվյալներ ներդիրում՝ ցուցիչի կարգավորումների պատուհանում։ Տողերը идут այն հերթականությամբ, որով կանչերը գրված են սկրիպտում։ Առաջին արգումենտը սահմանում է լռելյայն արժեքը, երկրորդը՝ տողի ստորագրությունը։

Կանչ Ինչ կհայտնվի կարգավորումների պատուհանում
input.int Դաշտ ամբողջ թվի համար
input.float Դաշտ կոտորակային թվի համար
input.bool Դրոշակ
input.color Գույնի ընտրություն
input.string Բացվող ցուցակ, եթե տրված է options; առանց դրա՝ տեքստային դաշտ
input.source Բացվող ցուցակ շարքերից՝ open, high, low, close, hl2, hlc3, ohlc4, hlcc4, volume
input.enum Բացվող ցուցակ՝ վերոհիշյալ վերաթվարկման ստորագրություններից
input.timeframe Տեքստային դաշտ; options-ի դեպքում՝ բացվող ցուցակ
input.symbol Տեքստային դաշտ

Ստորև բերված օրինակը մի սկրիպտում հավաքում է հինգ տեսակի կարգավորումներ.

Loot
indicator("Средняя на выбор", overlay = true)

enum Basis {
    sma = "Простая"
    ema = "Экспоненциальная"
    wma = "Взвешенная"
}

basis     = input.enum(Basis.ema, "Тип средней")
length    = input.int(50, "Период", minval = 1, maxval = 500)
src       = input.source(close, "Источник")
lineColor = input.color(color.orange, "Цвет линии")
showBg    = input.bool(false, "Подсвечивать фон")

avg = switch basis {
    Basis.sma => ta.sma(src, length)
    Basis.ema => ta.ema(src, length)
    =>           ta.wma(src, length)
}

plot(avg, "Средняя", color = lineColor, linewidth = 2)
bgcolor(showBg and close > avg ? color.new(color.teal, 40) : na, title = "Фон")

Կարգավորումների պատուհանում կստացվի «Тип средней» բացվող ցուցակ՝ կետերով «Простая», «Экспоненциальная» և «Взвешенная»։ Ներքևում կլինեն ժամանակաշրջանի դաշտը, աղբյուրների ցուցակը, գույնի ընտրությունը և դրոշակը։ Ինչպես հայտարարել վերաթվարկումներ, պատմված է բաժնում Սեփական տիպեր և վերաթվարկումներ.

Թվերի և տողերի պարամետրեր

  • minval-ը և maxval-ը սահմանում են սահմանները՝ դաշտը չի ընդունի ժամանակաշրջան minval-ից փոքր կամ maxval-ից մեծ։
  • step-ը input.float-ում սահմանում է, թե քանիս նիշ տասնորդականից հետո ցույց կտա դաշտը՝ step = 0.1 դեպքում տեսանելի է մեկ նիշ։ Դաշտում սլաքներ չկան, արժեքը մուտքագրվում է ստեղնաշարից։
  • options-ը input.string-ում և input.timeframe-ում դաշտը դարձնում է բացվող ցուցակ։ Լռելյայն արժեքը պարտադիր պետք է լինի կետերից մեկը, այլապես կոմպիլյատորը սխալ կտա։
  • tooltip, group և inline կոմպիլյատորն ընդունում է, բայց կարգավորումների պատուհանի տեսքի վրա նրանք առայժմ չեն ազդում։
Loot
indicator("Цена для расчёта")

mode  = input.string("Закрытие", "Считать по", options = ["Закрытие", "Середина свечи"])
price = mode == "Закрытие" ? close : hl2

plot(ta.rsi(price, 14), "RSI", color = color.purple)

input.source-ի լռելյայն արժեք կարող է լինել նաև շուկայական տվյալների շարք, օրինակ delta.cum-ը։ Այդպիսի շարքը ցուցակի առաջին կետը կդառնա՝ գների շարքերից առաջ։ Իսկ եթե լռելյայն արժեքը արտահայտություն է, ինչպիսին է (high + low) / 2, կարգավորումների պատուհանում տող չի լինի՝ ընտրելու բան չկա։

Ժամանակի, առևտրային սեսիայի և գրաֆիկի վրա կտտոցով ընտրվող գնի համար առանձին կարգավորումներ լեզվում դեռ չկան։

Որտեղ են պահվում ընտրված արժեքները

Արժեքները հիշվում են յուրաքանչյուր ցուցիչի համար յուրաքանչյուր գրաֆիկի վրա առանձին՝ նույն սկրիպտի երկու օրինակը տարբեր վահանակներում կարող է ունենալ տարբեր ժամանակաշրջաններ։ Լռելյայն կոճակը կարգավորումների պատուհանում վերադարձնում է կոդում գրված արժեքները։

Արժեքը կապված է այն փոփոխականի անվան հետ, որի մեջ գրված է input.* կանչը։ Տողի ստորագրությունը կարելի է ազատ փոփոխել, ընտրված արժեքը կպահպանվի։ Տողերը կարելի է նաև տեղափոխել։ Իսկ եթե փոփոխականը վերանվանեք (length-ը՝ period), կարգավորումը կվերադառնա կոդի արժեքին։

Կարգավորումների պատուհանը բացվում է գրաֆիկի լեգենդում ցուցիչի տողի վրա կրկնակի կտտոցով կամ այդ տողում գտնվող կարգավորումների պատկերակով։ Բացի Մուտքային տվյալներ ներդիրից, there are Ոճ և Տեսելիություն ներդիրները, որոնց մասին՝ ստորև։

Գծեր. plot

plot-ը նկարում է շարք՝ մեկ արժեք յուրաքանչյուր բարի համար։ Պարտադիր է միայն առաջին արգումենտը՝ հենց շարքը։ Մնացած պարամետրերը տրվում են անունով՝

  • title — գծի անունը լեգենդում և կարգավորումների պատուհանում;
  • color — գույն, հաստատուն կամ յուրաքանչյուր բարի վրա հաշվարկվող;
  • linewidth — հաստություն;
  • style — արտապատկերման եղանակ, տե՛ս աղյուսակը;
  • offset — տեղաշարժ տրված բարերի քանակով՝ դրականը աջ, բացասականը ձախ;
  • show_last — նկարել միայն վերջին N բարերը;
  • join = true — միացնել գծով circles և cross ոճերի կետերը;
  • editable = false — հեռացնել գիծը կարգավորումների պատուհանից;
  • display = display.none — թաքցնել գիծը ավելացնելիս; միացնել կարելի է Տեսանելիություն ներդիրում։
Ոճ Ինչպիսին է երևում
plot.style_line Բեկված գիծ, լռելյայն ոճ
plot.style_linebr Նույնը, ինչ line-ը
plot.style_stepline Աստիճաններ
plot.style_stepline_diamond Աստիճաններ՝ շեղանկյուններով
plot.style_histogram Բարակ սյուներ զրոյից՝ գծի հաստությամբ
plot.style_columns Սյուներ զրոյից՝ մոմի լայնությամբ
plot.style_area Տիրույթ՝ մինչև զրո ներկված
plot.style_areabr Նույնը, ինչ area-ն
plot.style_circles Կետեր
plot.style_cross Խաչիկներ

Գիծը միշտ ընդհատվում է այնտեղ, որտեղ շարքը արժեք չունի (na), և անցքը ուղիղ հատվածով չի անցկացվում։ Այդ պատճառով line/linebr և area/areabr զույգերը նկարվում են նույն ձևով։

Loot
indicator("Стили линий")

d = close - open

plot(d, "Тело свечи", style = plot.style_histogram, color = d >= 0 ? color.teal : color.red)
plot(ta.sma(d, 10), "Средняя 10", style = plot.style_stepline, color = color.orange, linewidth = 2)
plot(ta.sma(d, 30), "Средняя 30", style = plot.style_circles, color = color.gray)

Գույն ըստ բարերի

Գույնը կարող է արտահայտություն լինել. այդ դեպքում այն հաշվարկվում է յուրաքանչյուր բարի վրա նորից։ na գույնը նշանակում է, որ այդ բարի վրա գիծ չկա։

Loot
indicator("Средняя только над ценой", overlay = true)

m = ta.sma(close, 50)
plot(m, "Средняя", color = close > m ? color.teal : na)

Ինչ է ստանում գիծը կարգավորումների պատուհանում

  • Ոճ ներդիրում կարգավորվում է յուրաքանչյուր գծի հաստությունը։ Գույնի տողը հայտնվում է միայն հաստատուն գույն ունեցող գծի մոտ. եթե գույնը սկրիպտն է ընտրում յուրաքանչյուր բարի վրա, պատուհանում փոխելու բան չկա։
  • Տեսանելիություն ներդիրում յուրաքանչյուր գիծ ունի ցուցադրման դրոշակ։ Այն հայտնվում է, եթե գծերը մեկից ավելի են կամ եթե գիծը թաքցված է display-ի միջոցով։
  • editable = false ունեցող գիծը ոչ մի ներդիրում տող չի ստանում։

Մակարդակներ և լցոնումներ

hline-ը հորիզոնական գիծ է նկարում հաստատուն գնի վրա, օրինակ՝ RSI գոտիների սահմանները։ Գինը պետք է լինի թիվ կամ input.* կարգավորում. բարից բար փոփոխվող շարքը այստեղ չի տեղավորվում։ Այդպիսի գծի համար անհրաժեշտ է plot։ Գծի ոճը տրվում է hline.style_solid, hline.style_dashed և hline.style_dotted-ով։

fill-ը ներկում է տիրույթը երկու սահմանների միջև։ Սահման ստանալու համար hline-ի կամ plot-ի արդյունքը գրվում է փոփոխականի մեջ։

Loot
indicator("RSI с зонами")

length = input.int(14, "Период", minval = 1)
r = ta.rsi(close, length)

top    = hline(70, "Перекупленность", color = color.gray, linestyle = hline.style_dashed)
bottom = hline(30, "Перепроданность", color = color.gray, linestyle = hline.style_dashed)
fill(top, bottom, color = color.new(color.purple, 30), title = "Зона")

plot(r, "RSI", color = r > 70 ? color.red : r < 30 ? color.teal : color.purple)

Երկու սահմանները պետք է լինեն նույն տեսակի՝ երկու hline մակարդակ կամ երկու plot գիծ։ Գծի և մակարդակի միջև լցոնումը կոմպիլյատորը չի ընդունի։

Երկու գծերի միջև լցոնման գույնը կարող է փոփոխվել բարից բար։ Այսպես ստացվում է «ամպ» երկու միջիններից։

Loot
indicator("Облако", overlay = true)

fast = ta.ema(close, 9)
slow = ta.ema(close, 21)

pf = plot(fast, "Быстрая", color = color.teal)
ps = plot(slow, "Медленная", color = color.orange)
fill(pf, ps, color = fast > slow ? color.new(color.teal, 50) : color.new(color.red, 50), title = "Облако")

Կա նաև գրադիենտ լցոնում։ Տվեք top_value և bottom_value՝ նշելու բարձրությունները, որտեղ գույնը հավասար է top_color-ին և bottom_color-ին; դրանց之间 գույնը սահուն անցում է կատարում։ Այդ բարձրությունները պետք է լինեն հաստատուն թվեր։ Եթե անհրաժեշտ է լցոնում մինչև հաստատուն մակարդակ, այն դարձրեք գիծ՝ plot(50)։ Բայց հիշեք, որ սա երեք նկարվող գծերից մեկն է։

Loot
indicator("RSI с градиентом")

r  = ta.rsi(close, 14)
pr = plot(r, "RSI", color = color.purple)
pm = plot(50, "Середина", color = color.gray)
fill(pr, pm, top_value = 80, bottom_value = 50,
     top_color = color.new(color.teal, 160), bottom_color = color.new(color.teal, 0))

Ֆոն և մոմերի գույն

bgcolor-ը ներկում է ֆոնը բարի տակ, barcolor-ը վերաներկում է հենց մոմը։ Երկուսն էլ ընդունում են գույն, որը հաշվարկվում է յուրաքանչյուր բարի վրա; na գույնով բարերի վրա ոչինչ չի փոխվում։

Loot
indicator("Подсветка объёма", overlay = true)

avgVol = ta.sma(volume, 20)
spike  = volume > avgVol * 2

bgcolor(spike ? color.new(color.orange, 40) : na, title = "Всплеск объёма")
barcolor(close > open ? color.teal : color.red, title = "Цвет свечей")

Մարկերներ. plotshape և plotchar

plotshape-ը պատկերակ է դնում այն բարերի վրա, որտեղ kondisyon-ը ճիշտ է։ plotchar-ը նույնն է անում任意 նշանով։

Loot
indicator("Пересечения", overlay = true)

fast = ta.ema(close, 9)
slow = ta.ema(close, 21)

plotshape(ta.crossover(fast, slow), "Вверх", style = shape.triangleup,
          location = location.belowbar, color = color.teal, size = size.small)
plotshape(ta.crossunder(fast, slow), "Вниз", style = shape.triangledown,
          location = location.abovebar, color = color.red, size = size.small)
plotchar(volume > ta.sma(volume, 20) * 3, "Объём", char = "●", location = location.top, color = color.orange)
  • Ձևը, shape.*՝ triangleup, triangledown, arrowup, arrowdown, circle, square, diamond, cross, xcross, flag, labelup, labeldown:
  • Տեղը, location.*՝ abovebar — մոմից վերև, belowbar — մոմից ներքև, top և bottom — վահանակի վերին և ստորին եզրին։ Գրաֆիկի տակ առանձին վահանակում «մոմից վերև» և «մոմից ներքև» նույնպես նշանակում են վերին և ստորին եզրը. այդպիսի վահանակն ունի իր սանդղակը, և դրա վրա մոմերի գները չեն տեղադրված։
  • Չափը, size.*՝ auto, tiny, small, normal, large, huge:
  • text-ը պատկերակին ավելացնում է կարճ ստորագրություն։ Երբ գրաֆիկը խիստ հեռացված է, և մոմերը նեղ են, ստորագրությունները թաքնվում են, իսկ պատկերակները մնում են։

Գրաֆիկական օբյեկտներ

Բացի շարքերից, սկրիպտը կարող է նկարել առանձին օբյեկտներ՝ ստորագրություններ label.new, հատվածներ line.new, ուղղանկյուններ box.new և աղյուսակներ table.new։ Յուրաքանչյուր *.new կանչ վերադարձնում է օբյեկտ։ Այն կարելի է տեղափոխել set_* ֆունկցիաներով (label.set_xy, line.set_x2, box.set_top և այլն), կարդալ get_*-ով, պատճենել copy-ով կամ ջնջել delete-ով։

Հորիզոնական ուղղությամբ օբյեկտը լռելյայն կապված է բարի համարին՝ bar_index-ին։ xloc = xloc.bar_time պարամետրով կոորդինատը տրվում է բարի ժամանակով։ Հատվածին և ուղղանկյունին extend պարամետրը (extend.right, extend.left, extend.both) երկարացնում է եզրը մինչև գրաֆիկի սահմանը։

Օբյեկտը մնում է գրաֆիկի վրա, մինչև այն չջնջվի։ Սկրիպտը կատարվում է յուրաքանչյուր բարի վրա, ուստի label.new՝ առանց պայմանների, յուրաքանչյուր բարի համար ստորագրություն կստեղծի։ Մեկ օբյեկտ պահելու և այն տեղափոխելու համար պահեք այն var փոփոխականում, իսկ հինը ջնջեք։

Loot
indicator("Последний пивот", overlay = true, maxLabelsCount = 50)

ph = ta.pivothigh(high, 10, 10)

var line level = na
if not na(ph) {
    label.new(bar_index - 10, ph, str.tostring(ph), style = label.style_label_down,
              color = color.orange, textcolor = color.white, size = size.small)
    line.delete(level)
    level := line.new(bar_index - 10, ph, bar_index, ph, extend = extend.right,
                      color = color.orange, style = line.style_dashed)
}

Սկրիպտը ստորագրում է յուրաքանչյուր հայտնաբերված առավելագույնը և τελευτα από վերջինից աջ կետագիծ է ձգում։ Նախկին կետագիծն այն միաժամանակ ջնջում է։

Կենդանի օբյեկտների յուրաքանչյուր տեսակ միաժամանակ լինում է ոչ ավելի, քան 500։ Երբ հայտնվում է հինգ հարյուր առաջինը, ամենահինն անհետանում է։ maxLinesCount, maxLabelsCount և maxBoxesCount պարամետրերը indicator()-ում նվազեցնում են այդ սահմանը։ 500-ից մեծ արժեքը կրճատվում է մինչև 500։

Աղյուսակներ

Աղյուսակը կապված է ոչ թե բարերին, այլ վահանակի անկյունին կամ եզրին և գրաֆիկի ոլորման ժամանակ չի շարժվում։ Տեղը տրվում է position.*-ով՝ top_left, top_center, top_right, middle_left, middle_center, middle_right, bottom_left, bottom_center, bottom_right։ Բջիջները լցնում է table.cell։ Հարմար է դա անել միայն վերջին բարի վրա, որպեսզի աղյուսակը չվերագրվի ամբողջ պատմության ընթացքում։

Loot
indicator("Сводка", overlay = true)

var t = table.new(position.top_right, 2, 2, bgcolor = color.new(color.black, 160))
if barstate.islast {
    table.cell(t, 0, 0, "RSI", text_color = color.white)
    table.cell(t, 1, 0, str.tostring(math.round(ta.rsi(close, 14), 1)), text_color = color.white)
    table.cell(t, 0, 1, "ATR", text_color = color.white)
    table.cell(t, 1, 1, str.tostring(math.round(ta.atr(14), 2)), text_color = color.white)
}

Աղյուսակն ունի ոչ ավելի, քան 200 սյուն և 200 տող։ Աղյուսակը, որում 2000-ից ավելի բջիջ կա, չի ստեղծվում։

Գույներ

Անվանված գույներ՝ color.red, color.green, color.blue, color.teal, color.orange, color.purple, color.yellow, color.white, color.black, color.gray, color.silver, color.maroon, color.navy, color.olive, color.lime, color.aqua, color.fuchsia:

Գույնը կարելի է գրել նաև կոդով՝ #FF8800 — անթափանց, #FF880040 — թափանցիկությամբ։ Վերջին զույգ թվանշանները սահմանում են անթափանցիկությունը. 00 — լրիվ թափանցիկ, FF — համաձույլ։

  • color.rgb(r, g, b) հավաքում է գույնը 0-ից 255 բաղադրիչներից։ Չորրորդ արգումենտը անթափանցիկությունն է, լռելյայն՝ 255։
  • color.from_gradient(value, bottomValue, topValue, bottomColor, topColor)-ը վերադարձնում է գույն երկու ծայրագույնների միջև՝ ըստ value-ի դիրքի տիրույթում։ Հարմար է օսցիլյատորը սառը գույնից տաք գույնով ներկելու համար։
  • na-ն գույնի փոխարեն նշանակում է «չնկարել»։
Loot
indicator("RSI в цвете")

r = ta.rsi(close, 14)
heat = color.from_gradient(r, 30, 70, color.rgb(0, 150, 136), color.rgb(244, 67, 54))

plot(r, "RSI", color = heat, linewidth = 2)
bgcolor(r > 70 ? color.new(color.red, 30) : r < 30 ? color.new(color.teal, 30) : na, title = "Зоны")

Առաջ

https://docs.lootx.trade/hy/loot/inputs-drawing

Основы

6Շուկայի տվյալները՝ footprint cluster-ներ, delta, open interest, order book

LootScript-ով սկրիպտը մոմերից բացի կարդում է՝ footprint cluster-ներ, delta, open interest, funding rate, սերվերի գրանցած order book-ի պատմությունը, կենդանի order book և time and sales, screener-ի մետրիքները, այլ timeframe և այլ գործիք։

Բացի մոմերից՝ LootScript-ով սկրիպտը կարդում է պատվերի հոսքի տվյալներ՝ footprint cluster-ներ, delta, open interest, funding rate, սերվերի գրանցած order book-ի պատմությունը, կենդանի order book և time and sales, screener-ի մետրիքները։ Մի միավոր միացնել հարկավոր չէ: երբ սկրիպտը դիմում է, օրինակ, cluster.poc, տերմինալը ինքնաբերաբար բաժանորդագրվում է տվյալ գործիքի և գրաֆիկի timeframe-ի clusters-ին — նույնիսկ եթե գրաֆիկը ցույց է տալիս սովորական մոմեր։ Երբ սկրիպտը հանվում է գրաֆիկից, բաժանորդագրությունը ազատվում է։

Այս էջում բացատրված է՝ ինչ կա յուրաքանչյուր namespace-ում, որտեղից են գալիս տվյալները, ո՞ր բորսաներում դրանք հասանելի են և ինչպես վերցնել արժեքը այլ timeframe-ից կամ այլ գործիքից։

Հիմնական կանոնը՝ տվյալ չկա — դա na է, ոչ թե 0

Այս էջի ցանկացած արժեք կարող է լինել na. Դա լինում է, երբ բորսան չի ծածկված տվյալների սերվերով, timeframe-ը չի աջակցվում, պատմությունը դեռ բեռնում է կամ բարն ավելի հին է, քան հասանելի պատմությունը։ Զրոն կնշանակեր՝ «տրադերներ չկան», ինչը ուրիշ հանգամանք է. զրոյով լրացված կուտակված գումարը կարող է թվալ հավաստի, բայց սխալ լինել։

Յուրաքանչյուր տարածքի (namespace) համար կա առկայության ֆլագ — cluster.available, delta.available, oi.available և այլն։ Թեստավորեք այն կամ օգտագործե՛ք ֆունկցիան na(x). Կոմպիլյատորը չի թույլատրի համեմատություն == na-ի հետ։

Loot
indicator("Накопленная дельта без подмены нулём", overlay = false)
var float cvd = 0.0
if delta.available {
    cvd := cvd + delta.value
}
plot(delta.available ? cvd : na, "CVD", color = color.teal)

Ինչու տվյալներ չկան՝ ցույց է տալիս գրաֆիկի լեգենդը՝ սկրիպտի անունից մոտ՝ «բորսան չի ընդգրկվել», «timeframe-ը չի աջակցվում», «տվյալները բեռնում են…», «չկա բաց order book», «screener-ը մատչելի չէ»։

Ինչից են գալիս տվյալները

Пространство Что это История на графике
cluster.* Footprint cluster-ներ բարի վրա՝ ծավալը ըստ գնի մակարդակների Ունի, գալիս է cluster սերվերից
delta.* Delta՝ ագրեսիվ գնումների և վաճառքների տարբերությունը Ունի
oi.* Open interest Ունի
funding.* Funding rate և դրա հաշվարկները Ունի
depth.* Սերվերի գրանցած order book, քմածել՝ բարերով Ունի, սահմանափակ խորությամբ
book.* Կենդանի order book Միայն վերջին բար
tape.* Կենդանի time and sales (լենտա) Միայն վերջին բար
screener.* Screener-ի մետրիքները տվյալ գործիքի համար Միայն վերջին բար

Կլաստերներ: cluster.*

Բարի յուրաքանչյուր գինային մակարդակի ծավալը՝ բաժանված ագրեսիվ գնումների ու վաճառքների — նույն տվյալներն են, որոնք նկարում է footprint chart. Մարզերը (levels) թվագրված են ներքևից վեր՝ 0-ից մինչև cluster.levels - 1:

Անուն Ինչ է վերադարձնում
cluster.available Ցույց է տալիս՝ արդյոք կա cluster այս բարի համար
cluster.levels Բարի գինային մակարդակների քանակը
cluster.price(i) i մակարդակի գինը
cluster.bid(i) Ագրեսիվ գնումներ տվյալ մակարդակում (bid կողմից կատարված գործարքներ)
cluster.ask(i) Ագրեսիվ վաճառքներ տվյալ մակարդակում
cluster.total Բարի ամբողջ ծավալը
cluster.delta Գնումներ մինուս վաճառքներ բոլոր մակարդակների վրա
cluster.poc, cluster.poc_index Գինը և մակարդակի ինդեքսը, որտեղ ամենամեծ ծավալն է (POC)
cluster.max_cell Բարի ամենամեծ բջջի ծավալը
cluster.imbalance(i) Մակարդակի անհավասարակշռությունը՝ +1 գնում, -1 վաճառք, 0՝ ոչինչ
cluster.stacked_buy, cluster.stacked_sell Գինը, որտեղ սկսվում է ամենաերկար հաջորդականությունն անհավասարակշռության մակարդակներով
cluster.stacked_buy_steps, cluster.stacked_sell_steps Այդ շարքի երկարությունը մակարդակներով
cluster.value_area(pct) Value area-ի (արժեքի գոտու) ստորին և վերին սահմանները; pct — ծավալի մասնաբաժինը, 0.7 = 70 %
cluster.grid_step Բարի գրաֆիկի գների ցանցի քայլը

Ուշադրություն՝ cluster.bid(i) նշանակում է այն գնումները, որոնք «նվազեցնում են» ask-ի կողմը (агрессивно сняли аск), ոչ թե order book-ի մեջ գտնվող գնման հայտերը։

Կլաստերները հասանելի են timeframe-ներում՝ սկսած 30 վայրկյանից մինչև 1 օր։

Loot
indicator("POC и зона стоимости", overlay = true)
[vaLow, vaHigh] = cluster.value_area(0.7)
plot(cluster.poc, "POC", color = color.orange, style = plot.style_circles)
plot(vaHigh, "Верх зоны", color = color.gray, style = plot.style_linebr)
plot(vaLow, "Низ зоны", color = color.gray, style = plot.style_linebr)

Дельта: delta.*

Delta — ագրեսիվ գնումների և վաճառքների տարբերությունը մեկ բարում. Ծավալները հաշվարկվում են մոնետաներով (բազային արժույթով):

Անուն Ինչ է վերադարձնում
delta.value Բարի դելտա՝ գնումներ մինուս վաճառքներ
delta.buy, delta.sell Դրանց մասերը առանձinsky
delta.cum Կուտակված դելտա՝ բեռնված պատմության սկիզբից
delta.min, delta.max Դելտայի ընթացքի մինիմումը և մաքսիմումը բարի ներսում
delta.open, delta.high, delta.low, delta.close Դելտայի բար՝ որպես մոմ
delta.trades Գործարքների թիվը բարի մեջ
delta.usd Դելտա՝ քվոտայի արժույթի մեջ՝ ըստ գործարքների գումարների
delta.available Ցույց է տալիս՝ արդյոք կա դելտա այս բարի համար

delta.min և delta.max-ը հաշվարկվում են սերվերի կողմից՝ դրանք ցույց են տալիս դելտայի անցքը բարում. ըստ դրանց կարելի է տեսնել, թե գնողները бар-ն են վարել, իսկ վաճառողները փակել են այն։ delta.usd հաճախ ճշգրիտ է քան delta.value * close, քանի որ արագ բարի վրա գործարքների գինը կարող է շատ տարբեր լինել փակման գներից։

delta.cum սկսվում է զրոյից բեռնված պատմության առաջին բարի վրա, ուստի նրա մակարդակը կախված է բեռնման խորությունից։ Համեմատել պետք է փոփոխությունները, ոչ ամբողջական արժեքները։

Delta-ն հասանելի է timeframe-ներում, սկսած 30 վայրկյանից։

Loot
indicator("Дельта и разворот внутри бара", overlay = false)
d = delta.value
reversed = delta.available and d < 0 and delta.max > -d
plot(d, "Дельта", style = plot.style_columns, color = d >= 0 ? color.teal : color.red)
plotshape(reversed, "Разворот", style = shape.xcross, location = location.top, color = color.orange, size = size.tiny)

Open interest: oi.*

Անուն Ինչ է վերադարձնում
oi.open, oi.high, oi.low, oi.close Open interest բարի մեկավորներով, որոնք հրապարակում է բորսան
oi.coins Open interest մոնետաներով
oi.usd Open interest քվոտայի գումարով
oi.change oi.close-ի փոփոխությունը նախորդ բարի նկատմամբ
oi.available Ցույց է տալիս՝ արդյոք տվյալներ կան այս բարի համար

Բորսաներում oi.open…oi.close միավորը կարող է տարբեր լինել, այդ պատճառով բորսաներ համեմատելիս օգտագործեք oi.coins կամ oi.usd. Open interest գալիս է րոպեական ցանցով՝ դրա համար second timeframes-ում բոլոր արժեքները կլինեն na։

Loot
indicator("Цена и открытый интерес", overlay = false)
dp = ta.change(close)
build = oi.available and dp > 0 and oi.change > 0
plot(oi.change, "Изменение OI", style = plot.style_columns, color = build ? color.teal : color.gray)

Funding: funding.*

Անուն Ինչ է վերադարձնում
funding.rate Հաջորդ հաշշարկման կանխատեսված ставка-ն
funding.interval_hours Ժամերի քանակը հաշվարկների միջև
funding.settled true է բարի համար, երբ հաշշարկումը կատարվել է
funding.settled_rate Քանի է իրականում списано այն բարի համար; եթե մի բարի մեջ եղել է մի քանի հաշվարկ՝ դրանք գումարվում են
funding.cum Բեռնված պատմության ընթացքում հավաքված списанные ставки
funding.available Ցույց է տալիս՝ արդյոք այս ինստրում ունի funding rate

Ставка նշվում է որպես բաժին, ոչ տոկոս: օրինակ 0.0001 նշանակում է 0.01 %. Գրաֆիկը ցույց է տալիս տոկոսը, լեզուն ոչինչ չի վերածում։ Պայմանների ստուգման համար նախընտրելի է օգտագործել funding.settled_rate-ը, քանի որ funding.rate-ը կանխատեսում է և կարող է փոխվել մինչև հաշվարկը։ Սպոտում funding rate չկա, իսկ second timeframes-ներում արժեքները կլինեն na։

Loot
indicator("Фандинг за расчёт, %", overlay = false)
plot(funding.rate * 100, "Прогноз ставки", style = plot.style_area, color = funding.rate >= 0 ? color.teal : color.red)
plotshape(funding.settled, "Расчёт", style = shape.circle, location = location.bottom, color = color.orange, size = size.tiny)

История order book: depth.*

Order book՝ այն տեսքով, ինչպես այն գրանցել է սերվերը — նույն տվյալները, ինչ ցույց է տալիս ջերմաքարտեզը, տարանջատված բարերով։ Պատկերացնում է այն գոտիները (բասկետները), որոնցում գները խմբավորված են՝ և յուրաքանչյուր բասկետի ծավալը բարի ընթացքում։ Վերջին բջիջի ծավալը հաշվարկվում է մոնետաներով։

Անուն Ինչ է վերադարձնում
depth.available Ցույց է տալիս՝ արդյոք գրանցված order book կա այս բարի համար
depth.levels Բարի ոչ դատարկ բասկետների քանակը
depth.price(i) i բասկետի ստորին սահմանը՝ աճման կարգով
depth.qty(i) Բարում բասկետում դիտվող առավելագույն ծավալը
depth.side(i) +1 bid-եր, -1 ask-եր, 0՝ բասկետը եղել է երկկողմանի
depth.at(price) Ծավալը բասկետում, որտեղ մտնում է այդ գինը
depth.grid_step Բասկետի չափը գնի միավորներով
depth.best_bid, depth.best_ask Լավագույն գները բարի ավարտին
depth.max_cell Բասկետների մեջ ամենաբրոտը ծավալով
depth.bid_sum(pct), depth.ask_sum(pct) Սեղմում կողմի ծավալը pct % շերտում կենտրոնից
depth.imbalance(pct) Պահված շերտում անհավասարակշռությունը՝ -1 մինչև +1
depth.max_bid(pct), depth.max_ask(pct) Սայրի մեջ ամենագեր բասկետի գինն ու ծավալը

Նշումներ և սահմանափակումներ:

  • Դրանք հասանելի են այնտեղ, որտեղ սերվերի ջերմաքարտեզը աշխատում է, և timeframe-ներում սկսած մի վայրկյանից (second timeframes)։
  • Սերվերը պահում է ուղիղ մոտավորապես ±4 %-անոց ժապավեն գնի շուրջը. դրա սահմաններից դուրս depth.at վերադարձնում է na, իսկ ժապավենի ներսում դատարկ բասկետը վերադարձնում է 0։
  • Պատմության խորությունը սահմանափակ է. առավել հին բարերը լռեցնելը թույլատրում է na վերադարձ։
  • Առաջիկա, կառուցվող բարի արժեքները փոխվում են տվյալների ժամանման ժամանակ։
Loot
indicator("Перекос записанного стакана", overlay = false)
band = input.float(1.0, "Полоса, % от цены", minval = 0.1, maxval = 4.0, step = 0.1)
imb = depth.imbalance(band)
plot(imb, "Перекос", style = plot.style_columns, color = imb >= 0 ? color.teal : color.red)

Սերվերի գրանցած order book-ը մոմերի տակ նկարելու համար բավական է մեկ տող՝ heatmap.depth() յուրաքանչյուր սկրիպտում, երբ overlay = true. Գույները և շերտերի պարամետրերը կարելի է փոխել էջում Настройки и отрисовка.

Loot
indicator("Записанный стакан теплом", overlay = true)
heatmap.config(palette = heatmap.inferno, low = 25)
heatmap.depth()

Կենդանի order book և time and sales: book.* և tape.*

Կենդանի order book- և time and sales-ը ոչ մի տեղ չեն գրանցվում, այդ պատճառով արժեքները հասանելի են միայն վերջին բարում, իսկ պատմության վրա միշտ na. Դրանց համար պետք է բաց վահանակ order book նույն ինստրում, հակառակ դեպքում book.available և tape.available կլինեն սխալական (false), և լեգենդում կհայտնվի «չկա բաց order book». Վերարտադրության (replay) режиме այս տվյալները հասանելի չեն։

Անուն Ինչ է վերադարձնում
book.bid(i), book.ask(i) i մակարդակի գինը; 0 նշանակում է ամենալավ գինը
book.bid_qty(i), book.ask_qty(i) Այս մակարդակում եղած ծավալը մոնետաներով
book.spread Լավագույն ask - լավագույն bid
book.mid Լավագույն գների միջինը
book.imbalance(n) Առջևի n մակարդակների անհավասարակշռությունը՝ յուրաքանչյուր կողմի համար՝ -1…+1
book.available Ցույց է տալիս՝ արդյոք կա snapshot order book
tape.last_price, tape.last_qty Վերջին գործարքի գինն ու ծավալը
tape.last_side +1 գնող-ագրեսոր, -1 վաճառող, 0՝ դեռ գործարքներ չեն եղել
tape.count(ms) Գործարքների քանակը վերջին ms միլիվայրկյանների ժամանակային պատուհանում
tape.buy_volume(ms), tape.sell_volume(ms) Ագրեսիվ գնումների և վաճառքների ծավալը պատուհանում
tape.max_print(ms) Պատուհանի ամենամեծ գործարքը
tape.available Ցույց է տալիս՝ արդյոք time and sales-ն միացված է

Time and sales պատուհանը և book.imbalance-ի խորությունը задаются կոդում թիվով կամ input.int-ով: պատուհանը հաշվարկվում է վերջին բորսայի գործարքի ժամանակից, ոչ ձեր համակարգչի ժամից։ Սկրիպտը տեսնում է միայն time and sales-ի վերջը՝ մոտավորապես երկու հազար վերջին գործարքները, այնպես որ ակտիվ շուկայում երկար պատուհանը կարող է չցուցադրել ամբողջ ինտերվալը։

Երբ այս արժեքները naudojվում են plot-ում, Խմբագրիչը մի նախազգուշացում ցույց է տալիս՝ «Տվյալները հասանելի են միայն իրական ժամանակում — պատմության վրա շարքը դատարկ է». դա սպասելի է՝ երկրորդական էությունը: պատմության ձախ մասը դատարկ է։ Այս տվյալները չէ կարելի օգտագործել ռազմավարությունների համար — տես Стратегии и тестер.

Loot
indicator("Перекос стакана", overlay = false)
levels = input.int(20, "Уровней с каждой стороны", minval = 1, maxval = 200)
imb = book.available ? book.imbalance(levels) : na
plot(imb, "Перекос", style = plot.style_area, color = imb >= 0 ? color.teal : color.red)
hline(0, "Ноль", color = color.gray)

Screener: screener.*

Գրաֆիկի ինստրումը համար screener-ի մետրիքները նույն արժեքներն են, ինչ նրա սյունակներում։ Պատմություն դրա համար չկա; արժեքը գոյություն ունի միայն վերջին բարում։ Պատուհանը (window) задаётся որպես տող (string), և ոչ բոլոր մետրիկաներում կան բոլոր պատուհանները։

Ֆունկցիա Ինչ է ցույց տալիս Տարբեր պատուհաններ
screener.change(w) Գնի փոփոխություն "1m" "5m" "15m" "1h" "24h"
screener.vol(w) Տրանզակցիոն շրջանառություն "1m" "5m" "15m" "1h" "24h"
screener.avg_vol(w) Միջին շրջանառություն "1m" "5m" "15m" "1h"
screener.rvol(w) Հարաբերական ծավալ (RVOL) "1h" "24h"
screener.natr(w) NATR "1m" "5m"
screener.oi_delta(w) Open interest-ի փոփոխություն "1m" "5m" "1h" "24h"
screener.btc_corr(w) Կապունակություն BTC-ի հետ "1m" "5m"
screener.available Ցույց է տալիս՝ արդյոք ինստրումին տեխնիկապես մատչելի է screener-ը —

Տվյալ պատուհանների բացակայությունը վերադարձնում է na. Մետրիկա, որը դուրս է ձեր screener բաժանորդագրությունից, նույնպես վերադարձնում է na. Խմբագրիչը նույն նախազգուշացումը ցույց է տալիս, ինչպես order book-ի դեպքում՝ պատմության վրա շարքը դատարկ է։

Loot
indicator("Скринер: RVOL и NATR", overlay = false)
plot(screener.rvol("1h"), "RVOL 1h", color = color.orange)
plot(screener.natr("5m"), "NATR 5m", color = color.teal)

Բորսաների ընդգրկում

Բորսա Կլաստերներ և delta Open interest և funding rate
Binance, Bybit, OKX, Bitget, Gate.io, MEXC, KuCoin, BingX, AsterDEX Սպոթ և futures Futures
Hyperliquid Futures; սպոթ — ոչ Futures
Binance Alpha Ոչ՝ բորսան չի հրապարակում ագրեսոսի կողմը Ոչ
Upbit Ոչ Ոչ
Տրամադրված տվյալ Timeframe-ներ
Կլաստերներ 30 վայրկյանից մինչև 1 օր
Դելտա 30 վայրկյանից և բարձր
Open interest, funding rate 1 րոպեից և բարձր
Գրանցված order book-ի պատմություն 1 վայրկյանից և թարմ կլինի այնտեղ, որտեղ սերվերի ջերմաքարտեզը աշխատում է
Կենդանի order book, time and sales Ինչպես ցանկացած timeframe՝ երբ բաց է order book վահանակը
Screener Ընդունվում է ցանկացած timeframe, այն ինստրումը, որը տեսանելի է screener-ին

Ծածկույթը սահմանում է տվյալների սերվերը և կարող է փոփոխվել։ Ամենավստահելի մոտեցումն է հենվել .available ֆլագին և լեգենդի գրառմանը։

Իրենցից տարբեր timeframe և տարբեր ինստրում

request.security հաշվարկում է արտահայտությունը այլ series-ի վրա — ավագ timeframe կամ այլ մետաղադրամ — և համադրում է արդյունքը գրաֆիկի բարերի հետ.

TEXT
request.security(symbol, timeframe, expression, gaps = false, lookahead = false, ignore_invalid_symbol = false)
  • symbol — ձևաչափով «ԲՈՐՍԱ:ԹԻՔԵՐ», ինչպես TradingView-ում: օրինակ՝ "BINANCE:BTCUSDT.P", որտեղ .P նշանակել է perpetual futures. Ներդրումի սիմվոլը գրաֆիկի համար է՝ sym.ticker.
  • timeframe — տեքստային ձևով՝ "5", "60", "4h", "1D", "1W". Գրաֆիկի timeframe-ը՝ tf.period.
  • expression — թիվ կամ մի քանի թվեր փակագծերի մեջ՝ օրինակ [high, low].

Առանց ապագա տեսնելու. Դեֆոլտով գրաֆիկի բարն տեսնում է ավագ timeframe-ի վերջին փակված բարի արժեքը: այդ պատճառով ժամային EMA-ն 5 րոպեանոցների վրա բարձրանում է միայն ժամը փակելիս. Այսպես պատմության վրա արդյունքը համընկնում է իրական ժամանակում տեսածի հետ։

  • gaps = true — արժեքը հայտնվում է միայն այն առաջին բարում գրաֆիկի վրա, որտեղ եկավ նոր ավագ բարը, հետո կլինի na։
  • ignore_invalid_symbol = true — անհայտ սիմվոլը վերադարձնում է na. Ինքըհետո չեղած դեպքում սկրիպտը կկործանվի սխալով «Символ … неизвестен»։

Ընդարձակ արտահայտության մեջ հասանելի են մյուս սերիայի մոմերը և դրանց հաշվարկները։ Գրաֆիկի փոփոխականը փոխանցել հնարավոր չէ — միայն input.*-ի արժեքները։ Order book-ը, time and sales-ը և screener-ը ներսում չեն կոմպիլյացվում, իսկ այլ սերիայի cluster-ները, delta, open interest և funding rate-ը կվերադարձնեն na. Սկրիպտը կարող է ունենալ մինչև 8 տարբեր «ինստրում + timeframe» զույգեր և ընդամենը մինչև 32 կանչ request.security.

Loot
indicator("EMA старшего таймфрейма", overlay = true)
len = input.int(20, "Длина EMA", minval = 2, maxval = 500)
tfHigh = input.timeframe("60", "Старший таймфрейм")
emaHigh = request.security(sym.ticker, tfHigh, ta.ema(close, len))
plot(emaHigh, "EMA", color = color.orange, style = plot.style_stepline)
Loot
indicator("Спред к другой бирже", overlay = false)
other = input.symbol("BYBIT:BTCUSDT.P", "Сравнить с")
px = request.security(other, tf.period, close, ignore_invalid_symbol = true)
plot(close - px, "Разница", color = color.orange)

Дальше

https://docs.lootx.trade/hy/loot/market-data

Основы

7Ստրատեգիաներ և թեստեր

Ինչպես գրել ստրատեգիա LootScript-ով և ստուգել այն պատմության վրա թեստերում՝ հայտարարում `strategy()`, հայտերը, կատարման մոդելը, ծախսերը, հաշվետվության ներդիրները եւ բեքթեստի սահմանափակումները։

Ստրատեգիան սկրիպտ է, որը գրաֆիկի վրայի գծերից բացի կադրում է հայտեր։ Հենց հայտերն չի իրականացնում բորսան, այլ տերմինալի ներսի սիմուլյատորը՝ այն անցկացնում է ստրատեգիան գրաֆիկի պատմության վրա՝ հաշվի առնելով կոմիսիաները, slippage- ը եւ funding rate-ը, եւ ցույց է տալիս արդյունքը Ստրատեգիայի թեստեր պատուհանում։

Հայտարարում strategy()

Ստրատեգիան ի տարբերություն ինդիկատորի սկսվում է առաջին տողում strategy(...)-ով՝ ոչ indicator(...)-ով։ Մնացածը — կարգավորումները, գրաֆիկական արտապատկերը եւ շուկայի տվյալները — գործում են նույն կերպ։ Ֆունկցիաները strategy.* ինդիկատորում չեն կոմպիլացվում՝ «strategy.* հասանելի է միայն strategy(...)-ում»։

Պարամետր Լռելյայն Ինչ է սահմանում
initialCapital 10000 Սկիզբային կապիտալ
defaultQtyType, defaultQtyValue strategy.qty.fixed, 1 Հայտի չափը, եթե հայտում չի նշվել qty
commissionType, commissionValue տոկոս, նշված չէ Կոմիսիա: strategy.commission.percent — շրջանառության տոկոս (0.05 = 0.05 %), strategy.commission.cash_per_contract — գումար մեկ կոնտրակտի համար, strategy.commission.cash_per_order — մեկ իրականացման համար
slippageTicks 0 Slippage տիկերով
pyramiding 0 Քանի էնտրին մեկ կողմում կարող է բաց մնալ; 0 — մեկ
positionModel strategy.model.netting Մի ընդհանուր դիրք կամ առանձին երկար/կարճ (strategy.model.hedging)
processOrdersOnClose false Իմաստ ունի նկարվել market հայտերը ընթացիկ բարի փակման պահին
calcOnEveryTick false Թույլատրել հայտեր ձևավորվող բարի վրա
marginLong, marginShort, leverage 0, 0, 1 Մարժա տոկոսներով կամ leverage; при 0՝ լիկվիդացիա չի մոդելավորվում
applyFunding true Ուշադիր լինել funding rate-ին
fillModel strategy.fill.conservative Գնի ուղու ենթադրություն բարի ներսում

Պարամետրերի արժեքները թույլատրվում են միայն թվեր եւ կայուն կոնստանտներ პირდაპირ տեքստում։ Հ uttryck կամ input.* հայտման մեջ՝ դա կոմպիլացիոն սխալ է։ Պարամետր calcOnOrderFills ընդունվում է, բայց այս build-ում չի գործում. թեստերի «Свойства» ներդիրում այն նշված է՝ «не действует в этой сборке»։

Եթե հայտի qty = na, ապա հայտի չափը որոշվում է defaultQtyType-ով՝

Տիպ defaultQtyValue նշանակում է
strategy.qty.fixed Քանակը մետաղադրամներով (բազային արժույթ)
strategy.qty.cash Գումարը ծածկագրված դիմացկուն արժույթով
strategy.qty.percent_of_equity Տոկոս ներկայիս կապիտալից
strategy.qty.risk_percent Կապիտալի տոկոսը, որով ռիսկ եք կրել մինչև պաշտպանական stop-ը

s trategy.qty.risk_percent օգտագործելու համար պարտադիր է ունենալ strategy.exit stop-ով (loss կամ stop), հակառակ դեպքում կոմպիլյատորը կանգնեցնում է կոմպիլացիան՝ «պահանջվում է стоп, ըստ որի հաշվարկել չափը»։ Քանակը կկրքերանա ստորակայ ստորակետով՝ դեպի գործիքի քանակի քայլը։ Եթե կտրատելուց հետո մնում է զրո, հայտը մերժվում է եւ մեծանում է թեստերի ցուցիչը «Отвергнуто заявок (размер)»։

Հայտեր

Ֆունկցիա Ինչ է անում
strategy.entry(id, direction, qty, limit, stop, …) Բերում է դիրք կամ կատարում է տարանցում (reverse). Ունի հաշվի position model-ը եւ pyramiding-ը
strategy.order(id, direction, qty, limit, stop, …) Նույնը՝ առանց position model-ի եւ pyramiding-ի հաշվի
strategy.exit(id, from_entry, qty, qty_percent, profit, limit, loss, stop, trail_price, trail_points, trail_offset, …) Պարզաբանում է ելքը — take-profit, stop-loss կամ trailing՝ բացված դիրքի համար
strategy.close(id, comment, qty, qty_percent) Փակում է դիրքը market order-ով
strategy.close_all(comment) Փակում է բոլոր դիրքերը
strategy.cancel(id), strategy.cancel_all() Հանում է դեռևս չիրականացված հայտերը

Ուղղությունը — strategy.long կամ strategy.short։ Բոլոր ֆունկցիաների մոտ հնարավոր է ունենալ ընտրովի when՝ when = false նշելով կանչը բաց է թողնվում։ Մուտքերին, ելքներին եւ փակարարներին կարելի է տալ comment — հայտի տեքստային թեգ։

  • Մուտքի տեսակը. Առանց limit եւ stop — market order; limit-ով — limit order; stop-ով — stop order; երկուսի առկայությամբ՝ stop-limit։ Սույն id-ով կրկնված strategy.entry փոխարինում է դեռ չիրականացված հայտը։
  • Ռիվերս (reverse). netting մոդելում հակառակ ուղղությամբ մուտքը փակելիս մի հրամանքով փակվում է ընթացիկ դիրքը եւ բացվում նորը։
  • Ելքի միավորները. profit եւ loss նշվում են tick-երով մուտքի գնի հանդեպ, limit եւ stop — ուղղակի արժեքներով (absolute prices). Trailing-ը սահմանվում է զույգով՝ trail_offset եւ trail_price կամ trail_points։
  • Ելք առանց մակարդակների ոչինչ չի անում. Կոմպիլյատորը զգուշացնում է՝ «strategy.exit առանց միևնույն մակարդակի (profit/loss/stop/limit/trail) — դատարկ գործողություն»։
  • Stop-ի տեղափոխում. Նույն id-ով կրկնված strategy.exit փոխարինում է գոյություն ունեցող ելքը — այս եղանակով շարժում են stop-ը։

Ստրատեգիայի վիճակը կարելի է կարդալ ռեժիսորների միջոցով՝ strategy.position_size (ստորագրով, կարճ դիրքը բացասական է), strategy.position_avg_price, strategy.equity, strategy.netprofit, strategy.openprofit, strategy.opentrades, strategy.closedtrades, strategy.funding_paid եւ այլն — ամբողջ ցանկը՝ ըստ ուղեցույցի։

Ինչպես թեստերը իրականացնում են հայտերը

Հայտը, որը հայտված է վրա բարի, չի իրականացվում շուտ քան հաջորդ բարը։ Պ_DECISION-ը ընդունվում է բարի փակման պահին, եւ իրականացնելը նույն գնով կնշանակեր “զարկ տալ ապագային նայել”։

Заявка Исполнение
Рыночная Հաջորդ բարի բացման ժամանակ՝ գումարած slippage։ Եթե processOrdersOnClose = true — ընթացիկ բարի փակման պահին
Лимитная Երբ գինը անցնում է լիմիթը՝ ըստ լիմիթի արժեքի։ Եթե բարը բացվել է լիմիթից այն կողմ — ըստ բացման
Стоп Երբ գինը անցնում է стопը՝ ըստ стопի գնի, գումարած slippage։ Գեպի դեպքում — ըստ բացման գումարած slippage

Գնի ուղին բարի ներսում. Տեսական ուղին բարի ներսում թեստերը իրականում չի գիտի և ենթադրում է այն։ Մոդել strategy.fill.conservative (Լռելյայն) ընդունում է, որ գինը նախ գնացել է ավելի վատուկ ծայրի՝ աճող բարի համար՝ բացում → նվազագույն → առավելագույն → փակել; նվազող բարի համար՝ հակառակն։ Եթե մեկ բարի մեջ հայտնվեցին եւ стоп, եւ тейք, նախ-ինկում կհապաղի стоп-ը։ Մոդել strategy.fill.optimistic ենթադրում է հակառակն՝ ծառայում է միայն համեմատության համար։ Այս build-ում մոլորակի փոքր таймֆрейմով проигрывания չկա՝ «Ուղին» սյունակում յուրաքանչյուր գործարք նշված է որպես մոդելով ենթադրյալ։

Ծախսերը.

  • Կոմիսիա. Եթե commissionValue նշված չէ, թեստերը կիրառելու են լռելյայն տարկը՝ 0.02% limit executions-ի համար եւ 0.05% market/stop executions-ի համար։ Ձեր հաշվի տարկները եւ ռիբեյթները տերմինալին անհայտ են։ Վրայով նշված թիվը տարածվում է բոլոր իրագործումների վրա։
  • Slippage — slippageTicks ընդդիմությամբ ձեր վրա market եւ stop اجرا-ների ժամանակ։ Limit executions-ը չեն проскальзывают։
  • Funding rate գանձվում է յուրաքանչյուր իրական հաշվարկի պահին՝ ըստ փաստացի rate-ի եւ հաշվարկի բարի փակման գնի։ Դա պահանջում է funding rate տվյալներ՝ ֆյուչերսների համար նշվածը покрытия աղյուսակում։
  • Մարժա. Երբ ներկայանում են marginLong/marginShort կամ leverage>1, թեստերը մոդելավորում է պարզեցված isolated margin։ Լոնգ դիրքը լիկվիդացվում է երբ արժեքը ընկնում է դեպի entry × (1 − m/2), կարճը՝ երբ արժեքը բարձրանում է դեպի entry × (1 + m/2), որտեղ m — սկիզբային մարժայի մասնաբաժինը։ Լիկվիդացված գործարքը կորցնում է ամբողջ սկիզբային մարժան։

Գործարքները, որոնք չեն փակվել մինչ պատմության վերջը, փակվում են վերջին բարի փակման գնով՝ պատճառով «վերջ տվյալների»։

Ստրատեգիայի թեստեր

Ավելացրեք ստրատեգիան գրաֆիկին

Խմբագրիչում սեղմեք Ավելացնել գրաֆիկին (Ctrl+Enter): սխալներով սկրիպտը գրաֆիկ չի հայտնվի։

Բացեք թեստերը

Խմբագրիչի գործիքների վահանակում սեղմեք Ստրատեգիայի թեստեր… — կոճակը ակտիվ է միայն այն սկրիպտների համար, որտեղ կա strategy(...)։ Մյուս ճանապարհը՝ ստրատեգիայի կարգավորումների шестерёнка-ից գրաֆիկի լեգենդում՝ կոճակը Ստրատեգիայի թեստեր…։

Սպասեք պրոցեսին

Թեստերը հաշվում են միայն այն մոմերի հիման վրա, որոնք բեռված են գրաֆիկում։ Առանց դրանց պատուհանը ցույց է տալիս «Стратегия ещё не считалась: дождитесь загрузки свечей»։ Երբ գալիս են նոր մոմերը, արդյունքը ինքնաբերաբար վերակենսանացվում է; Пересчитать կոճակը սկսում է լրիվ պրագոնը ձեռքով։

Եթե գրաֆիկում մի քանի ստրատեգիաներ կան, անհրաժեշտը կարելի է ընտրել թեստերի պատուհանում։

Վкладка Ինչ կա դրա մեջ
Аմփոփում Պլիտներ՝ «Чистая прибыль», «Профит-фактор», «Макс. просадка (по закрытиям)», «Доля прибыльных», «SQN»; տող Чего этот бэктест не знает; կապիտալի կորեր, «купил-и-держи», կապիտալ առանց funding rate եւ երկու просадка
Ցուցանիշներ Արդյունք, ռիսկ (просадка по закрытиям եւ բարի ներսում առանձին, Sharpe, Sortino, Calmar), գործարքներ (փաստացի շահութաբերների մասնաբաժինը, միջին եւ ամենամեծ, շարքեր), ծախսեր (կոմիսիա եւ funding rate)
Գործարքներ Գործարքների աղյուսակ՝ մուտք, ելք, պատճառ, ծավալ, P&L, run-up, просадка, կոմիսիա, funding rate։ Սեղմումը տողի վրա կենտրոնացնում է գրաֆիկը մուտքի բարի վրա; Ctrl+C պատճենում է ընտրված տողերը
Սեփականություններ Հայտի պարամետրերը, բարերի տիրույթը, գնային քայլը, քանակի քայլը, նվազագույն լոտը, կոմիսիան, պրագոնի հաշվիչները՝ մերժված հայտեր, пропущенные ըստ pyramiding, լիկվիդացիաներ, funding հաշվարկներ

Վերնագրում՝ կատարման մոդելի նշանները՝ conservative կամ optimistic, եւ close-fill եթե processOrdersOnClose = true է։ Նշանները optimistic եւ close-fill նշանակում են, որ իրականում արդյունքը, ամենայն հավանականությամբ, ավելի վատ կլինի։

Ի՞նչ չի կարող կարդալ ստրատեգիան

Կենդանի order book եւ time and sales (լենտա). Ստրատեգիան, որը կարդում է book.* կամ tape.*, չի կոմպիլացվի՝ «Стратегия читает … у стакана и ленты нет истории, бэктест был бы вымыслом»։ Для истории order book-ի համար պետք է օգտագործել depth.*, իսկ գործարքների պատմության համար՝ delta.* եւ cluster.* (footprint cluster-ներ)։

Screener. screener.* նույնպես հասանելի է միայն վերջին բարի վրա, սակայն կոմպիլյատորը թույլատրում է такую стратегию։ Պատմության մեջ screener-ի արժեքները na են, հետեւաբար պայմանները այնտեղ չեն կատարվում եւ հաշվետվությունում դրանցից գործարքներ չեն հայտնվի։

Ապագային նայելը. request.security(..., lookahead = true) ստրատեգիայի դեպքում խմբագրիչը ցույց է տալիս նախազգուշացում՝ «Стратегия заглядывает вперёд … отчёт помечен как недостижимый в реальном времени»։ Տեսեք այս հաշվետվությունը որպես վերագնահատված՝ պատմությունում ստրատեգիան կարող է տեսնել արժեքներ, որոնք իրական ժամանակում դեռ գոյություն չեն ունեցել։ Մանրամասներ՝ Շուկայի տվյալներ բաժնում։

Օրինակ

Պրոբոյ ալիք՝ delta-ով հաստատմամբ. Մուտք՝ փակման պահին այն կողմում, որը դուրս է եկել len վերջին բարերից, եթե բարի delta-ն նույն ուղղությանն է. Stop՝ ATR-ում, take՝ կրկնակի։

Loot
strategy("Пробой канала с дельтой", overlay = true,
         initialCapital = 10000,
         defaultQtyType = strategy.qty.percent_of_equity, defaultQtyValue = 20,
         commissionValue = 0.05, slippageTicks = 2)

len      = input.int(20, "Канал, баров", minval = 5, maxval = 200)
stopAtr  = input.float(1.5, "Стоп, ATR", minval = 0.5, maxval = 10, step = 0.1)
needFlow = input.bool(true, "Подтверждать дельтой")

upper = ta.highest(high, len)[1]
lower = ta.lowest(low, len)[1]
atr   = ta.atr(14)

flowLong  = not needFlow or (delta.available and delta.value > 0)
flowShort = not needFlow or (delta.available and delta.value < 0)

if close > upper and flowLong and strategy.position_size <= 0 {
    strategy.entry("L", strategy.long, comment = "пробой вверх")
}
if close < lower and flowShort and strategy.position_size >= 0 {
    strategy.entry("S", strategy.short, comment = "пробой вниз")
}

stopTicks = math.round(atr * stopAtr / sym.tick_size)
strategy.exit("L-x", from_entry = "L", loss = stopTicks, profit = stopTicks * 2)
strategy.exit("S-x", from_entry = "S", loss = stopTicks, profit = stopTicks * 2)

plot(upper, "Верх канала", color = color.teal)
plot(lower, "Низ канала", color = color.red)

Եթե բորսան չունի delta (օրինակ՝ Binance Alpha) եւ միացված է «Подтверждать дельтой», ստրատեգիան չի կատարի ոչ մի գործարք՝ delta.available այնտեղ կեղծ է։ Դա na-ի օրենքն է աշխատում, ոչ թե սխալ։

Սահմանափակումներ

  • Մեկայն սիմուլյացիա — իրական հայտեր գոյություն չունեն։
  • Limit հայտերը իրականացվում են այնպես, կարծես դուք առաջինն եք հերթում. սա՝ maker-աստրատեգիաների հիմնական աղբյուրն է՝ վերագնահատված արդյունքների համար։
  • Ձեր գործարքները գինը չեն շարժում, մաս-իրականացումներ չկան — հայտը կամ ամբողջովին իրականացվում է, կամ ոչ մի կերպ։
  • Գնի ուղին բարի ներսում ենթադրվում է մոդելով, ոչ թե վերցված փոքրեռի timeframe-ից։
  • Լիկվիդացիան պարզեցված է — բորսայի լիկվիդացիոն շարժիչը, ADL եւ ապահովագրական ֆոնդը չեն մոդելավորվում։
  • Կոմիսիան — լռելյայն տարկ է, ոչ ձեր հաշվի տարկը։
  • Տվյալների բացակայությունը չի նշանակում շարժմամունք: մոմը առանց footprint cluster-ների նույնպես ենթադրում է շարժում։
  • Արդյունքը կախված է նրանից, որքան պատմություն բեռված է գրաֆիկում։

Հաջորդ քայլը

https://docs.lootx.trade/hy/loot/strategies

Основы

8Ալերտներ սկրիպտներից

Ինչպես LootScript-սկրիպտը հայտնում է պայմանի կատարմանը՝ alert() և alertcondition(), դրանց հաճախականությունը, պայմանների ակտիվացումը, ուր հասնում են ծանուցումները և ինչից զուրկ են սկրիպտային ալերտները։

Սկրիպտը կարող է ձեզ տեղեկացնել, որ կենդանի շուկայում կատարվել է պայման՝ breakout մակարդակի անցում, delta-ի spike կամ գծերի հատում։ Այս համար LootScript-ում կան երկու ֆունկցիա՝ alert(), որը սկրիպտը կանչում է ինքնուրույն, և alertcondition(), այն պայմանը, որը դուք ակտիվացնում եք ձեռքով։

Սբազվածությունը անցնում է նույն pipeline-ով, ինչ մնացած տերմինալի ծանուցումները՝ գրառում time and sales-ում՝ Ծանուցումներ, ձայն և վիզուալ badge։ Բոլորը հաշվարկվում են ձեր տերմինալում՝ ձեր համակարգչին վրա. ալերտները աշխատում են, միայն եթե տերմինալը բաց է և սկրիպտը տեղադրված է գրաֆիկի վրա։

Երկու եղանակ

alert() alertcondition()
Ո՞վ որոշում է զանգը Կոդը (սկրիպտը) Դուք՝ պայմանը պետք է ակտիվացվի
Ե՞րբ է գործում Ըստ ընտրված հաճախականության, այդ թվում՝ անփակ բարում Միայն բարի փակմանը, ոչ հաճախ քան մեկ անգամ մեկ բարի համար
Տեքստ Любая строка, можно собрать из чисел Ֆիքսված տեքստ կոդում
Որտեղ միացվում է Завжди, երբ սկրիպտը գրաֆիկին է Галочкой в консоли редактора

Եթե ալերտը պետք է միշտ աշխատի — օգտագործեք alert(). Եթե սկրիպտը հայտարարում է մի քանի սիգնալ, բայց զանգել պետք է միայն որոշներին — հայտարարեք դրանք alertcondition()-ով և ակտիվացրեք անհրաժեշտները։

alert(): ալերտը կոդից

TEXT
alert(message, freq = alert.freq_once_per_bar_close)

message — տող. թվեր նրա մեջ տեղադրեք՝ str.tostring-ով, օրինակ՝ "Цена " + str.tostring(close). Տեքստը գալիս է ծանուցման մեջ այնպես, ինչպես է — տերմինալը այն չի փոխում և չի ուղղում։

Հաճախականությունը задаётся константой.

Հաճախականություն Ե՞րբ է զանգում
alert.freq_once_per_bar_close Լռելյայն. Մի անգամ, երբ բարն փակվեց՝ հաջորդ բարի առաջին թարմացման պահին,փակված արժեքներով
alert.freq_once_per_bar Առաջին մարտի պահին, երբ կանչը կատարվում է այդ բարում, նույնիսկ եթե բարն դեռ ձևավորվում է. հետ՝ լռում է մինչև հաջորդ բար
alert.freq_all Ամեն recalculation կենդանի բարի վրա, որտեղ կանչը կատարվել է

Հաճախականությունը հաշվարկվում է յուրաքանչյուր alert() կանչի համար առանձին. Երկու կանչ մեկ սկրիպտում չեն լռեցնում մեկը մյուսին. Մի recalculation — առավելագույնը 16 ալերտ, մնացածները մերժվում են։

Օրինակ՝ ալերտ՝ delta-ի spike-ի վրա, հենց այն հայտնվի ձևավորվող բարում:

Loot
indicator("Всплеск дельты", overlay = false)
mult = input.float(3.0, "Во сколько раз больше обычного", minval = 1.5, step = 0.5)
base = ta.sma(math.abs(delta.value), 50)
spike = delta.available and math.abs(delta.value) > base * mult
plot(delta.value, "Дельта", style = plot.style_columns, color = delta.value >= 0 ? color.teal : color.red)
if spike {
    alert("Всплеск дельты: " + str.tostring(delta.value, "#.##"), freq = alert.freq_once_per_bar)
}

Այն տեղերում, որտեղ delta չկա, delta.available-ը false է և ալերտը լռում է — մանրամասներ na-ի կանոնի մասին՝ բաժնում Данные рынка.

alertcondition(): պայման, որը դուք ակտիվացնում եք

TEXT
alertcondition(condition, title, message)

condition — լոգիկ արտահայտություն, title — պայմանի անունը, message — ծանուցման տեքստը. title-ն և message-ը պետք է լինեն լտի տողեր կոդում — դրանցից թվեր չեք sastavlyaete: Եթե message չկա, ծանուցման մեջ կիրակի title-ը։

Պայմն ձայնարկվում է միայն բարի փակմամբ, ոչ ավելի հաճախ քան մեկ անգամ մեկ բարի համար և միայն եթե այն ակտիվացված է. Լռելյայն բոլոր պայմանները անջատված են։

Ավելացրեք սկրիպտը գրաֆիկին

Խմբագրիչում սեղմեք Ավելացնել գրաֆիկին։

Բացեք թաբը «Արդյունք»

Կոդի տակ գտնվող կոնսոլում ընտրեք Արդյունք թաբը. այնտեղ ցուցադրված են շարերի արժեքները վերջին բարում և ցանկը «Условия алертов (alertcondition) — ակտիվացրե՛ք անհրաժեշտը»:

Ակտիվացրե՛ք պայմանները

Մարկացրեք այն պայմանները, որոնցով ուզում եք ստանալ ծանուցումներ. Եթե սկրիպտը կանգնած է մի քանի գրաֆիկներում, յուրաքանչյուրը ունի իր ցանկը։

Պատմությունը լուռ է

Ալերտները հնչում են միայն կենդանի թարմացումներում. Առաջին հաշվարկը՝ գրաֆիկի բեռնումից, գործիքի փոփոխությունից կամ հին պատմության բեռնումից հետո, համարվում է պատմություն՝ ուստի անցյալ բարերի վրա ոչ alert(), ոչ alertcondition() չի աշխատի. Այս պատճառով, սկրիպտը գրաֆիկին ավելացնելուց հետո դուք ոչ մի զանգվածային անցյալի ծանուցումներ չեք ստանա.

Պայմանի աշխատառությունը պատմության վրա տեսնելու համար նկարեք այն plotshape-ով՝ այն ցույց կտա յուրաքանչյուր բար, որտեղ ալերտը կաշխայի։

Ուր է գնում ալերտը

Յուրաքանչյուր սրակտիկացում՝

  • Գրառվում է time and sales-ում՝ «Ծանուցումներ» աղբյուրով «Սկրիպտային ալերտ». Գրառման մեջ ցույց են տրվում հաղորդագրության տեքստը, սկրիպտի անունը և, alertcondition()-ի համար, պայմանի անվանումը. time and sales-ը բացվում է առանձին պատուհանով կամ workspace վահանակով; ֆիլտր Աղբյուրներ-ը թողնում է միայն սկրիպտային ալերտները։
  • Միացնում է ձայնը. Ձայնը ընտրում են Կարգավորումներ → Ծանուցումներ, «Звуки» բաժնում՝ տողը «Скриптовый алерт»: ցանկ ձայների և անջատիչ, որը կարող եք անջատել ձայնը։
  • Ցուցադրում է badge՝ «Սկրիպտի անունը: հաղորդագրություն»։
  • Осветляет workspace tab-ը, որտեղ կանգնած է գրաֆիկը սկրիպտով։

Մյուս տերմինալի ծանուցումները նկարագրված են էջում Алерты и уровни.

Մատյան: log.*

Պայմանների отладка-ի համար կա մատյան: log.info, log.warning և log.error գրում են տողը Մատյան թաբում՝ նույն տեղում, որտեղ գտնվում են Խնդիրներ և Արդյունք:

  • Մատյանը, ինչպես ալերտները, գրանցվում է միայն կենդանի թարմացումներով — պատմության վրա լռում է։
  • Մի բարի համար՝ ոչ ավելի քան 16 տող; մնացածները մերժվում են։
  • Կոնսոլը պահպանում է վերջին 256 տողերը. ավելի հին տողերը տեղը զիջվում են, դրանց թիվը ցուցադրվում է որպես «вытеснено строк». Очистить կոճակը մաքրում է մատյանը։
Loot
indicator("Проверка условия", overlay = true)
len = input.int(20, "Канал, баров", minval = 2, maxval = 500)
upper = ta.highest(high, len)[1]
plot(upper, "Верх канала", color = color.teal)
if barstate.islast {
    log.info("Закрытие " + str.tostring(close) + ", верх канала " + str.tostring(upper))
}

Օրինակ՝ пробой канала

Սկրիպտը բացում է ալիքի վերին սահմանը, նշում է пробои եռանկյուններով և հայտնում դրանց մասին երկու ձևով՝ alert() միշտ ձայն է տալիս, իսկ պայմանը «Пробой вверх» ձայնում է միայն եթե դուք այն ակտիվացրել եք։

Loot
indicator("Пробой канала с алертом", overlay = true)
len = input.int(20, "Канал, баров", minval = 2, maxval = 500)
upper = ta.highest(high, len)[1]
breakUp = ta.crossover(close, upper)
plot(upper, "Верх канала", color = color.teal)
plotshape(breakUp, "Пробой", style = shape.triangleup, location = location.belowbar, color = color.teal, size = size.small)
if breakUp {
    alert("Пробой вверх, цена " + str.tostring(close), alert.freq_once_per_bar_close)
}
alertcondition(breakUp, "Пробой вверх", "Цена закрылась выше канала")

Սահմանը վերցվում է shift [1]-ով — նախորդ բարերից, հակառակ դեպքում ընթացիկ максимумը միշտ կլինի ալիքի ներսում. Հաճախականությունfreq_once_per_bar_close նշանակում է, որ ալերտը կհնչի բարի փակվելուց հետո, և եռանկյունը գրաֆիկում կմնա հենց այնտեղ, որտեղ ալերտը հնչեց. Իրական կյանքի սկրիպտներում սովորաբար թողնում են մեկ եղանակը; այստեղ երկուսը՝ համեմատության համար։

Դրանից հետո

https://docs.lootx.trade/hy/loot/alerts

Основы

9Արհեստական ինտելեկտի օգնականը Խմբագրիչում

LootScript խմբագրիչի մեջ չատ՝ AI մոդելով. գրում և շտկում է սկրիպտներ, լրացուցիչ՝ աշխատեցնում դրանք մոմերի վրա, պատասխանում է շուկայի հարցերին. որ պրովայդերներն են, որտեղ տեղադրել API բանալին և ինչ է ուղարկվում համակարգչից.

Խմբագրիչում LootScript-ի մեջ կա չատ՝ AI մոդելով. Опишите словами, какой индикатор нужен, — помощник напишет код прямо в редакторе, скомпилирует его, прогонит на реальных свечах и расскажет, что получилось. Он же правит готовые скрипты, объясняет чужой код и отвечает на вопросы о рынке по данным терминала.

Մոդելը դուք եք ընտրում՝ ամպային՝ ձեր API բանալով, կամ տեղական՝ ձեր համակարգչի վրա. հարցումները ուղարկվում են տերմինալից ուղղակի ընտրված պրովայդերին, LootX սերվերները միջնորդ չեն:

Ինչպես բացել օգնականը

  1. Սեղմեք ƒ գրաֆիկի վահանակում — բացվում է Ինդիկատորներ պատուհանը.
  2. Սեղմեք Խմբագրիչ… որոնման տողչի կողքին կամ բացեք ձեր սկրիպտը.
  3. Խմբագրիչի վերին վահանակում, Ավելացնել գրաֆիկին կողքին սեղմեք Օգնական.

Չատը կգտնվի կոդի աջ եկող կողքին։ Սահմանը կարելի է քաշել՝ փոխել լայնությունը։ Չատի վերնամասում գտնվող խաչը (Չատը թաքցնել) կհանի այն՝ չմաշեցնելով զրույցը; նորից սեղմելով Օգնական։

Մոդելին միացում

Բացեք միացման քարտը

Առաջին հարցադրման դեպքում քարտը կբացվի ինքնուրույն։ Հետագայում այն կարելի է կանչել կարգավորումների ատամնանիվով՝ API բանալի և միացում չատի վերնամասում։

Ընտրեք պրովայդերին

Ցանկը՝ ստորև աղյուսակում։ Լռելյայն ընտրված է Claude։

Մուտքագրեք API բանալին

Տարբերակի տակ կա հղում Получить ключ на … — այն տանում է պրովայդերի անձնական գրասենյակ։ Պաշտպանված բանալին դաշտում չի ցուցադրվում. թողեք դաշտը դատարկ՝ չփոխելու համար, կամ սեղմեք Удалить ключ։

Ստուգեք մոդելը և պահեք

Модель դաշտը լրացված է լռելյայն մոդելով, հուշումներում՝ մի քանի այլ տարբերակներ։ Անվանումը կարելի է գրել այնպիսի, ինչպիսին ճանաչում է պրովայդերը։ Սեղմեք Сохранить։

Պրովայդեր Ինչ է պետք
Claude Anthropic-ի API բանալին։ Claude-ի թեման (subscription) չի հարմարում՝ Anthropic-ը արգելում է երրորդ կողմի ծրագրերի մուտքը դրա միջոցով։
Gemini Google-ի API բանալին։ Gemini-ի subscription-ն էլ նույն պատճառով չի աշխատում։
OpenAI, DeepSeek, Grok, Mistral, Qwen, Kimi, GLM, Groq Պրովայդերի API բանալին։
OpenRouter OpenRouter բանալին՝ որի միջոցով հասանելի են տարբեր ընկերությունների մոդելները։
Ollama, LM Studio Բանալի պետք չէ՝ մոդելը աշխատում է ձեր սարքի վրա։ Հարցեք տեղական սերվեր, ներբեռնեք մոդելը և գրեք նրա անունը։
Совместимый с OpenAI Ամենայն տեսակի սերվերներ՝ որոնք տրամադրում են OpenAI Chat Completions ֆորմատով API: шлюз, vLLM, կամ կորպորատիվ պրոքսի. տրամադրեք հասցեն (սովորաբար заканчивается на /v1), մոդելը և բանալին, եթե անհրաժեշտ է։

Ամպային հարցումները վճարվում են ձեր պրովայդերի հաշվի միջոցով, առանձին LootX-ից։ Յուրաքանչյուր պատասխանից հետո չատում ցուցադրվում է, քանի տոկեն օգտագործվեց մուտքո՞ւմ եւ ելքո՞ւմ։

Տեղական մոդելին անհրաժեշտ է tool calling աջակցություն։ Վերոհիշյալը չլինի՝ օգնականը չի կարող գրեյ գրել խմբագրիչում և չի կատարի ստուգումներ։

Պրոքսի և սեփական հասցեն

Եթե պրովայդերի ծառայությանը ձեր ցանցից ուղղակի մուտք չկա, նշեք պրոքսի տող՝ Պրոքսի դաշտում — http://host:port կամ socks5://լոգին:գաղտնաբառ@host:port. Պրոքսին ընդհանուր է բոլոր պրովայդերների համար։ API հասցե (ձեր шлюզի համար) դաշտը պետք է միայն այն դեպքում, եթե դուք գնում եք պրովայդերի միջոցով ձեր սեփական шлюզով։

Ինչ գիտի օգնականը

  • Գրում է նոր սկրիպտ ըստ նկարագրության և անմիջապես տեղադրում է կոդը խմբագրիչում։
  • Ուղղում է պատրաստի — կետային ուղղումներ՝ առանց ֆայլը ամբողջությամբ վերամշակելու։
  • Ստուգում է ինքն իր աշխատանքը. Կոմպիլացնում է կոդը և կկատարի այն իրական մոմեր վրա — լռելյայն՝ գրաֆիկի գործիքի և timeframe-ի վրա, մինչև 5000 վերջին բար, ըստ ցանկության ցանկացած ուրիշի վրա։ Տուգրումներում տեսնում է, ինչ արդյունք է ստացվել յուրաքանչյուր տողում և կա՞ արդյոք կատարողական սխալ։
  • Ավելացնում է սկրիպտը գրաֆիկին, երբ խնդրեք։
  • Պատասխանում է շուկային վերաբերող հարցերին. վերցնում է ցանկացած գործիքի մոմերը տերմինալից, screener-ի մետրիքները (volatility, ծավալ, open interest, funding rate, spread) և կարգավորում է շուկան՝ «Որ ֆյուչերսներն են հիմա առավել volatility?»։
  • Համեմատում է լեզվի ուղեցույցի հետ, դիտարկում է տեղադրված Ինդիկատորներ-ին և ձեր գրադարանի սկրիպտները։

Յուրաքանչյուր քայլ երևում է time and sales՝ տողով, օրինակ՝ «Կոմպիլացնում եմ», «Լրացրել եմ մոմերի վրա», «Խմբագրում եմ կոդը»։ Եթե մոդելը ցուցադրում է մտածողության ընթացքը, այն ցրված է բլոկով՝ Մտքի ընթացք. պատասխանը կարելի է կանգնեցնել Դադարեցնել կոճակով։

Այն պատվեց, ինչ օգնականը գրում է խմբագրիչում, կարելի է չեղյալ համարել սովորական Ctrl+Z-ով։ Եթե պատասխանով ստացել եք կոդ բլոկով, նրա վերնամասում կան կոճակներ. ամբողջ սկրիպտի համար՝ Խմբագրիչ — կոդը փոխարինելու համար խմբագրիչում, ֆրագմենտի համար՝ Տեղադրել կուրսորի դիրքում։ Երկու դեպքում էլ կա Պատճենել։

Արագ հրամաններ

Մուտքագրեք / հաղորդման դաշտում — կհայտնվի հուշում։ Նույն հրամանները հասանելի են նաև կոճակներով դատարկ չատում։ Տեքստը հրամանից հետո է ձեր մանրամասումը, օրինակ՝ /fix նայիր ծավալին.

Հրաման Ինչ է անում
/fix Հարցնում է և շտկում սխալները. կոմպիլացնում է, գործադրում մոմերի վրա, շտկում է կատարման սխալները և տողերը, որտեղ միայն na է մնում։ Պահպանում է ձեր գաղափարը և ոճը, վերջում перечисляет կատարված փոփոխությունները։
/explain Պարզ լեզվով բացատրում է, թե ինչ есепում է սկրիպտը, ինչ ազդեցություն ունեն յուրաքանչյուր պարամետրը, ինչ է այն պատկերի եւ ինչպես կարդալ իր ազդակները։ Կոդը չի փոխում։
/optimize Արագացնում է սկրիպտը՝ չփոխելով արդյունքը. փոխարինում է ձեռագրային ցիկլերը պատրաստ ֆունկցիաներով, հեռացնում ավելորդ աշխատանքը և ստուգում прогоном, որ արժեքները չեն փոխվել։

Այն ամենը, ինչ այլ բառ է գալիս косой-ի հետո, փոխանցվում է մոդելին որպես սովորական հարց։

Պատկերներ և գրաֆիկի սկրինշոթներ

Հարցին կարելի է կցել պատկեր՝ սեղմումով սկրիպչի նշանի նման կոճակը ներբեռնման դաշտի տակ, բանակցելով Ctrl+V-ով կամ քաշելով ֆայլը չատի դաշտին։ Գրաֆիկի պատկերով կոճակը կցում է այն պանիայի նկարն, որի վրա ավելացվում է սկրիպտը։ Մեկ հարցով թույլատրելի է մինչև վեց պատկեր: մեծերը նախապես սեղմվում են։

Ոչ բոլոր մոդելները տեսնում են պատկերներ։ Եթե ընտրված մոդելը չի տեսնում նկարները, չատը նախազգուշացնում է նախքան հղումը ուղարկելը։ Եթե տերմինալը չգիտի՝ տեսնու՞մ է մոդելը պատկերները, և պրովայդերը մերժում է հարցը, պատկերները վերադարձվում են տեքստի դաշտ։

Խոսակցության պատմությունը

Խոսակցությունը կապված է սկրիպտի հետ. բացեք այլ սկրիպտ՝ յուրաքանչյուրի համար իր զրույցն է։ Փակեք խմբագրիչը կամ վերագործարկել տերմինալը՝ զրույցը կմնա։

  • Աչքի տակ գտնվող՝ դեռ չպահպանված սկրիպտի զրույցը չի գրանցվում սկիզբում։ Այն կհիշվի սկրիպտը առաջին անգամ Պահպանել սեղմելիս։
  • Նոր չատ նշանը վերնամասում սկսում է զրույցը նորից և ջնջում է նախկինը գրգռելային սկավառակից։
  • Եթե ջնջել եք սկրիպտը՝ նրա զրույցն էլ ջնջվում է։
  • Пока օգնականը պատասխանում է, այլ սկրիպտ բացել հնարավոր չէ՝ նախապես կանգնեցրեք պատասխանը։

Ճիշտ այն է, որ ամբողջ զրույցը փոխանցվում է մոդելին յուրաքանչյուր հարցի հետ, այդ պատճառով երկար չատը գանձվում է։ Զրույցի չափը տոկեններով ցույց է տրվում չատի վերնամասում՝ օրինակ՝ «42k». Սեղմեք դրա վրա՝ որպեսզի զրույցը սեղմվի ամփոփման մեջ՝ այսուհետ օգնականը կհիշի այն ըստ այդ ամփոփման։ Հին ստուգումների արդյունքները և պատկերները տերմինալը ինքնաբերաբար կսեղմի։ Հիշված պատմությունում հին պատկերները ժամանակի ընթացքում կփոխարինվեն նշումով՝ «Картинка к этому вопросу больше не хранится»։

Ի՞նչ է ուղարկվում համակարգչից

Ընտրված պրովայդերին՝ ուղղակի.

  • ձեր հաղորդագրությունները և կցված պատկերները;
  • սկրիպտի անունը, տողերի քանակը և սխալները, գրաֆիկի գործիքը և timeframe-ը — յուրաքանչյուր հարցի ժամանակ;
  • խմբագրիչից կոդը և կոմպիլյատորի զեկույցը — երբ օգնականը կարդում կամ ուղղում է սկրիպտը;
  • տվյալները, որոնք օգնականը խնդրում է՝ մոմեր, screener-ի մետրիկաները, прогонов-ի արդյունքները, լեզվի փաստաթղթավորման ֆրագմենտները։

Չի ուղարկվում.

  • Գաղտնիքներ. Օգնականը չի տեսնում բորսաների բանալիները։ Պրովայդերի API բանալին պահվում է այս համակարգչում կոդավորված տեսքով, չի մտնում կարգավորումների սինխրանիզացիայի մեջ և ուղարկվում է միայն պրովայդերի ինքնությանը հաստատելու համար։ Տերմինալը նախապես հանում է մոդելին տրվող տեքստից ամեն ինչ, որն նման է բանալիի, տոկենի կամ գաղտնաբառի, ինչպես նաև սկավառակի ֆայլերի ուղիները։ Եթե դուք ինքներդ եք մի հաղորդագրության մեջ դնում բանալիին նման բան, այն չի ուղարկվի — չատը կխնդրի հեռացնել գաղտնիքը։
  • Հաշիվ։ Օգնականը չունի մուտք բալանսին, դիրքերին և հայտերին — նա տեսնում է միայն այն, ինչ ցույց եք տվել սարքի նկարում։ Այլ խոսքով՝ հայտեր ավանդственно նրան չեն կարող դրվեցնել։
  • Չատի պատմությունը. Ներկա զրույցը գտնվում է այս համակարգչում, կոդավորված և չի մտնում սինխրանիզացիայի, չի արտահանվում կարգավորումների մեջ և չի ուղարկվում աջակցության զեկույցին։

Ollama կամ LM Studio-ի դեպքում զրույցն ու կոդը չեն покидают համակարգիչը։

Սահմանափակումներ

  • Թեստային пробеге չկա հոսքային տվյալներ. footprint cluster-ները, delta, open interest, funding rate, order book, time and sales, screener և order book-ի պատմությունը մոմերի վրա փորձարկելիս հավասար են na. Լոգիկան, որը կախված է այս տվյալներից, օգնականը չի կարող ստուգել — ավելացրեք սկրիպտը գրաֆիկին և ստուգեք ինքներդ։
  • Քայլերի սահման. Մի պատասխանում օգնականը չի անում ավելի քան 24 քայլ, ապա տալիս է ամփոփում։ Եթե պատասխանն ընդհատվեց երկարությամբ, կարելի է խնդրել շարունակել։
  • Մոդելը սխալվում է. Прогոնը բռնում է կոմպիլյացիոն և գործարկման սխալները, բայց չի բռնի մտքի սխալները։ Նախքան ազդակներին վստահելը՝ նայեք սկրիպտը գրաֆիկի վրա։
  • Պրովայդերի մերժումներ. Չատը ցուցադրում է տեքստով պրովայդերի անունով՝ բանալին ընդունված չէ, հարցումների լիմիտը समाप्तվել է, հաշվին գումար չի մնացել կամ կվոտա, կապ չկա կամ տեղական սերվերը չի պատասխանում։ Ընթացքը՝ ստուգեք ինտերնետը կամ նշեք պրոքսի։

Դրանից հետո

https://docs.lootx.trade/hy/loot/ai-assistant

Основы

10Pine Script-ից ներմուծում

Ինչպես տեղափոխել ինդիկատորը Pine Script-ից LootScript՝ որտեղ է ներմուծման կոճակը, ինչ է կոնվերտերը ինքնուրույն փոխում, ինչը նշում է վերանայման համար և ինչպես վերջնականացնել արդյունքը.

Եթե ինդիկատորը արդեն գրված է Pine Script-ով, ձեռքով վերագրել այն հարկ չի լինի. տերմինալը կոնվերտացնում է .pine ֆայլը в LootScript՝ փոխելով սինտաքսը և անունները, ավելացնում բացակայող հատվածները և ֆայլի սկզբում գրում է նշումներ՝ ինչ է փոխվել եւ որտեղ կոնվերտերը ստիպված էր գուշակել.

Կոնվերտերը թարգմանիչ է, ոչ համատեղելիության շերտ. այն չի երաշխավորում նույն թվերը, ինչ սկզբնական среда-ն, եւ չի ավելացնում տերմինալում չկան ֆունկցիաները. այդ պատճառով ներմուծումից հետո բացեք սկրիպտը, կարդացեք նշումները եւ ստուգեք այն գրաֆիկի վրա. LootScript-ը անկախ մշակված լեզու է եւ կապ չունի TradingView-ի հետ՝ սինտաքսը դիտմամբ նման է, բայց լեզուները համատեղելի չեն.

Ինչպես ներմուծել

Բացեք Ինդիկատորներ պատուհանը

Սեղմեք ƒ գրաֆիկի վահանակի վրա — կբացվի Ինդիկատորներ պատուհանը.

Սեղմեք «Ներմուծում…»

Կոճակը գտնվում որոնման տողի մոտ. Ընտրեք .pine, .loot կամ .txt ֆայլ. .loot ֆայլը կընթանա գրադարան՝ ինչպես կա. .pine ֆայլը (կամ տեքստային ֆայլը, որը նման է Pine Script-ին) կանցնի կոնվերտերի միջով.

Կարդացեք արդյունքը

ՈՒղղակիորեն որոնման տողի տակ կհայտնվի մեկը հետևյալ տողերից:

  • «Ներմուծված «…»» — նշումներ չկան, սկրիպտը պատրաստ է;
  • «Ներմուծված «…»: կոնվերտերի նշումներ — N, տես. սկրիպտի վերնամասը»;
  • «Ներմուծված «…», բայց սկրիպտը չի կոմպիլացվում (սխալներ: N)…» — առաջին սխալի տեքստի կողքին.

Պատուհանը կփոխվի դեպի բաժին Իմ скрипտները, իսկ որոնման դաշտում կհայտնվի նոր սկրիպտի անունը.

Բացեք սկրիպտը Խմբագրիչում

Կարդացեք վերնամասի նշումները եւ շտկեք այն, ինչն ցույց է տալիս: ինչպես նշված է ստորեւ.

Ներմուծումը չի վերագրագրում նույն անունով գոյություն ունեցող սկրիպտը՝ նորին կտրամադրվի սուֆիքս, օրինակ -2. Նախնական ֆայլը չի փոխվում.

Սկրիպտների թղթապանակի միջոցով

Դուք կարող եք պարզապես տեղադրել имя.pine ֆայլը սկրիպտների թղթապանակում — Windows-ում դա %APPDATA%\TradingTerminal\scripts. Հաջորդ մեկնարկի ժամանակ տերմինալը կստեղծի հարակից имя.loot. Եթե имя.loot արդեն կա, այն չի փոխվի — ձեր ուղղումները չեն կորչի. նորից կոնվերտակայելու համար (օր.՝ տերմինալի թարմացումից հետո) հեռացրեք .loot և թողեք .pine.

Ինչ է կատարում կոնվերտերը

  • Աղքատված ինդենտացիաններ → փակագծեր. if, else if, else, ցիկլերի եւ ֆունկցիաների բլոկները ստանում են {}. շարունակական տողերը միացվում են մեկ տողի.
  • Ֆունկցիաներ. f(x) => դառնում է func f(x), իսկ ֆունկցիայի վերջին արտահայտությունը վառեցվում է որպես ցուցադրված return.
  • Ցիկլներ. for i = 0 to 9 դառնում է կիսաբաց for i in 0 .. 10. Ուղղությունը որոշվում է քայլից կամ սահմանների լիտերալներից; եթե դա ցույց չունի, կոնվերտերը համարում է ցիկլը աճող և նշում է դա.
  • Պայմանական արտահայտություններ. if-ը, եթե ճյուղերի մեջ միայն մեկ արտահայտություն կա, փոխվում է տեռների (?:) տեսքի; switch-ը ստանում է փակագծեր.
  • Թափանցիկություն → ալֆա. Pine Script-ում թափանցիկությունը 0…100 է, որտեղ 0-ը — ոչ թափանցիկ. LootScript-ում ալֆան 0…255 է, որտեղ 255-ը — ոչ թափանցիկ. color.new(c, 50) կդառնա color.new(c, 128), իսկ transp= արգումենտը մտցվում է color.new(…)-ի մեջ:
  • Անուններ. Անչափավոր ֆունկցիաների՝ namespace-ը չունեցող անունները ստանում են namespace-ը. sma → ta.sma. study → indicator, security → request.security, tostring → str.tostring, syminfo.* → sym.*, timeframe.* → tf.*. Կարճ input(…) ձևը ստանում է տիպ՝ input.int, input.source և այլն.
  • Ցուցված անուններ. Զգուշացեք այն փոփոխված անուններից, որոնց LootScript-ում անունը բանալիչ-բառ է կամ namespace (delta, oi, tf, sym, func …). Նաև նման փոփոխված փոփոխվողը կստանա ստորակետ ‘_’ վերջում՝ օրինակ delta → delta_.
  • Անպետք արգումենտներ. Պարամետրեր, որոնցը LootScript ֆունկցիայում չեն, հեռացվում են.
  • Հայտարարություն. Եթե ֆայլում չկար indicator(…) կամ strategy(…), կոնվերտերը կավելացնի indicator՝ ֆայլի անունով.
  • Մեկնաբանություններ եւ դատարկ տողեր մնում են իրենց տեղերում.

Կոնվերտերը չի մերժում որևէ ֆայլ. տողը, որը նա չի հասկացել, չի ջնջվում, այլ թողնվում է որպես մեկնաբանություն // [не разобрано] … նույն տեղում.

Վերնամասի նշումներ

Վերնամասի առաջին տողը նշում է ֆայլի ծագումը՝ «Импортировано из скрипта на Pine Script (версия 5). Заметки конвертера:». Հետո յուրաքանչյուր փոփոխության համար մեկ տող՝ ըստ աղբյուրային ֆայլի տողերի թվի՝ «Строка N: вид: что — подробности». Նշումները գրվում են ինտերֆեյսի լեզվով.

Նշման տեսակ Ինչ է նշանակում Պետք է ստուգել?
վերանվանված Անունը փոխարինվել է LootScript-анալոգով ոչ
հաշվարկված Թափանցիկությունը վերածվել է ալֆայի ոչ
վերագրված Մարկափն օգտագործված է այլ ձեւով՝ ցիկլ, return, կարճ input տիպ դիտել
անունը «…» զբաղված է LootScript-ում Փոփոխականին ավելացվել է ստորակետ ոչ
indicator(…) հայտարարություն չի եղել Հայտարարությունը ավելացվել է ֆայլի անունից ոչ
պարամետրը հանված է LootScript ֆունկցիայում նման պարամետր չկա այո
գուշակում Կոնվերտերը ենթադրել է՝ ցիկլի ուղղություն, ինփութ-տիպ եւ այլն այո
այս build-ում չկա Արդյունքում կան կանչեր, որոնք այստեղի build-ում բացակայում են — սկրիպտը չի կոմպիլացվի unknown name սխալի հետ այո
չվերծված Տողը չի վերծանվել, թողնվել է որպես մեկնաբանություն այո

Երբ ստուգումը ավարտեք, վերնամասը կարելի է ջնջել — դա սովորական մեկնաբանություններ են.

Օրինակ

Նփոքր ինդիկատոր Pine Script-ով՝ բարի տատանման սյունակներ, որոնք լուսավորվում են երբ տատանումը առնվազն կրկնակի է միջինի նկատմամբ.

PINE
//@version=5
indicator("Range spike", overlay=false)
len = input.int(20, "Length")
avgRange(n) =>
    r = high - low
    ta.sma(r, n)
base = avgRange(len)
spike = high - low > base * 2
plot(high - low, style=plot.style_columns, color=spike ? color.orange : color.new(color.gray, 60))
plot(base, color=color.blue, trackprice=true)

Իսկ կոնվերտերը այն գրում է այսպես՝

Loot
// Импортировано из скрипта на Pine Script (версия 5). Заметки конвертера:
//
// Строка 6: переписано: avgRange — неявный возврат последнего оператора записан как return
// Строка 9: пересчитано: transp → alpha — прозрачность 0…100 пересчитана в альфу 0…255
// Строка 10: аргумент снят: plot: trackprice — такого параметра в LootScript нет

indicator("Range spike", overlay = false)
len = input.int(20, "Length")
func avgRange(n) {
    r = high - low
    return ta.sma(r, n)
}
base = avgRange(len)
spike = high - low > base * 2
plot(high - low, color = spike ? color.orange : color.new(color.gray, 102), style = plot.style_columns)
plot(base, color = color.blue)

Ֆունկցիան ստացավ փակագծեր եւ return, թափանցիկությունը 60 դարձավ ալֆա 102, իսկ trackprice արգումենտը հեռացվեց — նման պարամետրը չկա: նշումը «պարամետրը հանված է» խնդրում է ստուգել՝ արդյոք այդ պարամետրը դատարկ չէր ըստ իմաստի. այստեղ այն պարզապես նկարում էր վերջին արժեքի գիծը, և սկրիպտը աշխատում է առանց դրա.

Ինչպես ստուգել եւ կատարել լրացումներ

  1. Կարդացեք վերնամասը. Սկսեք այն տողերից, որոնք նշված են պարամետրը հանված է, գուշակում, այս build-ում չկա եւ չվերծված տեսակներով.
  2. Դիտեք Խմբագրիչի կոնսոլի ներդիրի՝ «Խնդիրներ». Սխալներով սկրիպտը գրաֆիկին չի ավելացվի.
  3. Ավելացրեք գրաֆիկին և համեմատեք այն, ինչ ցույց էր տալիս բնօրինակը, պատմության մի քանի հատվածներում.
  4. Խնդրեք օգնականին. Բացեք ИИ-помощника եւ գրեք /fix — նա կոմպիլացնում է սկրիպտը, կընդգրկի այն մոմերի վրա և կաշխատի սխալների ուղղման վրա. Можно добавить уточнение: /fix разбери заметки конвертера в шапке. Կարելի օգտագործել /explain՝ որպեսզի պարզեն, թե ինչ է անում սկրիպտը.

Ինչ չի տեղափոխվում

  • Ֆունկցիաներ, որոնք տերմինալում չկան. Անունը մնում է կոդում, նշումը այս build-ում չկա ու կոմպիլյացիայի սխալը ցույց են տալիս նույն տեղը. փոխարինեք կանչը ձեռքով կամ խնդրեք օգնականին առաջարկել անալոգ:
  • Բազմատող տողեր, այլ գրադարանների ներմուծում, ֆունկցիաների արտահանում. Կոնվերտերը տեղափոխում է այն, ինչը կարող է գրի դնել, եւ նշում է մնացածը.
  • Ավել քան երեք գծիկ. Գրաֆիկի վահանակը նկարում է միայն սկրիպտի առաջին երեք plot-երը. հավելյալ գծերը բաժանեք տարբեր սկրիպտների մեջ.
  • Նկատական առեւտուր. strategy(…) հայտարարությունը տեղափոխվում է, բայց LootScript-ի ստրատեգիան առեւտուր է անում միայն Ստրատեգիայի թեստեր — սիմուլյացված հաշվով.

Շարունակել

https://docs.lootx.trade/hy/loot/pine-import

Справочник

11Կոմպիլյացիայի և կատարման սխալներ

Բոլոր LS կոդերը, որոնք ցույց են տալիս Խմբագիրը և գրաֆիկը՝ հաղորդման տեքստը, պատճառը և շտկման եղանակը, հաճախակի սխալների օրինակներ, կատարման սահմաններ և դեպքեր, երբ սխալի փոխարեն ստացվում է na։

Յուրաքանչյուր հաղորդագրություն կոմպիլյատորի և LootScript-ի կատարողի կողմից սկսվում է LS2008 տիպի կոդով։ Կոդը չի փոխվում տարբերակների շնորհիվ և չի կախված ինտերֆեյսի լեզվից, այդ պատճառով հեշտ է դրա միջոցով որոնել։ Այստեղ հավաքված են բոլոր կոդերը, որոնք կարող է ցույց տալ տերմինալը՝ հաղորդման տեքստով, պատճառով և շտկման եղանակով.

Հաղորդագրությունները ցուցադրվում են ռուսերեն՝ եթե տերմինալի ինտերֆեյսը ռուսերեն է, և անգլերեն՝ ցանկացած այլ լեզվի դեպքում։ Ստորև՝ առաջինը—հաճախ հանդիպող սխալները, այնուհետ՝ կատարման սխալները և ավարտում՝ ամբողջական աղյուսակը։

Որտեղ են երևում սխալները

Կոմպիլյացիայի ժամանակ. Խմբագիրը կոմպիլացնում է სკրիպտը ամեն տիպի հավաքման կանգում։ Մինչև գտնվածը հայտնվում է «Խնդիրներ» թաբում խմբագրիչի ստորին մասում՝ կոդով, տեքստով և դիրքով՝ «Стр 6:6» տեսքով։ Տողի վրա երկակի կտտոցը տեղափոխում է կուրսորը սխալի տեղը։ Խմբագրիչի վերնագրում արտացոլվում է ամփոփը՝ «ок · 12 мс», «предупреждений: 2» կամ «ошибок: 1»։

Կատարման ժամանակ. Կոմպիլյացիոն սխալներ չպահպանող սկրիպտը կարող է կանգնել որոշ բարի վրա՝ օրինակ՝ եթե գործողությունների բյուջեն վերջացել է, ինդեքսը вышел за границы массива կամ անհայտ է գործիքը։ Այդ դեպքում «Արդյունք» թաբում կհայտնվի տող՝ «Սկրիպտը կանգնեցվել է՝ LS6004: …», և նույն պատճառը կտեսնեք Ստրատեգիայի թեստեր պատուհանում։ Մյուս սկրիպտները, վահանակները և ինքն տերմինալը շարունակվում են աշխատել։

Դիագնոստիկան ունի երեք մակարդակ՝

Մակարդակ Ի՞նչ է նշանակում Ի՞նչ է կատարվում գրաֆիկում
Սխալ Սկրիպտը չի համակերպվել Սկրիպտը գրաֆիկ չի ավելացվում: «Սկրիպտը սխալներով գրաֆիկ չի ավելացվում — siehe Խնդիրներ». Եթե սկրիպտը արդեն գրաֆիկների վրա է՝ այնտեղ կմնա նախկին աշխատանքային տարբերակը
Նախազգուշացում Սկրիպտը համարվել է, բայց արդյունքը կարող է խաբել, օրինակ՝ այն կարող է փոփոխվել կենդանի բարի վրա Սկրիպտը աշխատում է
Սведение Սկրիպտը համարվել է, բայց իր որոշ կարգավորումներից մեկը ոչինչ չի անում Սկրիպտը աշխատում է

Ինչպես դասավորվում են կոդերը

Կոդեր Փուլի անվանում Ի՞նչ մասին է
LS0001–LS0009 Տեքստի ընթերցում Նիշեր, տողեր, թվեր, գույներ, #version դիրեկտիվ
LS1000–LS1012 Պարսում Սառիչներ, բլոկներ, օպերատորների կարգ, սկրիպտի հայտարարություն
LS2000–LS2030 Տիպեր և անուններ Անհայտ անուններ, տիպեր, արգումենտներ, na
LS3000–LS3033 Ծրագրի իմաստ ta.* ճյուղերում, ռեկուրսիա, ստրատեգիաներ, գրադարաններ, request.security
LS4000–LS4009 Կոմպիլյացիայի սահմաններ Զգալի թվով σειրեր, արտանետումներ, կանչեր
LS5000–LS5013 Պերերիսովկա և թեստերի ազնվություն Ամբողջություններ, որոնք պատմության վրա կտարբերվեն կենդանի ժամանակից
LS6000–LS6036 Կատարում Բյուջեներ, ինդեքսներ, կոլեկցիաներ, տողեր, գրաֆիկական օբյեկտներ
LS0999 Ներքին ձախողում Կոմպիլյատորի սխալ — անհրաժեշտ է հայտնել աջակցությանը

Հաճախ հանդիպող կոմպիլյացիոն սխալներ

LS1009 — սկրիպտի հայտարարություն չկա

«Нет объявления скрипта — начните с indicator(“Название”)». Ֆայլի առաջին օպերատորը պետք է լինի indicator(...), strategy(...) կամ library(...)։ Այդ նույն սխալը տալիս է, եթե հայտարարությունն ունի, բայց դրանից վեր ինչ-որ բան է գրված։ Հաշմանդամները և #version 1 դիրեկտիվը չեն խանգարում։

Loot
// Так нельзя: объявление не первое
len = input.int(14, "Длина")
indicator("RSI")
Loot
indicator("RSI")
len = input.int(14, "Длина")

Ֆայլում երկրորդ հայտարարությունը տալիս է LS1008՝ մի սկրիպտին թույլատրվում է միայն մեկը։

LS2002 — անհայտ անուն

«Неизвестное имя «…» — проверьте написание или объявите его выше». Հաճախ դա տպագրական սխալ է կամ ֆունկցիան կանչվել է առանց namespace-ի։ Բոլոր ինդիկատոր ֆունկցիաները գտնվում են ta-ում, մաթեմատիկականը — math-ում, գույները — color-ում։

Loot
avg = sma(close, 20)
Loot
avg = ta.sma(close, 20)

Նույն սխալը կգտնվի, եթե փոփոխականը կարդացվեց այն տողից վեր։ Լրիվ անունների ցուցակը՝ ֆունկցիաների ուղեցույցում։

LS2008 — na-ով համեմատում

«Сравнение с na всегда ложно — используйте na(x)». Ինչպիսի նիշով էլ լինի na-ի համեմատությունը (==, !=), այն միշտ տալիս է false, ուստի կոմպիլյատորը արգելում է նման գրել։

Loot
x = ta.sma(close, 50)
plot(x == na ? close : x)
Loot
x = ta.sma(close, 50)
plot(na(x) ? close : x)

Կարճ տարբերակը?? է՝ plot(x ?? close)։

LS2014 — արժեքը փոխվում է բար-բար այնտեղ, որտեղ պետք է լինի կոնստանտ

««…» в «…» требует значение не слабее input, а передано series — возьмите input.*(…) или литерал». ta.*-երի համար պատուհանի երկարությունը պետք է հայտնի լինի մինչ առաջին բար։ Բարերով ընտրվող երկարությունը չի անցնում։

Loot
len = close > open ? 10 : 20
avg = ta.sma(close, len)

Համեմատեք երկու տարբերակները և ընտրեք արդյունքը, ոչ թե երկարությունը՝

Loot
fast = ta.sma(close, 10)
slow = ta.sma(close, 20)
avg  = close > open ? fast : slow

Եթե երկարությունը պետք է օգտագործողի կողմից տրվի, վերցրեք այն input.int(...)-ից։

LS3004 — ta.* կանչը կախված է ճյուղի փոփոխականից

«Аргумент «…» нельзя вычислить вне ветки — вынесите вызов ta.* на верхний уровень». ta.* ֆունկցիաները հիշում են անցյալ բարի տվյալները, ուստի կոմպիլյատորը դրանց հաշվարկը անում է յուրաքանչյուր բարի համար, նույնիսկ եթե կանչը հանգեցված է if-ի ներսում։ Եթե արգումենտը հայտարարված է միայն ճյուղի ներսում, այն մյուս բարի վրա չի լինի։

Loot
var float avgBody = na
if close > open {
    body = close - open
    avgBody := ta.sma(body, 10)
}
Loot
body    = close - open
avgBody = ta.sma(body, 10)

LS2017, LS2007, LS1006 — տողեր, պայմաններ և համեմատություններ

Այս երեք սխալների ընդհանուր պատճառը՝ LootScript-ը չի կատարում տիպերի լռելյայն կոնվերտացիա։

Կոդ Հաղորդագրություն Ինչպես շտկել
LS2017 «Строку нельзя складывать с числом (… + …) — используйте str.tostring(…)» "RSI " + str.tostring(r) փոխարեն "RSI " + r
LS2007 «Условие должно быть bool, а здесь …» if volume > 0՝ ոչ թե if volume — թվերին «ճշմարտականություն» չի վերագրվում
LS1006 «Сравнения не сцепляются — напишите a < b and b < c» low < close and close < high փոխարեն low < close < high

LS2018 և LS2019 — անունը արդեն զբաղված է

««…» уже объявлено в этой области» (LS2018) — փոփոխականը հայտարարվել է երկրորդ անգամ =-ով։ Մնա փոփոխականը փոխելու համար օգտագործեք :=։

Loot
level = high
level := low

««…» затеняет встроенное имя — выберите другое» (LS2019) — փոփոխականը, ֆունկցիան կամ տիպը անվանվել է այնպես, ինչպես built-in շարքը կամ ֆունկցիան՝ close, time, hour, volume. Փոխանակեք անունը՝ օրինակ startHour։ Տարածքային անուններ նման color կամ position կարելի է օգտագործել փոփոխականների անվան համար։

LS2004 և LS2005 — կանչի արգումենտները

««…» ожидает … аргумент(ов), а передано …» (LS2004) և «У «…» нет параметра «…»» (LS2005). Սովորեք կանչի signature-ները ֆունկցիաների ուղեցույցում: արգումենտների անունները և քանակը պետք է համապատասխանեն։

Loot
plot(close, colour = color.red)
Loot
plot(close, color = color.red)

LS3011 և LS5011 — ստրատեգիաներ

«strategy.* доступно только в strategy(…)» (LS3011): հայտերն ու դիրքի վիճակը հասանելի են միայն այն սկրիպտների համար, որոնք հայտարարված են strategy(...)-ով։ Փոխարինեք indicator("…")-ը strategy("…")-ով։

«Стратегия читает «…»: у order book և time and sales տվյալների պատմություն չկա, բեքթեստը կլինի շեղում» (LS5011): Ստրատեգիան իջնում է պատմության վրա, իսկ book.* և tape.* տվյալներին պատմություն չկա — անցյալ բոլոր բարերին այնտեղ na է։

Loot
strategy("Перекос стакана")
if book.imbalance(10) > 0.5 {
    strategy.entry("L", strategy.long)
}

Պատմության համար order book-ի արժեքները վերցրեք depth տարածքից՝ այնտեղից ստացված արժեքները հասանելի կլինեն պատմության յուրաքանչյուր բարի համար։

Loot
strategy("Перекос стакана")
if depth.imbalance(1.0) > 0.5 {
    strategy.entry("L", strategy.long)
}

LS5000–LS5006 — перерисовка-ի նախազգուշացումներ

Այս նախազգուշացումները չեն պատնեշում սկրիպտի աշխատանքը։ Նրանց նպատակն է ասել, որ պատմության վրա գիծը կարող է տարբերվել նրանից, ինչ էր տեսել կենդանի բարը:

  • LS5001 — գրաֆիկին հասնում է արժեք, որը գոյություն ունի միայն կենդանի բարի վրա (barstate.isrealtime, barstate.isnew).
  • LS5000 — գրաֆիկին հասնում է varip-ը՝ այն կուտակում է կենդանի բարի տիկները, որոնք պատմության մեջ չկան։
  • LS5006 — գրաֆիկին հասնում են book.* կամ tape.*՝ պատմության վրա շարքը դատարկ է։
  • LS5003 — request.security-ից ստացվում է վերակարգ timeframe առանց [1]՝ անփակված բարը կարող է փոխվել։
  • LS5002 — lookahead = true request.security-ում՝ պատմության վրա սկրիպտը տեսնում է ապագան։
  • LS5005 — math.random կամ timenow ցուցադրվում են՝ երկու անցում կտան տարբեր գծեր։

Եթե նպատակդ միայն կենդանի առևտուրն է, կարելի է այս նախազգուշացումները թողնել։

LS3016 — կարգավորումը ընդունվել է, բայց ոչինչ չի անում

Սա сведениե է, ոչ սխալ։ Վстречается import-ված կամ այլ փոխանցված սկրիպտներում՝ երբ կարգավորումը պահպանված է համատեղելիության համար, բայց տերմինալում այն ոչ մի ազդեցություն չունի։ Հաղորդագրության երկրորդ մասը բացատրում է պատճառը։

Ինչ է գրված Բացատրություն հաղորդման մեջ
maxBarsBack հայտարարությունում Պատմությունը բեռնվում է ամբողջությամբ շարքով
format, precision, scale հայտարարությունում Տերմինալը կառավարում է արժեքների մասշտաբն ու ֆորմատը
timeframe հայտարարությունում Սկրիպտը հաշվվում է գրաֆիկի timeframe-ով; այլ timeframe-ի համար օգտագործեք request.security
Գծի բարակություն, ոճ կամ այլ ցուցիչներ, որոնք մատակարարեն արտահայտությամբ, ոչ թե կոնստանտով (օր. գույնը կարող է փոխվել բարերով) Այս հավաքածուն այս կարգավորումները կկարդա միայն որպես կոնստանտներ
color չորրորդ և հաջորդ plot-երի համար Վահանակը պատկերում է միայն առաջին երեք շարքերը
location.absolute plotshape կամ plotchar-ում Նշման համար չկա հենվող շարք
display, որը այս շարքի համար չկա Այս շարքը չունի համապատասխան մակերես

Կատարման սխալներ

Կատարման սխալը կանգնեցնում է սկրիպտը այն բարի վրա, որտեղ այն տեղի է ունեցել։ Տեքստը ցույց է տրվում «Արդյունք» թաբում որպես «Սկրիպտը կանգնեցվել է՝ LS6004: …»։

LS6004 և LS6005 — սկրիպտը շատ časa է աշխատում

«Սկրիպտը սպառել է գործողությունների բյուջեն մեկ բարի համար — պարզեցրեք ցիկլը» (LS6004) և «Սկրիպտը գերազանցել է անցման ժամանակի սահմանը» (LS6005). Յուրաքանչյուր բարի համար բյուջեն 2 000 000 օպերացիա է։ Ժամանակի սահմանը նույնպես գործունեություն ունի՝ ամբողջ անցումը պատմության վրա — 2 վայրկյան, մեկ տիկ կենդանի բարի վրա — 20 մս։ Հաճախ պատճառը անսահման ցիկլն է կամ յուրաքանչյուր բարի վրա չափազանց շատ տվյալների համատեղումը։

Loot
var int n = 0
i = 0
while i < 10 {
    n := n + 1
}
Loot
var int n = 0
i = 0
while i < 10 {
    n := n + 1
    i := i + 1
}

LS6002 և LS5004 — ապագայում ընթերցում

Պատմության ինդեքսը x[n] չի կարող բացասական լինել — close[-1] կմիանար հաջորդ բարին։ Եթե բացասական թիվը գրված է ուղղակիորեն, կոմպիլյատորը կպատժի դա անմիջապես (LS5004)। Եթե այն ստացվել է հաշվարկով, սկրիպտը կկանգնի և ցույց կտա «Отрицательное смещение истории — читать буду нельзя» (LS6002) սխալը։ Ինդեքսը, որը գերազանցում է բեռնված բարերի քանակը, չի համարվում սխալ՝ այն վերադարձնում է na։

LS6001, LS6007, LS6019 — կոլեկցիաներ և օբյեկտներ

  • LS6001 «Индекс … вне границ» — array.get, array.set կամ matrix.get կանչը դուրս է մեջտեղից։ Ստուգեք array.size(a)-ը մինչ դիմումը։
  • LS6007 «Обращение к пустому объекту (na)» — կոլեկցիան հայտարարված է, բայց չի ստեղծվել՝ var array<float> a = na, ապա a.push(x). Ստեղծեք այն array.new<float>()-ով։
  • LS6019 «Объект рисования уже удалён или вытеснен по потолку — создайте его заново». Միաժամանակ գոյություն ունեն 500 օբյեկտներ նույն տեսակի; ամենահինը հանում է հին մեկը։ Բարձրացրեք սահմանը maxLinesCount, maxLabelsCount կամ maxBoxesCount հայտարարությունում կամ վերօգտագործեք օբյեկտը set_*-ով։

LS6017 և LS6018 — request.security-ում գործիքն ու timeframe-ը

«Символ «…» неизвестен — проверьте формат «ПЛОЩАДКА:СИМВОЛ» или задайте ignore_invalid_symbol = true» (LS6017) և «Таймфрейм «…» не разбирается — ожидается «5», «60», «4h», «1D», «1W»» (LS6018). Սահմանելով ignore_invalid_symbol = true, անհայտ սիմվոլը կվերադարձնի na՝ ոչ թե կանգնեցում։

Կատարման սահմաններ

Ինչն է սահմանափակված Սահման Կոդը գերազանցման դեպքում
Օպերացիաներ մեկ բարի համար 2 000 000 LS6004
Պատմության / կենդանի բարի անցման ժամանակ 2 ս / 20 մս LS6005
Աղյուսակի տարրեր 100 000 LS6003
Տառապոդում զույգեր 50 000 LS6003
Մատրիցայի տարրեր 1 000 000 LS6003
ta.* պատուհանի երկարությունը 100 000 բար LS6034
Մեկ տողի երկարությունը 100 000 նիշ LS6014
Աղյուսակի բջիջներ 2000 LS6029
Տերմալային դաշտի շերտեր 4 (0-ից մինչև 3) LS6036
Գծային օբյեկտների մեկ տեսակի քանակը 500 ըստ լռելյայն հինը տեղահանվում են
request.security-ում տարբեր «ինստրումենտ + timeframe» զույգեր 8 —
request.security կանչերի քանակը 32 LS4009 կոմպիլյացիայում

Երբ սխալ չկա, բայց արժեք չկա

Ամենա շատ դեպքեր, որոնք մյուս լեզուներում կհանգեցնեին runtime crash-ին, LootScript-ում վերադարձնում են na՝ գրաֆիկը չկոտրելու համար։

  • Արիթմետիկան na-ով վերադարձնում է na: օրինակ close - x՝ եթե x դատարկ է՝ արդյունքը նույնպես դատարկ է։
  • x[n] երբ n թեխն է ավելի մեծ՝ քան պատմության սկիզբը — na.
  • ամբողջ թվով բաժանումի ժամանակ զրոյով բաժանումը — na, իսկ հարմարվող (դիրք ունեցող) բաժանումը չի կանգնեցնում սկրիպտը։
  • book.*, tape.* և screener.* պատմական բարերի վրա — na.
  • footprint cluster-ներ, delta, open interest և order book-ի պատմությունը — na այն բարերի վրա, որտեղ տվյալներ չկան։ Ստուգեք cluster.available, delta.available և հարակից ֆլագները։
  • ta.* առաջին բարերի վրա՝ մինչև պատուհանը լցված է — na。

na գրաֆիկին երբեք չի նկարվում որպես զրո։ Լայն գիծը ընդհատվում է։ Եթե պետք է փոխարինել արժեք, օգտագործեք nz(x), x ?? запасное կամ fixnan(x)։

Բոլոր կոդերը

LS0001–LS0009 և LS0999 — տեքստի ընթերցում

Կոդ Հաղորդագրություն Ի՞նչ անել
LS0001 Անսպասելի նիշ «…» Հեռացրեք այն նիշը, որը լեզվում թույլատված չէ
LS0002 Տողը փակված չէ — ավելացրեք փակող ուղակովորդը նույն տողի վերջում Փակեք մատնանշիչը նույն տողում
LS0003 Բլոկային մեկնաբանությունն փակված չէ — ավելացրեք */ Փակեք /* … */
LS0004 Անծանոթ escape-հաջորդականություն «…» տողում Աջակցվում են \n, \r, \t, \0, \\, \", \' և \u{…}; միայն \-ը կրկնեք
LS0005 Սխալ թվային լիտերալ «…» Ստուգեք թվի ձևը
LS0006 Թիվը «…» չի տեղավորվում տիպում Փոքրացրեք թիվը
LS0007 Սխալ գույնի լիտերալ «…» — սպասվում է #RRGGBB կամ #RRGGBBAA Վերցրեք 6 կամ 8 հեքս հաշվական նիշ
LS0008 Եռանիշ բաժանարար _-ը ստարտի, վերջի կամ կրկնվող դիրքում է Գրեք 1_000_000
LS0009 Սխալ #version դիրեկտիվ — սպասվում է #version <թիվ> առաջին տողում Դոդեք #version 1 առաջին տողում
LS0999 Կոմպիլյատորը չի կարողացել ֆայլը մշակել — սա բիլդի խափանում է, հաղորդեք աջակցությանը Հաղորդեք աջակցությանը՝ կցելով սկրիպտը

LS1000–LS1012 — պարսում

Կոդ Հաղորդագրություն Ի՞նչ անել
LS1000 Անսպասելի: … Ստուգեք տողը ավելորդ նիշերի համար
LS1001 Սպասվում էր «…», բայց հանդիպեց … Հաճախ փակագծերը չկան
LS1002 Սպասվում էր արտահայտություն, բայց հանդիպեց … Հեռացրեք բացասական բանական արժեքների բացակայությունը
LS1004 Սպասվում էր անուն, բայց հանդիպեց … После var, func, . պետք է անուն
LS1005 Սպասվում էր բլոկ ափագծված { }, բայց չկա … Ավելացրեք { … }
LS1006 Համեմատությունները չեն շղթայվում — գրեք a < b and b < c Բաժանել երկու համեմատության մեջ and-ով
LS1008 Երկրորդ հայտարարություն սկրիպտի — մի սկրիպտին թույլատրվում է միայն մեկ հայտարարություն Թողեք միայն մեկը
LS1009 Սկրիպտի հայտարարություն չկա — սկսեք indicator("Название")-ից Առաջին տողի վրա indicator, strategy կամ library
LS1010 Զգալի ներգնա խորըությունը (ավելի քան 64) — տեղափոխեք մի մասը ֆունկցիայի մեջ Բաժանեք արտահայտությունները կամ բլոկները
LS1012 if / for / while մարմինը պետք է լինի { ... } Ավելացրեք {}

LS2000–LS2030 — տիպեր և անուններ

Կոդ Հաղորդագրություն Ի՞նչ անել
LS2000 Տիպերի անհամապատասխանություն: սպասվում էր …, ստացվեց … Հաղորդեք ճիշտ տիպը
LS2001 Չի կարելի վերափոխել …-ը …-ի Վերափոխեք հստակ՝ str.tostring, math.round
LS2002 Անհայտ անուն «…» — ստուգեք հորինումը կամ հայտարարեք այն վերևում Շտկեք տպագրությունը, ավելացրեք namespace (ta.) կամ հայտարարեք վերևում
LS2003 «…» — ոչ ֆունկցիա, կանչել չի կարելի Հեռացրեքալ ()-երը: դա շարք կամ կոնստանտ է
LS2004 «…» սպասում է … արգումենտ(ներ), իսկ տրված է … Ս›հեք signatures-ները ուղեցույցում
LS2005 «…»-ն չունի պարամետր «…» Շտկեք պարամետրերի անունը
LS2006 Արգումենտը «…» փոխանցվում է կրկնությամբ Հեռացրեք կրկնությունը
LS2007 Պայմանին անհրաժեշտ է bool, իսկ այստեղ … Բացահայտեք համեմատությունը՝ x > 0, not na(x)
LS2008 na-ով համեմատությունը միշտ կեղծ է — օգտագործեք na(x) na(x) փոխարեն x == na
LS2014 «…» в «…» պահանջում է input-ի մակարդակի արժեք, բայց փոխանցվել է series — օգտագործեք input.*(...) կամ լիտերալ Լիտերալ կամ input.*-ով փոխանցեք
LS2015 «…» հայտարարված է որպես կոնստանտ — նրան հարցափոխել нельзя; հայտարարեք var-ով input.* կարգավորումները, ցիկլի փոփոխականները և ֆունկցիայի պարամետրերը չեն փոխվում — պատճենեք արժեքը ձեր փոփոխականում
LS2017 Տողը չի կարելի գումարել թվի հետ — օգտագործեք str.tostring(...) str.tostring կամ str.format
LS2018 «…» արդեն հայտարարված է այս առակայությունում Օգործեք := նոր արժեքի համար կամ ընտրեք այլ անուն
LS2019 «…» ծածկում է բիլտին անունը — ընտրեք այլ անուն Փոխանվեք անունը
LS2020 Ճյուղերը տալիս են տարբեր տիպեր: … և … Առաջացրեք երկու ճյուղերը նույն տիպի
LS2021 switch առանց default ճյուղի — ավելացրեք => ... Ավելացրեք => արժեք
LS2022 «…»-ի էլեմենտի տիպը չի ենթադրվում — նշեք այն array.new<float>()
LS2028 Տիպի հայտարարության ֆիլդը «…» չունի տիպ — գրեք այն վրա float price объявления type-ի մեջ
LS2029 export «…»: экспортируемая функция должна иметь объявлены типы всех параметров и результата Ուշադրություն — նշեք բոլոր տիպերը
LS2030 «…» в «…» читается до первого бара — нужен литерал или именованная константа Հայտարարություններում թույլատրվում են միայն կոնստանտ արժեքներ

LS3000–LS3033 — ծրագրի իմաստ

Կոդ Հաղորդագրություն Ի՞նչ անել
LS3002 «…» կանչում է ինքն իրեն — ռեկուրսիան verboten է LootScript-ում Փոխարինեք ռեկուրսիան ցիկլով
LS3003 Փոխադարձ ռեկուրսիան արգելված է: … Խափանեք անվերջ ցիկլը
LS3004 արգումենտը «…» չի հաշվարկվում ճյուղից դուրս — վեր թռչեցրեք ta.* կանչը վերև Հաշվեք արգումենտները և կանչը if-ից դուրս
LS3006 «…» ծածկում է արտաքին անունը (նախազգուշացում) Փոխանվեք ներքին փոփոխականի անունը
LS3007 «…» գտնվում է ցիկլի դուրսում break և continue-ը միայն ցիկլի մեջ են
LS3008 return-ը ֆունկցիայի դուրսում return-ը միայն ֆունկցիայի մարմնում է
LS3009 export «…» հնարավոր է միայն library(…)-ում Հեռացրեք export կամ դարձեք գրադարան
LS3010 «…» առանց կանգառի մակարդակի (profit/loss/stop/limit/trail) — դատարկ օպերացիա (նախազգուշացում) Բացشفեք stop, take կամ trailing
LS3011 strategy.* հասանելի է միայն strategy(...)-ում Հայտարարեք որպես strategy(...)
LS3012 Գրադարաններում չի կարելի նկարել կամ հայտարարել input-ներ: … Ներդրում և կարգավորումները տեղափոխեք ինդիկատորին
LS3013 «…» request.security ներսում չի դառնա արժեքարգ/string — հայտարարեք input վերև և փոխանցեք Հայտարարեք input.* վերև և փոխանցեք փոփոխականը
LS3016 Կարգավորումը «…» ընդունվել է, բայց ոչինչ չի անում (սведение) Կարող եք թողնել կամ հեռացնել այն
LS3018 Գրադարան «…» չի գտնվել գրադարանների թղթապանակում — անունը վերցվում է library(“…”, N)-ից, ոչ ֆայլի անունից Ստուգեք գրադարանի հայտարարության մեջ տրված անունը
LS3019 Գրադարանների տարբերակները չեն գտնվել — նշեք տեղադրված տարբերակը Ցույց տվեք տեղադրված տարբերակը
LS3020 «…» request.security ներսում: order book և time and sales տվյալների վրա պատմություն չկա այլ սերիայի վրա Հեռացրեք book.*, tape.* արտահայտությունից
LS3025 Ֆունկցիա «…» հայտարարվում է, բայց չի կանչվում — նրա մարմինը միայն փորձարկվել է (նախազգուշացում) Կանչեք ֆունկցիան կամ հեռացրեք այն
LS3026 «…» պահանջում է stop, որի հաշվով հաշվարկել չափը: loss/stop պետք է նշված լինի մեջ կամ strategy.exit-ում Ավելացրեք stop-ը կամ օգտագործեք strategy.exit
LS3028 Այս բիլդը չի աջակցում՝ … Սարդարեք առանց այդ կառուցվածքի
LS3029 switch ճյուղը խճճված է — կրկնությունը անհասանելի է Հեռացրեք կրկնությունը
LS3030 «…» — գրաֆիկի փոփոխական է, բայց request.security հաշվարկվում է այլ series-ով; փոխանցեք արժեքը input.* կամ հաշվեք ներսում Հաշվեք ներսում կամ օգտագործեք input.*
LS3031 Գրադարանները ներառում են միմյանց՝ պտույտով Խափանեք ներառումների շրջանակը
LS3032 Գրադարանում «…» թույլատրվում են միայն ֆունկցիաների հայտարարություններ և import-ներ — այստեղ կա ավելին Հեռացրեք ավելորդ կոդը գրադարանից
LS3033 Գրադարան «…» չի համարկվում (…) — բացեք այն խմբագրիչում և շտկեք Շտկեք այդ գրադարանի սխալը

LS4000–LS4009 — կոմպիլյացիայի սահմաններ

Կոդ Հաղորդագրություն Ի՞նչ անել
LS4000 Շատ ta.* կանչեր: …՝ առավելագույնը 512 — հեռացրեք անիմաստ ta.*-երը կամ վերօգտագործեք փոփոխականներ Սահմանափակեք ta.* կանչերը և պատմող փոփոխականները
LS4001 Ծրագրի չափը շատ մեծ է (ավելի քան 4096 ներդրումներ) — պարզեցրեք ֆունկցիաները Խմբավորեք և նվազեցրեք пользовательские ֆունկցիաների կանչերը
LS4002 Շատ plot-եր — վահանակը չի կարող նկարել ավելի քան երեք շարք Ամբողջ արտանետումների քանակը (plot, plotshape, plotchar, bgcolor) — մինչև 64; նկարվում են առաջին երեք plot-երը
LS4009 Շատ request.security կանչեր: …, սահման 32 Միավորեք կանչերը

LS5000–LS5013 — պերերիսովկա և թեստեր

Կոդ Հաղորդագրություն Ի՞նչ անել
LS5000 varip-ը հասնում է ցուցադրման՝ պատմության վրա բերվելու դեպքում այն կլինի այլ (перерисовка) (նախազգուշացում) Օգտագործեք var, եթե պետք է նույն պատմությունը
LS5001 Միայն կենդանի բարի արժեքն է հասնում ցուցադրման — պատմության վրա այս արժեքը չի լինի (նախազգուշացում) Օգտագործեք barstate.isconfirmed
LS5002 lookahead = true ընթերցում է ապագայում — պատմության վրա արդյունքը անիրատեսական է (նախազգուշացում) Հեռացրեք lookahead = true
LS5003 Մեծագույն timeframe առանց [1] — անփակված բարը կարող է վերափոխվել; ավելացրեք [1] (նախազգուշացում) request.security(…, close[1])
LS5004 Նեղ գոտու բացասական ինդեքսը տեղափոխում է ցուցադրման անցյալը — պատմության վրա գիծը կարող է ճանաչել ապագան Հեռացրեք բացասական ինդեքսները x[-n]
LS5005 Նետդետերմինացված արժեքը հասնում է ցուցադրման — երկու անցում կտան տարբեր գծեր (նախազգուշացում) Մի ցուցադրեք math.random կամ timenow գրաֆիկում
LS5006 Տվյալները հասանելի են միայն կենդանի ժամանակում — պատմության վրա շարքը դատարկ է (նախազգուշացում) Պատմության համար օգտագործեք depth.* order book-ի տվյալների փոխարեն
LS5011 Ստրատեգիան ընթերցում է book.* կամ tape.* — նրանց վրա պատմություն չկա, բեքթեստը կլիներ սխալ Հեռացրեք book.* և tape.*-ը ստրատեգիայից
LS5012 Ստրատեգիան «օգտագործում է lookahead» («…») — զեկույցը նշվում է որպես անիրագործելի իրական ժամանակում (նախազգուշացում) Հեռացրեք lookahead = true
LS5013 «…» միացված է: հայտերը կատարվում են բարի փակման ժամանակ — զեկույցը նշված է (сведение) Հեռացրեք processOrdersOnClose, եթե պետք է իրականիստичный զեկույց

LS6000–LS6036 — կատարում

Կոդ Հաղորդագրություն Ի՞նչ անել
LS6001 Ինդեքսը … դուրս է սահմանների Ստուգեք կոլեկցիայի չափը մինչև դիմումը
LS6002 Բացասական տեղաշարժ պատմության մեջ — ապագայում ընթերցելն արգելված է Պատմության ինդեքսը պետք է ≥ 0
LS6003 Ամբողջ կոլեկցիայի չափը գերազանցվել է (…) — կոլեկցիան ստեղծվել է տողում … Սահմանափակեք աճը՝ հեռացնելով հին տարրերը
LS6004 Սկրիպտը սպառել է մեկ բարի օպերացիոն բյուջեն — պարզեցրեք ցիկլը Ստուգեք ելքի պայմանը ցիկլում
LS6005 Սկրիպտը գերազանցել է անցման ժամանակը Նվազեցրեք աշխատանքի վրա մեկ բարի համար
LS6007 Միացումն ուղղված է դատարկ օբյեկտին (na) Ստեղծեք կոլեկցիան կամ օբյեկտը մինչև դրանից օգտվելը
LS6014 Տողը երկար է ավելի քան 100000 նիշ — կրճատեք կամ հավաքեք մասերով Կրճատեք տողը
LS6015 Անհայտ ժամային գոտի «…» — պետք է IANA նույնականիչ, օրինակ Europe/Berlin Օգտագործեք IANA ձևաչափի անուն
LS6017 Սիմվոլը «…» անհայտ է — ստուգեք ֆորմատը «ՊԼՈՇԱԴԿԱ:SYMBOL» կամ նշանակեք ignore_invalid_symbol = true Շտկեք սիմվոլի ձևաչափը
LS6018 timeframe «…» չի ընթեռնվում — սպասվում է «5», «60», «4h», «1D», «1W» Շտկեք timeframe-ը
LS6019 Գծային օբյեկտը արդեն ջնջված է կամ տեղահանվել է սահմանափակումից — իր վերանշանակեք կամ ստեղծեք նորը Ստուգեք օբյեկտի հենակետը կամ բարձրացրեք սահմանը
LS6020 str.format: մի {…} placeholder-ին չի տրվել արգումենտ Տվեք արգումենտ յուրաքանչյուր {n}-ին
LS6021 str.match: regex-ն սպառել է բյուջեն — պարզեցրեք regex-ը Պարզեցրեք արտահայտությունը
LS6026 Սկրիպտի ընդհանուր կոլեկցիաների բյուջեն սպառվել է (… բջիջ) — տողից եկող կոլեկցիան չի տեղավորվում Կրճատեք կամ սահմանափակեք կոլեկցիաները
LS6027 Անվավեր արգումենտ «…» մեջ … Օրինակ՝ բացասական չափ array.new-ում
LS6028 Տողերի բյուջեն սպառվել է (…) — վերօգտագործեք տողերը նորերով յուրաքանչյուր բարի վրա Մի միտք կազմեք նոր տողեր յուրաքանչյուր բարի համար
LS6029 Աղյուսակում ավելի քան 2000 բջիջ — վահանակի բարձրագույն ոսկեզօծ Կրճատեք աղյուսակը
LS6030 Աղյուսակի բջիջը գտնվում է ցանցի սահմաններից դուրս: … Սյունի և տողի համար օգտագործեք ճիշտ ներբեռնված չափերը
LS6031 Ներքին ֆունկցիան «…» հայտարարված է, բայց չի իրականացված — սա բիլդի дэֆեկտ է, հաղորդեք աջակցություն Հաղորդեք աջակցությանը
LS6032 Handle-ը չի վերաբերում ճիշտ տեսակի օբյեկտին — օբյեկտը ազատվել է կամ handle-ը այլ պրոգրանից է Մի պահեք հին handle-եր դեպի ջնջված օբյեկտներ
LS6033 Փող … դուրս է տիպի հայտարարությունից — սա բիլդի սխալ է, հաղորդեք աջակցություն Հաղորդեք աջակցությանը
LS6034 Արագ պատուհանի երկարությունը … մեծ է 100000-ի — այդ պատուհանը չի տեղավորվի հիշողությունում Փոքրացրեք պատուհանի երկարությունը
LS6035 Ցիկլի քայլը հավասար է զրոյին — հաշվիչը չի շարժվում, և վերջը անհասանելի է by-ը in for չի կարող լինել զրո
LS6036 Տերմալ շերտը … դուրս է 0…3 միջակայքից layer-ը պետք է լինի 0-ից 3վա մեջ
Կոդեր, որոնք այս տարբերակը չի վերադարձնում

Այս համարները շարքայինորեն ամրագրված են լեզվում, սակայն այս վերսիայում տերմինալը դրանք չի ցուցադրում: LS1003, LS1007, LS1011, LS2016, LS3000, LS3001, LS3005, LS4003, LS4004, LS5007, LS6000, LS6006, LS6008, LS6022, LS6023. Օրինակ, հայտարարությունը առաջին տողում չլինելը հիմա հաշվարկվում է որպես LS1009, իսկ զրոյով բաժանումը չի կանգնեցնում սկրիպտը LS6000-ով։

Դրանից հետո

https://docs.lootx.trade/hy/loot/errors

Справочник

12Սկրիպտների օրինակներ

Ութ պատրաստի սկրիպտ LootScript‑ով՝ շարժական միջիններ, RSI, VWAP՝ գոտիներով, կումուլյատիվ delta՝ տարբերակներով, open interest, funding rate, footprint cluster-ների անհավասարակշռություններ և ստրատեգիա թեստերի համար.

Ութ պատրաստի սկրիպտ LootScript‑ով՝ սկսած շարժական միջիններից և RSI‑ից մինչև կումուլյատիվ delta, open interest, funding rate և footprint cluster-ներ։ Ամեն օրինակ՝ աշխատող Ինդիկատոր, որը կարելի է անմիջապես Ավելացնել գրաֆիկին և կարգավորել։ Բոլոր օրինակները հավաքվում են ընթացիկ վարկածի կոմպիլյատորով առանց սխալների և զգուշացումների.

Ինչպես գործարկել օրինակը

  1. Սեղմեք ƒ գրաֆիկի վահանակի վրա, Ինդիկատորներ պատուհանում — Խմբագրիչ….
  2. Խմբագրիչում սեղմեք Նոր (Ctrl+N), փոխարինեք տեմպլեյթը օրինակով և սեղմեք Պահպանել.
  3. Սեղմեք Ավելացնել գրաֆիկին (Ctrl+Enter). input.*‑ից պարամետրերը կհայտնվեն Ինդիկատորի կարգավորումների պատուհանում.

1. Երեք շարժական միջիններ՝ տիպի ընտրությամբ

Բыстрая, միջին և медленная նույն տեսակի՝ ընտրությամբ։ Ֆոնը ընդգծվում է, երբ երեքը դասավորված են ըստ թրենդի։

Loot
indicator("Три скользящие", shortTitle = "MA×3", overlay = true)
maType = input.string("EMA", "Тип средней", options = ["EMA", "SMA", "WMA", "HMA"])
src    = input.source(close, "Источник")
len1   = input.int(20, "Быстрая", minval = 1)
len2   = input.int(50, "Средняя", minval = 1)
len3   = input.int(200, "Медленная", minval = 1)

func ma(s, len) => switch maType {
    "SMA" => ta.sma(s, len)
    "WMA" => ta.wma(s, len)
    "HMA" => ta.hma(s, len)
    => ta.ema(s, len)
}

m1 = ma(src, len1)
m2 = ma(src, len2)
m3 = ma(src, len3)

plot(m1, "Быстрая", color = m1 >= m1[1] ? color.teal : color.red, linewidth = 2)
plot(m2, "Средняя", color = color.orange)
plot(m3, "Медленная", color = color.gray, linewidth = 2)
bgcolor(m1 > m2 and m2 > m3 ? color.new(color.teal, 20) : m1 < m2 and m2 < m3 ? color.new(color.red, 20) : na)

Ինչպես աշխատում է

  • input.string‑ը options‑ով վերափոխվում է dropdown ցանկի՝ կարգավորումների մեջ.
  • Ֆունկցիան ma ընտրում է համապատասխան միջինը switch‑ով. ta.*‑ի վիճակը անկախ է յուրաքանչյուր կանչից, ուստի երեք կանչերն արտադրում են երեք անկախ միջիններ.
  • Արագ գծի գույնը հաշվարկվում է համեմատությամբ նախորդ բարի (m1[1]) հետ: աճում է՝ color.teal, նվազում է՝ color.red.
  • Պանելն կարող է նկարել մինչև երեք plot գիծ յուրաքանչյուր ինդիկատորի համար, այդ պատճառով չի պահանջվում այլ գործողություն երեք միջինների համար.

2. RSI՝ գոտիներով և ծանուցումներով

RSI՝ երկու մակարդակի միջև լցոնմամբ. գիծը և ֆոնը ներկվում են, երբ RSI‑ը գտնվում է overbought կամ oversold գոտում։

Loot
indicator("RSI с зонами", shortTitle = "RSI", overlay = false)
len = input.int(14, "Период", minval = 2)
src = input.source(close, "Источник")
ob  = input.float(70, "Перекупленность", minval = 50, maxval = 100)
os  = input.float(30, "Перепроданность", minval = 0, maxval = 50)

r = ta.rsi(src, len)

hOb = hline(ob, "Перекупленность", color = color.red)
hOs = hline(os, "Перепроданность", color = color.teal)
fill(hOb, hOs, color = color.new(color.purple, 20))
plot(r, "RSI", color = r > ob ? color.red : r < os ? color.teal : color.purple, linewidth = 2)
bgcolor(r > ob ? color.new(color.red, 35) : r < os ? color.new(color.teal, 35) : na)

alertcondition(ta.crossunder(r, ob), "RSI вышел из перекупленности", "RSI опустился ниже верхнего уровня")
alertcondition(ta.crossover(r, os), "RSI вышел из перепроданности", "RSI поднялся выше нижнего уровня")

Ինչպես աշխատում է

  • hline վերադարձնում է մակարդակի հենակետը, իսկ fill‑ը կատարում է լցոնում երկու հենակետի միջև.
  • Մակարդակները input.float կարգավորումներ են, ուստի գծերն ու լցոնումը շարժվում են դրանց հետ.
  • alertcondition‑ը հայտարարում է երկու ծանուցում. դրանք ինքնաբերաբար չեն զանգում — ինչպես դրանք միացնելը նկարագրված է էջում Ծանուցումներ սկրիպտներից.
  • Ալֆան color.new‑ում՝ 0-ից (թափանցիկ) մինչև 255 (ամբողջապես պինդ).

3. VWAP дня с полосами отклонения

Օրվա սկիզբից (00:00 UTC) հաշվարկված VWAP և ±σ լայնությամբ գոտի:

Loot
indicator("VWAP дня с полосами", shortTitle = "VWAP", overlay = true)
src  = input.source(hlc3, "Цена")
mult = input.float(1.0, "Ширина полосы, σ", minval = 0.1, step = 0.1)

anchor = session.isfirstbar
vw = ta.vwap(src, anchor)

// Сумма объёма и сумма объёма на квадрат цены с начала дня — для разброса вокруг VWAP.
var float sumV  = 0.0
var float sumV2 = 0.0
if anchor {
    sumV  := 0.0
    sumV2 := 0.0
}
if not na(volume) and not na(src) {
    sumV  := sumV + volume
    sumV2 := sumV2 + volume * src * src
}
sigma = sumV > 0 and not na(vw) ? math.sqrt(math.max(sumV2 / sumV - vw * vw, 0)) : na

pUp = plot(vw + mult * sigma, "Верх", color = color.new(color.blue, 150))
plot(vw, "VWAP", color = color.blue, linewidth = 2)
pDn = plot(vw - mult * sigma, "Низ", color = color.new(color.blue, 150))
fill(pUp, pDn, color = color.new(color.blue, 25))

Ինչպես աշխատում է

  • ta.vwap սկսում է հաշվել նորից այն բարի վրա, որտեղ anchor‑ը ճիշտ է. կրիպտոյում session.isfirstbar‑ը առաջին բարն է 00:00 UTC‑ից հետո.
  • var փոփոխականները պահվում են բարերի միջով. նույն anchor‑ը դրանք զրոյացնում է, ուստի գոտին հաշվարկվում է նույն ժամանակահատվածի համար, ինչ VWAP‑ը.
  • Sigma‑ն հաշվարկվում է որպես քառակուսի միջինի արմատը նվազեցված VWAP‑ի քառակուսով. math.max(…, 0) պաշտպանում է ՛սկսաշրջանկացումից առաջացած փոքր բացասական արժեքներից.
  • Սենսը կա ինտրադեյ միավորների վրա. Եթե ուզում եք VWAP‑ը երկար ժամանակահատվածից (օրինակ՝ վերջին funding‑ից), տվեք anchor = funding.settled.

4. Օրեկան կումուլյատիվ delta՝ տարբերակներով

Կումուլյատիվ delta, որը զրոյացվում է ամեն օր, և նշումներ այն բարերի վրա, որտեղ գինը թարմացրել է տեղական экстремումը, իսկ delta‑ն չէ:

Loot
indicator("Дневная кумдельта с расхождениями", shortTitle = "CVD", overlay = false)
len = input.int(20, "Окно поиска максимумов", minval = 3)

var float cvd = 0.0
if session.isfirstbar {
    cvd := 0.0
}
if delta.available {
    cvd := cvd + delta.value
}
cvdLine = delta.available ? cvd : na

// Цена обновила максимум окна, а кумдельта — нет: покупатели не подтверждают рост.
bearish = high >= ta.highest(high, len) and cvdLine < ta.highest(cvdLine, len)
bullish = low <= ta.lowest(low, len) and cvdLine > ta.lowest(cvdLine, len)

plot(cvdLine, "Кумдельта", color = cvdLine >= 0 ? color.teal : color.red, linewidth = 2)
hline(0, "Ноль", color = color.gray)
plotshape(bearish, "Медвежье расхождение", style = shape.triangledown, location = location.top, color = color.red, size = size.tiny)
plotshape(bullish, "Бычье расхождение", style = shape.triangleup, location = location.bottom, color = color.teal, size = size.tiny)

Ինչպես աշխատում է

  • delta.value — ագրեսիվ գնողների և վաճառողների տարբերությունն է մեկ բարի համար. Եթե տվյալները չկան, delta.available հավասար չէ true, և գիծը ընդհատվում է, ոչ թե նկարում զրո.
  • Նկարչող var փոփոխականը զրոյացվում է օրվա սկզբում. Եթե ուզում եք կումուլյատիվ delta ամբողջ պատմության համար առանց զրոյացման՝ օգտագործեք պատրաստի շարքը delta.cum.
  • Տարբերակ (divergence): գինը հասնում է պատուհանի максимумին, բայց կումուլյատիվ delta‑ն չի հաստատում այն. Մինիմումների համար՝ հակառակը.
  • location.top և location.bottom տեղադրում են նշանները ենթապենի եզրին, ոչ թե գնի վրա.

5. Open interest‑ի պոռթկումները

Open interest‑ի փոփոխությունը տոկոսով մի բարի մեջ և նշում այնտեղ, որտեղ այն դուրս է գալիս սովորական բաշխման շրջանակից.

Loot
indicator("Изменение открытого интереса", shortTitle = "ΔOI %", overlay = false)
len = input.int(50, "Окно для всплесков", minval = 5)
k   = input.float(3.0, "Порог всплеска, σ", minval = 0.5, step = 0.5)

pct = oi.available and oi.close[1] > 0 ? 100 * (oi.close - oi.close[1]) / oi.close[1] : na
sd  = ta.stdev(pct, len)
spike = not na(sd) and math.abs(pct) > k * sd

plot(pct, "ΔOI, %", style = plot.style_columns, color = pct >= 0 ? color.teal : color.red)
hline(0, "Ноль", color = color.gray)
plotshape(spike, "Всплеск", style = shape.circle, location = location.top, color = color.orange, size = size.tiny)

Ինչպես աշխատում է

  • oi.close — open interest‑ը բարի փակման պահին, oi.close[1] — նախորդ բարի. oi.available ստուգումը կանխում է հաշվարկը բաց տվյալների վրա.
  • Պոռթկումը (spike) — այն բարերը, որոնց փոփոխության մոդուլն անցնում է k ստանդարտ շեղումները len պատուհանում.
  • Open interest‑ը թարմացվում է հիմնականում րոպեական հաճախականությամբ. Եթե timeframe‑ը փոքր է մեկ րոպե, հարևան բարերը կարող են կրկնել նույն արժեքը, ու փոփոխությունը լինում է զրո — դա տվյալ է, ոչ սխալ.

6. Funding rate

Perpetual ֆյուչերսի funding rate‑ը ցուցադրվում է տոկոսներով մեկ period‑ի համար կամ վերածված տարեկան, նշումներ վճարման պահին և բարձր մակարդակի ընդգծում։

Loot
indicator("Ставка финансирования", shortTitle = "Funding", overlay = false)
mode = input.string("За период", "Показывать", options = ["За период", "Годовых"])
thr  = input.float(0.05, "Порог, %", minval = 0.0, step = 0.01)

perPeriod = funding.rate * 100
periodsPerYear = funding.interval_hours > 0 ? 24.0 / funding.interval_hours * 365 : na
value = mode == "Годовых" ? perPeriod * periodsPerYear : perPeriod
level = mode == "Годовых" ? thr * periodsPerYear : thr

plot(value, "Ставка, %", style = plot.style_columns, color = value >= 0 ? color.teal : color.red)
hline(0, "Ноль", color = color.gray)
plotshape(funding.settled, "Выплата", style = shape.circle, location = location.bottom, color = color.gray, size = size.tiny)
bgcolor(math.abs(value) > level ? color.new(color.orange, 30) : na)

Ինչպես աշխատում է

  • funding.rate՝ թիվ է՝ ոչ տոկոս: 0.0001 համարժեք է 0.01%. Այդ պատճառով արժեքը բազմապատկվում է 100‑ով.
  • Տարեկան դարձնելու համար բազմապատկվում է տարինում վճարումների քանակով. 24.0 թիվը մատնանշված է դիտավորյալ՝ ամբողջ թվերի բաժանումը լռելյայն կարող է խզել մնացորդը.
  • funding.settled true է այն բարի վրա, որի վրա եղավ վճարումը — այնտեղ դնում են մի կետ.
  • Պорогը հայտարարվում է per‑period, և տարվա համար այն նույն միապատկով վերափոխվում է.

7. Footprint cluster‑ների անհավասարակշռություններ

Գնի վրա նշումներ՝ այնտեղ, որտեղ cluster‑ում կա «ստեպ» տեսքով անհավասարակշռություն կամ պարզապես շատ imbalance‑ներ, նաև POC՝ յուրաքանչյուր բարի համար։

Loot
indicator("Дисбалансы кластеров", shortTitle = "Imbalance", overlay = true)
minSteps = input.int(3, "Уровней подряд", minval = 2)
minCount = input.int(5, "Дисбалансов в баре", minval = 1)

levels = cluster.available ? cluster.levels : 0
buys  = 0
sells = 0
for i in 0 .. levels {
    side = cluster.imbalance(i)
    if side == 1 {
        buys := buys + 1
    } else if side == -1 {
        sells := sells + 1
    }
}

plot(cluster.poc, "POC", style = plot.style_circles, color = color.orange)
plotshape(cluster.stacked_buy_steps >= minSteps, "Лесенка покупок", style = shape.triangleup, location = location.belowbar, color = color.teal, size = size.small)
plotshape(cluster.stacked_sell_steps >= minSteps, "Лесенка продаж", style = shape.triangledown, location = location.abovebar, color = color.red, size = size.small)
plotshape(buys >= minCount, "Много дисбалансов покупок", style = shape.circle, location = location.belowbar, color = color.new(color.teal, 120), size = size.tiny)
plotshape(sells >= minCount, "Много дисбалансов продаж", style = shape.circle, location = location.abovebar, color = color.new(color.red, 120), size = size.tiny)

Ինչպես աշխատում է

  • cluster.imbalance(i) վերադարձնում է +1, −1 կամ 0 նշագավառի համար i. Imbalance‑ի շեմը վերցված է գրաֆիկի cluster կարգավորումներից, ուստի սկրիպտը տեսնում է նույն բանն, ինչ դուք.
  • cluster.stacked_buy_steps ցույց է տալիս՝ քանի մակարդակ անընդմեջ ունեն գնային անհավասարակշռություններ. Ցիկլը for i in 0 .. levels հաշվարկում է բոլոր դիսբալանսները բարի համար, ոչ միայն անընդմեջները.
  • Սկրիպտը ինքննաբար սաբսկրիբ է cluster‑երին և աշխատում է սովորական մոմ (մոմեր/բարեր) գրաֆիկում. Եթե բորսան չունի տվյալներ կամ timeframe‑ը փոքր է 30 վայրկյանը կամ մեծ է մեկ օրվանից, cluster‑եր չեն լինի — այդ դեպքում levels = 0 և նշումներ չեն կնկատվեն.

8. Ստրատեգիա: EMA‑երի խաչը՝ stop-loss ATR‑ով

Long մուտք EMA‑երի խաչով, stop-loss և take‑profit՝ ATR‑ի միավորներով, ելք՝ հակառակ խաչով.

Loot
strategy("EMA-кросс со стопом по ATR", overlay = true, initialCapital = 10000,
         defaultQtyType = strategy.qty.percent_of_equity, defaultQtyValue = 10,
         slippageTicks = 2)
fastLen = input.int(12, "Быстрая EMA", minval = 1)
slowLen = input.int(26, "Медленная EMA", minval = 2)
atrLen  = input.int(14, "Период ATR", minval = 1)
stopK   = input.float(1.5, "Стоп, в ATR", minval = 0.1, step = 0.1)
takeK   = input.float(3.0, "Цель, в ATR", minval = 0.1, step = 0.1)

fast = ta.ema(close, fastLen)
slow = ta.ema(close, slowLen)
atr  = ta.atr(atrLen)

// ATR запоминается в момент сигнала, чтобы стоп и цель не ползли вслед за волатильностью.
var float riskAtr = na
if ta.crossover(fast, slow) and strategy.position_size == 0 {
    riskAtr := atr
    strategy.entry("Long", strategy.long)
}
if ta.crossunder(fast, slow) {
    strategy.close("Long", comment = "Обратный кросс")
}
if strategy.position_size > 0 {
    entry = strategy.position_avg_price
    strategy.exit("Стоп/цель", from_entry = "Long", stop = entry - stopK * riskAtr, limit = entry + takeK * riskAtr)
}

plot(fast, "Быстрая", color = color.teal)
plot(slow, "Медленная", color = color.orange)

Ինչպես աշխատում է

  • Պարամետրերը strategy(…) մեջ՝ լիտերալներ են՝ սկզբնական կապիտալ 10000, դիրքի չափը՝ 10% կապիտալի, slippage = 2 tick. Կոմիսիան (կոմիսիա) չնշված է, ուստի թեստերը օգտագործում են լռելյայնային թարմացումը՝ 0.02% limit և 0.05% market/stop. Կոմիսիան կարելի է սահմանել commissionValue‑ով.
  • Մարկետ ինտրին կատարվում է հաջորդ բարի open‑ի վրա, ոչ թե սիգնալ բարի close‑ի վրա՝ որպեսզի թեստերը չնայեն ապագային.
  • strategy.exit‑ը տեղադրում է stop‑ը և take‑profit‑ը մուտքի միջին գնի նկատմամբ. Եթե մեկ բարի ընթացքում երկուսն էլ հասանելի են, թեստերը լռելյայն ընդունում են, որ նախը աշխատել է stop‑ը.
  • Արդյունքները՝ գործարքները և կապիտալի կորուստները (drawdowns) հայտնվում են Ստրատեգիայի թեստեր… պատուհանում Խմբագրիչում. Լրացուցիչ տեղեկություններ՝ էջում Ստրատեգիաներ և թեստեր.

Հաջորդը

https://docs.lootx.trade/hy/loot/examples