Язык Loot
LootScript — սեփական Ինդիկատորներ և ալերտներ տերմինալում, ստրատեգիաների թեստավորում պատմության վրա
1LootScript լեզուն
Ի՞նչ է LootScript-ը՝ ինդիկատորներ, ռազմավարություններ և գրադարաններ, որոնք աշխատում են անմիջապես տերմինալում՝ գրաֆիկի տվյալների վրա։ Ի՞նչ տվյալներ են հասանելի, ինչպե՞ս միացնել սկրիպտները և ինչ նրանք չեն անում։
LootScript-ը LootX տերմինալի սկրիպտավորման լեզուն է։ Դրանով գրում են սեփական ինդիկատորներ, ռազմավարություններ՝ գաղափարները պատմության վրա ստուգելու համար, և ընդհանուր ֆունկցիաների գրադարաններ։ Սկրիպտը տեքստային ֆայլ է, որը կատարվում է անմիջապես տերմինալում՝ այն գրաֆիկի տվյալների վրա, որտեղ դուք այն ավելացրել եք՝ մոմեր, ծավալ, delta, footprint cluster-ներ, open interest, funding rate։
Ահա ամբողջական ինդիկատորի օրինակ՝ յուրաքանչյուր բարի delta-ն՝ սյուներով գրաֆիկի տակ.
indicator("Բարի delta", overlay = false)
d = delta.available ? delta.value : na
plot(d, "Delta", style = plot.style_columns, color = d >= 0 ? color.teal : color.red)Բացեք խմբագրիչը, գրեք ինդիկատոր և ավելացրեք այն գրաֆիկին։
Շարահյուսություն և տիպերՓոփոխականներ, na, բարերի պատմություն, պայմաններ, ցիկլեր, ֆունկցիաներ։
Մուտքային պարամետրեր, գծեր, մակարդակներ, մարկերներ, պիտակներ և գույներ։
Շուկայի տվյալներDelta, footprint cluster-ներ, open interest, funding rate, order book, այլ timeframes։
Ռազմավարություններ և փորձարկիչՄուտքի և ելքի կանոններ, անցկացում պատմության վրա, հաշվետվություն գործարքների մասին։
Ֆունկցիաների տեղեկատուԼեզվի բոլոր ներկառուցված ֆունկցիաներն ու հաստատունները։
Ինչ կարելի է գրել
Սկրիպտի առաջին տողը հայտարարում է նրա տեսակը, և տեսակից կախված է, թե ինչ է թույլատրվում սկրիպտին։
| Տեսակ | Առաջին տող | Ինչ է անում |
|---|---|---|
| Ինդիկատոր | 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] и повторный запуск бара, рассказано в Синтаксис и типы, а рисование и настройки — в Настройки и отрисовка.
Как читать справочник
Каждая функция записана одной строкой: имя, параметры в том порядке, в каком их разбирает позиционный вызов, и тип результата.
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 на другом таймфрейме или инструменте и возвращает результат на барах графика |
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) ստեղծում է սկրիպտ ձևանմուշից՝ մեկ կարգավորմամբ շարժվող միջին.
indicator("Без названия", overlay = true)
length = input.int(20, "Length", minval = 1)
plot(ta.ema(close, length), "EMA", color = color.orange)Տեքստը փոխարինեք ամենակարճ աշխատող ինդիկատորով՝ 20 բարի պարզ միջինով.
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, իսկ Խնդիրներ ներդիրում կհայտնվի սխալի կոդով, բացատրությամբ և դիրքով տող։
LS2002 Неизвестное имя «ta.smaa» — проверьте написание или объявите его выше Стр 3:6Տողի վրա կրկնակի սեղմումը կտեղափոխի կուրսորը սխալի տեղը։ Յուրաքանչյուր սխալ ունի LS#### տեսքի մշտական կոդ, իսկ տեքստն անմիջապես հուշում է, թե ինչպես այն ուղղել։ Հաճախակի սխալների վերլուծությունը՝ Компиляции и выполнения — Ошибки էջում։
Սխալներով սկրիպտը գրաֆիկի վրա չի հայտնվի. Ավելացնել գրաֆիկին կպատասխանի «Սխալներով սկրիպտը գրաֆիկի վրա չի դրվում — տե՛ս «Խնդիրներ»» և կտեղափոխի կուրսորը առաջին սխալին։ Ինդիկատորների պատուհանում այդպիսի սկրիպտը նշվում է կարմիր պիտակով՝ սխալների քանակով Ս్కրիպտ պիտակի փոխարեն։
Կատարման ժամանակ նույնպես լինում են սխալներ՝ օրինակ՝ ցիկլ, որը չի տեղավորվում հատկացված ժամանակում։ Այդ դեպքում սկրիպտը կանգ է առնում, իսկ պատճառը երևում է Արդյունք ներդիրում՝ «Սկրիպտը կանգնեցված է: …»։ Մնացած ինդիկատորներն ու տերմինալը շարունակում են աշխատել։
Գրաֆիկի վրա արդեն գտնվող սկրիպտի խմբագրում
Քանի դեռ խմբագրում եք, գրաֆիկը շարունակում է ցույց տալ այն տարբերակը, որը դուք ավելացրել էիք։ Հենց որ խմբագրիչում հայտնվում է տոկուն, սխալազերծ տարբերակ, տարբերվող գրաֆիկից, տեղի է ունենում երկու բան.
- Խմբագրչի վահանակում կհայտնվի Թարմացնել ինդիկատորը կոճակը;
- Գրաֆիկի լեգենդում կհայտնվի թարմացման պատկերակ։
Դրանցից ցանկացածը պահպանում է սկրիպտը և փոխարինում այն բոլոր վահանակներում, որտեղ այն կա։ Ավելացնել գրաֆիկին արդեն որևէ տեղ ավելացված սկրիպտի համար անում է նույնը՝ թարմացնում է բոլոր պատճենները, այլ ոչ թե ավելացնում երկրորդ անգամ։ Քանի վահանակ կստանա նոր տարբերակը՝ ցույց է տալիս խմբագրիչի pane-ի վերնամասում գտնվող գրաֆիկներում: N պիտակը։
Որտեղ են գտնվում ֆայլերը
Windows-ում սկրիպտները պահվում են %APPDATA%\TradingTerminal\scripts\ թղթապանակում՝ յուրաքանչյուր սկրիպտի համար մեկ .loot ֆայլ։ Սա սովորական տեքստ է։ Այն կարելի է բացել ցանկացած խմբագրիչով, պատճենել, տեղադրել պահպանման պատճենում։ Թղթապանակը գտնվում է տեղադրման պանակից դուրս, ուստի տերմինալի թարմացումները նրան չեն վերաբերում։
Ֆայլի անունը ստացվում է առաջին պահպանման ժամանակ վերնագրից՝ բացատները փոխարինվում են ընդգծմամբ, ու կիրիլիցան պահպանվում է։ «Мой первый индикатор» կդառնա Мой_первый_индикатор.loot ֆայլ։
Երբ թղթապանակն առաջին անգամ է ստեղծվում, դրա մեջ դրվում են վեց մեկնարկային սկրիպտներ՝ Две скользящие, RSI с зонами, Импульс объёма, Кумулятивная delta, Open interest против цены և Фандинг годовых։ Դրանք տեղադրված են Իմ скрипտները բաժնում. հարմար է բացել և վերլուծել դրանք։
Երկրորդ օրինակ՝ կարգավորումների ալիք
Սկրիպտն ավելի օգտակար դարձնենք՝ ալիք՝ միջինից և երկու սահմաններից՝ մի քանի ստանդարտ շեղումների հեռավորության վրա։ Պարբերությունը, լայնությունը և գնի աղբյուրը դուրս կապենք կարգավորումների մեջ, իսկ վերին ու ստորին սահմանները կկարմրեն, երբ գինը դրանցից դուրս գա։
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‑ում փոփոխականը չպահպանում է մեկ թիվ, այլ ունի արժեք յուրաքանչյուր բարի համար, և կարելի է փորձել անցյալ արժեքներին։
indicator("Тело свечи")
body = close - open // считается заново на каждом баре
plot(body, "Тело", style = plot.style_columns)Ներկա, դեռ չփակված բարի վրա script‑ը վերագնահատվում է յուրաքանչյուր նոր tick‑ի հետ, սկսելով նույն состояния‑ից, որը գոյություն ուներ նախորդ բարի փակման պահին։ Փակված բարերը այդ դեպքում չեն վերագնահատվում։
Объявление
Script‑ի առաջին հրամանը — ճիշտ մեկ հայտարարություն՝ indicator(...), strategy(...) կամ library(...)։ Նրա վերևում կարող են լինել միայն մեկնաբանություններ և միայնակ #version 1 տողի ընտրովի գրությունը։ Եթե հայտարարություն չկա, script‑ը չի կոմպիլացվի և կտպի սխալ՝ «Нет объявления скрипта — начните с indicator(“Название”)»։
#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:
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։ Ոչ այդպիսկ՝ ֆունկցիաները ստիպված կլինեին վերակառուցել իրենց վիճակը յուրաքանչյուր բարի վրա։
indicator("Период из настроек")
len = input.int(14, "Период", minval = 2)
plot(ta.rsi(close, len), "RSI")
// ta.rsi(close, bar_index) не скомпилируется:
// «length» в «ta.rsi» требует значение не слабее input, а передано seriesna — չկա արժեք
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գծապատկերին կդիմացնի գծի կտրուկ դադար, ոչ զրո։
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] — ներկա բարը։ Աշխատում է ցանկացած շարքի հետ, այդ թվում ձեր փոփոխականների։
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 կարող է լինել և՛ հրահանգ, և՛ արտահայտություն; երկուսի դեպքում արագ ընտրությունն անում է ? :։
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 ճյուղը պարտադիր է։
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, կարող է լինել բացասական։ Ցիկլի փոփոխականը գոյություն ունի միայն ցիկլի ներսում և չի փոփոխվում մարմնում։
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)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‑ով։ Փարամետրերի տիպերը կարելի է չնշել — դրանք ինքնաբերաբար ենթադրվում են կանչերից; պարամետրերը կարող են ունենալ նախնական արժեքներ։ Պարգևները փոխանցվում են ըստ կարգի կամ ըստ անունի։
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, երկու կանչերը նույն ֆունկցիայի տարբեր անկախ հաշվարկներ կիրականացնեն։
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 և այլն։ Արդյունքը բաշխվում է փակագծերով ցուցադրված փոփոխականների մեջ; անունների թիվը պետք է համընկնի վերադարձվող արդյունքների թվի հետ։
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(...) միջոցով, դաշտերը ընթերցվում և վերագրվում են կետով։
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 կարգավորումներում — տես Настройки и отрисовка։
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‑ը։
indicator("RSI только на зелёных барах")
r = close > open ? ta.rsi(close, 14) : na
plot(r, "RSI", style = plot.style_circles)Կհեռացվի միայն այն դեպքում, եթե նրա սննխահարկի (argument) ինքնը ծնվում է ճյուղի ներսում։ Այդ դեպքում կոմպիլյատորը չի կարող կանխատեսել և կտա սխալ՝ «Аргумент «len» нельзя вычислить вне ветки — вынесите вызов ta.* на верхний уровень». Իրականացումը՝ հաշվարկել արգումենտը նախ պայմանից դուրս։
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)Комментарии и перенос строк
//— մեկնաբանություն մինչև տողի վերջը,/* … */— բլոկային մեկնաբանություն, բլոկները կարելի է ներարկել։- Հրամանն ավարտվում է տողի վերջում, կետակի պարզապես չի պահանջվում։
- Երկար արտահայտությունը շարունակվում է հաջորդ տողում, եթե տողը կտրվել է փակագծում, ավարտվում է օպերատորով կամ հաջորդ տողը սկսվում է օպերատորով,
?կամ:։
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 |
Տեքստային դաշտ |
Ստորև բերված օրինակը մի սկրիպտում հավաքում է հինգ տեսակի կարգավորումներ.
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կոմպիլյատորն ընդունում է, բայց կարգավորումների պատուհանի տեսքի վրա նրանք առայժմ չեն ազդում։
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 զույգերը նկարվում են նույն ձևով։
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 գույնը նշանակում է, որ այդ բարի վրա գիծ չկա։
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-ի արդյունքը գրվում է փոփոխականի մեջ։
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 գիծ։ Գծի և մակարդակի միջև լցոնումը կոմպիլյատորը չի ընդունի։
Երկու գծերի միջև լցոնման գույնը կարող է փոփոխվել բարից բար։ Այսպես ստացվում է «ամպ» երկու միջիններից։
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)։ Բայց հիշեք, որ սա երեք նկարվող գծերից մեկն է։
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 գույնով բարերի վրա ոչինչ չի փոխվում։
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-ը նույնն է անում任意 նշանով։
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 փոփոխականում, իսկ հինը ջնջեք։
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։ Հարմար է դա անել միայն վերջին բարի վրա, որպեսզի աղյուսակը չվերագրվի ամբողջ պատմության ընթացքում։
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-ն գույնի փոխարեն նշանակում է «չնկարել»։
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-ի հետ։
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 օր։
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 վայրկյանից։
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։
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։
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վերադարձ։ - Առաջիկա, կառուցվող բարի արժեքները փոխվում են տվյալների ժամանման ժամանակ։
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. Գույները և շերտերի պարամետրերը կարելի է փոխել էջում Настройки и отрисовка.
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-ում, Խմբագրիչը մի նախազգուշացում ցույց է տալիս՝ «Տվյալները հասանելի են միայն իրական ժամանակում — պատմության վրա շարքը դատարկ է». դա սպասելի է՝ երկրորդական էությունը: պատմության ձախ մասը դատարկ է։ Այս տվյալները չէ կարելի օգտագործել ռազմավարությունների համար — տես Стратегии и тестер.
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-ի դեպքում՝ պատմության վրա շարքը դատարկ է։
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 կամ այլ մետաղադրամ — և համադրում է արդյունքը գրաֆիկի բարերի հետ.
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.
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)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՝ կրկնակի։
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(): ալերտը կոդից
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-ի վրա, հենց այն հայտնվի ձևավորվող բարում:
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(): պայման, որը դուք ակտիվացնում եք
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 տողերը. ավելի հին տողերը տեղը զիջվում են, դրանց թիվը ցուցադրվում է որպես «вытеснено строк». Очистить կոճակը մաքրում է մատյանը։
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() միշտ ձայն է տալիս, իսկ պայմանը «Пробой вверх» ձայնում է միայն եթե դուք այն ակտիվացրել եք։
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 սերվերները միջնորդ չեն:
Ինչպես բացել օգնականը
- Սեղմեք ƒ գրաֆիկի վահանակում — բացվում է Ինդիկատորներ պատուհանը.
- Սեղմեք Խմբագրիչ… որոնման տողչի կողքին կամ բացեք ձեր սկրիպտը.
- Խմբագրիչի վերին վահանակում, Ավելացնել գրաֆիկին կողքին սեղմեք Օգնական.
Չատը կգտնվի կոդի աջ եկող կողքին։ Սահմանը կարելի է քաշել՝ փոխել լայնությունը։ Չատի վերնամասում գտնվող խաչը (Չատը թաքցնել) կհանի այն՝ չմաշեցնելով զրույցը; նորից սեղմելով Օգնական։
Մոդելին միացում
Բացեք միացման քարտը
Առաջին հարցադրման դեպքում քարտը կբացվի ինքնուրույն։ Հետագայում այն կարելի է կանչել կարգավորումների ատամնանիվով՝ 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-ով՝ բարի տատանման սյունակներ, որոնք լուսավորվում են երբ տատանումը առնվազն կրկնակի է միջինի նկատմամբ.
//@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)Իսկ կոնվերտերը այն գրում է այսպես՝
// Импортировано из скрипта на 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 արգումենտը հեռացվեց — նման պարամետրը չկա: նշումը «պարամետրը հանված է» խնդրում է ստուգել՝ արդյոք այդ պարամետրը դատարկ չէր ըստ իմաստի. այստեղ այն պարզապես նկարում էր վերջին արժեքի գիծը, և սկրիպտը աշխատում է առանց դրա.
Ինչպես ստուգել եւ կատարել լրացումներ
- Կարդացեք վերնամասը. Սկսեք այն տողերից, որոնք նշված են
պարամետրը հանված է,գուշակում,այս build-ում չկաեւչվերծվածտեսակներով. - Դիտեք Խմբագրիչի կոնսոլի ներդիրի՝ «Խնդիրներ». Սխալներով սկրիպտը գրաֆիկին չի ավելացվի.
- Ավելացրեք գրաֆիկին և համեմատեք այն, ինչ ցույց էր տալիս բնօրինակը, պատմության մի քանի հատվածներում.
- Խնդրեք օգնականին. Բացեք ИИ-помощника եւ գրեք
/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 դիրեկտիվը չեն խանգարում։
// Так нельзя: объявление не первое
len = input.int(14, "Длина")
indicator("RSI")indicator("RSI")
len = input.int(14, "Длина")Ֆայլում երկրորդ հայտարարությունը տալիս է LS1008՝ մի սկրիպտին թույլատրվում է միայն մեկը։
LS2002 — անհայտ անուն
«Неизвестное имя «…» — проверьте написание или объявите его выше». Հաճախ դա տպագրական սխալ է կամ ֆունկցիան կանչվել է առանց namespace-ի։ Բոլոր ինդիկատոր ֆունկցիաները գտնվում են ta-ում, մաթեմատիկականը — math-ում, գույները — color-ում։
avg = sma(close, 20)avg = ta.sma(close, 20)Նույն սխալը կգտնվի, եթե փոփոխականը կարդացվեց այն տողից վեր։ Լրիվ անունների ցուցակը՝ ֆունկցիաների ուղեցույցում։
LS2008 — na-ով համեմատում
«Сравнение с na всегда ложно — используйте na(x)». Ինչպիսի նիշով էլ լինի na-ի համեմատությունը (==, !=), այն միշտ տալիս է false, ուստի կոմպիլյատորը արգելում է նման գրել։
x = ta.sma(close, 50)
plot(x == na ? close : x)x = ta.sma(close, 50)
plot(na(x) ? close : x)Կարճ տարբերակը?? է՝ plot(x ?? close)։
LS2014 — արժեքը փոխվում է բար-բար այնտեղ, որտեղ պետք է լինի կոնստանտ
««…» в «…» требует значение не слабее input, а передано series — возьмите input.*(…) или литерал». ta.*-երի համար պատուհանի երկարությունը պետք է հայտնի լինի մինչ առաջին բար։ Բարերով ընտրվող երկարությունը չի անցնում։
len = close > open ? 10 : 20
avg = ta.sma(close, len)Համեմատեք երկու տարբերակները և ընտրեք արդյունքը, ոչ թե երկարությունը՝
fast = ta.sma(close, 10)
slow = ta.sma(close, 20)
avg = close > open ? fast : slowԵթե երկարությունը պետք է օգտագործողի կողմից տրվի, վերցրեք այն input.int(...)-ից։
LS3004 — ta.* կանչը կախված է ճյուղի փոփոխականից
«Аргумент «…» нельзя вычислить вне ветки — вынесите вызов ta.* на верхний уровень». ta.* ֆունկցիաները հիշում են անցյալ բարի տվյալները, ուստի կոմպիլյատորը դրանց հաշվարկը անում է յուրաքանչյուր բարի համար, նույնիսկ եթե կանչը հանգեցված է if-ի ներսում։ Եթե արգումենտը հայտարարված է միայն ճյուղի ներսում, այն մյուս բարի վրա չի լինի։
var float avgBody = na
if close > open {
body = close - open
avgBody := ta.sma(body, 10)
}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) — փոփոխականը հայտարարվել է երկրորդ անգամ =-ով։ Մնա փոփոխականը փոխելու համար օգտագործեք :=։
level = high
level := low««…» затеняет встроенное имя — выберите другое» (LS2019) — փոփոխականը, ֆունկցիան կամ տիպը անվանվել է այնպես, ինչպես built-in շարքը կամ ֆունկցիան՝ close, time, hour, volume. Փոխանակեք անունը՝ օրինակ startHour։ Տարածքային անուններ նման color կամ position կարելի է օգտագործել փոփոխականների անվան համար։
LS2004 և LS2005 — կանչի արգումենտները
««…» ожидает … аргумент(ов), а передано …» (LS2004) և «У «…» нет параметра «…»» (LS2005). Սովորեք կանչի signature-ները ֆունկցիաների ուղեցույցում: արգումենտների անունները և քանակը պետք է համապատասխանեն։
plot(close, colour = color.red)plot(close, color = color.red)LS3011 և LS5011 — ստրատեգիաներ
«strategy.* доступно только в strategy(…)» (LS3011): հայտերն ու դիրքի վիճակը հասանելի են միայն այն սկրիպտների համար, որոնք հայտարարված են strategy(...)-ով։ Փոխարինեք indicator("…")-ը strategy("…")-ով։
«Стратегия читает «…»: у order book և time and sales տվյալների պատմություն չկա, բեքթեստը կլինի շեղում» (LS5011): Ստրատեգիան իջնում է պատմության վրա, իսկ book.* և tape.* տվյալներին պատմություն չկա — անցյալ բոլոր բարերին այնտեղ na է։
strategy("Перекос стакана")
if book.imbalance(10) > 0.5 {
strategy.entry("L", strategy.long)
}Պատմության համար order book-ի արժեքները վերցրեք depth տարածքից՝ այնտեղից ստացված արժեքները հասանելի կլինեն պատմության յուրաքանչյուր բարի համար։
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 = truerequest.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 մս։ Հաճախ պատճառը անսահման ցիկլն է կամ յուրաքանչյուր բարի վրա չափազանց շատ տվյալների համատեղումը։
var int n = 0
i = 0
while i < 10 {
n := n + 1
}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-ներ։ Ամեն օրինակ՝ աշխատող Ինդիկատոր, որը կարելի է անմիջապես Ավելացնել գրաֆիկին և կարգավորել։ Բոլոր օրինակները հավաքվում են ընթացիկ վարկածի կոմպիլյատորով առանց սխալների և զգուշացումների.
Ինչպես գործարկել օրինակը
- Սեղմեք ƒ գրաֆիկի վահանակի վրա, Ինդիկատորներ պատուհանում — Խմբագրիչ….
- Խմբագրիչում սեղմեք Նոր (Ctrl+N), փոխարինեք տեմպլեյթը օրինակով և սեղմեք Պահպանել.
- Սեղմեք Ավելացնել գրաֆիկին (Ctrl+Enter).
input.*‑ից պարամետրերը կհայտնվեն Ինդիկատորի կարգավորումների պատուհանում.
1. Երեք շարժական միջիններ՝ տիպի ընտրությամբ
Բыстрая, միջին և медленная նույն տեսակի՝ ընտրությամբ։ Ֆոնը ընդգծվում է, երբ երեքը դասավորված են ըստ թրենդի։
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 գոտում։
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 և ±σ լայնությամբ գոտի:
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‑ն չէ:
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‑ի փոփոխությունը տոկոսով մի բարի մեջ և նշում այնտեղ, որտեղ այն դուրս է գալիս սովորական բաշխման շրջանակից.
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‑ի համար կամ վերածված տարեկան, նշումներ վճարման պահին և բարձր մակարդակի ընդգծում։
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.settledtrue է այն բարի վրա, որի վրա եղավ վճարումը — այնտեղ դնում են մի կետ.- Պорогը հայտարարվում է per‑period, և տարվա համար այն նույն միապատկով վերափոխվում է.
7. Footprint cluster‑ների անհավասարակշռություններ
Գնի վրա նշումներ՝ այնտեղ, որտեղ cluster‑ում կա «ստեպ» տեսքով անհավասարակշռություն կամ պարզապես շատ imbalance‑ներ, նաև POC՝ յուրաքանչյուր բարի համար։
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‑ի միավորներով, ելք՝ հակառակ խաչով.
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