Язык Loot
LootScript — свои индикаторы и алерты в терминале, проверка стратегий на истории.
1Язык LootScript
Что такое LootScript: индикаторы, стратегии и библиотеки, которые работают прямо в терминале на данных графика. Какие данные доступны, как включить скрипты и чего они не делают.
LootScript — язык скриптов терминала LootX. На нём пишут собственные индикаторы, стратегии для проверки идей на истории и библиотеки общих функций. Скрипт — это текстовый файл, который выполняется прямо в терминале на данных того графика, куда вы его добавили: свечи, объём, дельта, кластеры, открытый интерес, фандинг.
Так выглядит целый индикатор — дельта каждого бара столбиками под графиком:
indicator("Дельта бара", overlay = false)
d = delta.available ? delta.value : na
plot(d, "Дельта", style = plot.style_columns, color = d >= 0 ? color.teal : color.red)Открыть редактор, написать индикатор и добавить его на график.
Синтаксис и типыПеременные, na, история баров, условия, циклы, функции.
Входные параметры, линии, уровни, маркеры, подписи и цвета.
Данные рынкаДельта, кластеры, открытый интерес, фандинг, стакан, другие таймфреймы.
Стратегии и тестерПравила входа и выхода, прогон на истории, отчёт по сделкам.
Справочник функцийВсе встроенные функции и константы языка.
Что можно написать
Первая строка скрипта объявляет его вид, и от вида зависит, что скрипту разрешено.
| Вид | Первая строка | Что делает |
|---|---|---|
| Индикатор | indicator("Название") |
Считает значения по барам и рисует их: линии, гистограммы, уровни, маркеры, фон, подписи. Рисует поверх цены или в отдельной панели под графиком. |
| Стратегия | strategy("Название") |
То же, что индикатор, плюс правила входа и выхода. Заявки стратегии виртуальные — их исполняет Тестер стратегии на истории и показывает сделки, кривую капитала и показатели. |
| Библиотека | library("Название", 1) |
Хранит функции, которые подключают другие ваши скрипты. На график не добавляется и ничего не рисует. |
Кроме своих скриптов, можно перенести готовые из формата Pine Script: терминал переведёт их в LootScript при импорте. Как это работает и что проверить после перевода — на странице Импорт из Pine Script.
Какие данные доступны скрипту
- Свечи графика:
open,high,low,close,volume, время бара и производные вродеhl2. - Поток ордеров: дельта агрессивных покупок и продаж, кластеры по уровням цены, открытый интерес, фандинг, записанная история стакана, метрики скринера.
- Живой стакан и лента сделок — только на текущем, ещё не закрытом баре: их история не записывается.
- Другие таймфреймы и инструменты — через запрос серии со старшего таймфрейма или с другой монеты.
Если биржа не отдаёт какой-то показатель или данных за бар нет, скрипт получает не ноль, а специальное значение na — «нет значения». На графике это разрыв линии, а не ложный ноль. Подробности и покрытие по биржам — на странице Данные рынка.
Где выполняется скрипт
Скрипт работает внутри терминала на вашем компьютере. На сервер LootX он не отправляется и не выполняется там.
- Изоляция. У скрипта нет доступа к сети, файлам, подключениям бирж и API-ключам. Таких функций в языке просто нет — ни случайно, ни намеренно скрипт не может никуда передать ваши данные.
- Пределы. Слишком долгий цикл или огромный массив останавливает только этот скрипт. Другие индикаторы, панели и сам терминал продолжают работать, а причина остановки видна в редакторе.
- Файлы. Каждый скрипт — отдельный файл с расширением
.loot. В Windows они лежат в папке%APPDATA%\TradingTerminal\scripts\, вне папки установки, поэтому обновления терминала их не трогают. Перенести скрипт на другой компьютер — значит скопировать файл.
Как включить скрипты
Скрипты — отдельный модуль, который включается для вашего аккаунта LootX. Чтобы он заработал, войдите в аккаунт в терминале.
Когда модуль включён, в окне индикаторов графика (кнопка ƒ на панели графика) появляются разделы Избранное, Мои скрипты, Встроенные и Стратегии, а вверху — кнопки Импорт… и Редактор….
Когда модуль не включён, скрипты не показываются вовсе: окно индикаторов содержит только встроенные индикаторы, редактора и импорта нет. Замков и предложений купить при этом тоже нет — терминал выглядит так, как будто скриптов в нём не существует. Как только доступ появится, окно индикаторов перестроится само, перезапускать терминал не нужно.
Доступ выдаётся на аккаунт — в составе тарифа или отдельно. Актуальные тарифы — на странице Подписки.
Чего скрипты не делают
- Не ходит в интернет и не читает файлы. Всё, что знает скрипт, — данные графика, на котором он стоит.
- Не публикуется и не продаётся. Каталога скриптов нет: скрипт — ваш локальный файл, поделиться им можно, только передав файл.
- Не исполняет Pine Script напрямую. Скрипты в этом формате сначала переводятся в LootScript при импорте; одинаковые цифры с другими платформами не гарантируются.
Дальше
https://docs.lootx.trade/ru/loot/overview
2Справочник функций
Все встроенные функции, ряды и константы LootScript: ta, math, str, color, input, рисование, коллекции, стратегии и данные ордерфлоу — с параметрами и значениями по умолчанию.
Здесь перечислено всё, что встроено в 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 |
Учитывать фандинг бессрочных фьючерсов в результате |
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 |
Какой процент прошлых значений окна не больше текущего |
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) |
Заливает слой записанным стаканом этого бара. side: 1 — только биды, −1 — только аски, 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нельзя читать стакан и ленту и переменные графика — только входы и сами ряды. - Предел — 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 |
Фандинг, уплаченный и полученный |
Поля сделок и константы
Поля открытой сделки по индексу 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 |
Комиссия и фандинг по сделке |
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.
Данные ордерфлоу
Эти пространства — то, чего нет в обычных языках индикаторов: кластеры, дельта, открытый интерес, фандинг, история стакана и живые данные. Если данных для бара нет, значение — na, а не ноль. Откуда берутся данные и как проверять их наличие, рассказано в Данные рынка: кластеры, дельта, открытый интерес, фандинг, история стакана, живой стакан и лента, скринер.
История: есть на каждом баре
| Пространство | Имена |
|---|---|
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 — открытый интерес |
available, open, high, low, close, usd, coins, change (изменение к прошлому бару) |
funding — фандинг |
available, rate (прогноз ставки), interval_hours (int, часы между расчётами), settled (на баре был расчёт), settled_rate (применённая ставка), cum (накопленная) |
depth — история стакана |
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 — стакан |
available, spread, mid; book.bid(index), book.ask(index) — цены уровней от лучшей; book.bid_qty(index), book.ask_qty(index) — объёмы; book.imbalance(depth) — перекос по depth уровням, −1…1 |
tape — лента |
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 — метрики скринера |
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) |
Окна скринера — строки: 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/ru/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 барам не хватает истории для средней, поэтому линия начинается не с левого края — это нормально. Сколько баров уходит на такой «прогрев», редактор пишет в строке состояния внизу.
По мере набора редактор предлагает имена функций и констант, после открывающей скобки показывает параметры функции, а при наведении на имя — его описание. Список подсказок можно вызвать вручную сочетанием Ctrl+Space.
Сохраните и добавьте на график
- Сохранить (Ctrl+S) записывает скрипт в папку скриптов. Пока есть несохранённые правки, перед именем файла в заголовке окна стоит точка
•. - Добавить на график (Ctrl+Enter) проверяет скрипт, сохраняет его и кладёт на панель графика. В панели редактора появится надпись: «Мой первый индикатор» добавлен на график.
Готово: линия на графике, имя индикатора — в легенде. Индикатор сохранится в раскладке и вернётся после перезапуска терминала.
Как редактор показывает ошибки
Скрипт проверяется сам — через мгновение после того, как вы перестали печатать. Результат виден в шапке редактора: компиляция…, затем ок · 12 мс или, если что-то не так, ошибок: 1 либо предупреждений: 1.
Попробуйте ошибиться: напишите ta.smaa вместо ta.sma. Место ошибки подчеркнётся волнистой линией, счётчик в шапке покажет ошибок: 1, а на вкладке Проблемы появится строка с кодом ошибки, объяснением и позицией:
LS2002 Неизвестное имя «ta.smaa» — проверьте написание или объявите его выше Стр 3:6Двойной щелчок по строке переносит курсор к месту ошибки. У каждой ошибки есть постоянный код вида LS####, а текст сразу подсказывает, как её исправить. Разбор частых ошибок — на странице Ошибки компиляции и выполнения.
Скрипт с ошибками на график не попадёт: Добавить на график ответит «Скрипт с ошибками на график не кладётся — см. «Проблемы»» и переведёт курсор к первой ошибке. В окне индикаторов такой скрипт помечается красной меткой с числом ошибок вместо метки Скрипт.
Бывают и ошибки во время выполнения — например, цикл, который не укладывается в отведённое время. Тогда скрипт останавливается, а причина видна на вкладке Вывод: «Скрипт остановлен: …». Остальные индикаторы и терминал продолжают работать.
Правки скрипта, который уже на графике
Пока вы редактируете, график продолжает показывать ту версию, которую вы добавили. Как только в редакторе появляется исправная версия, отличающаяся от графика, происходят две вещи:
- в панели редактора появляется кнопка Обновить индикатор;
- в легенде индикатора на графике появляется значок обновления.
Любой из них сохраняет скрипт и заменяет его на всех графиках, где он стоит. Добавить на график для скрипта, который уже где-то добавлен, делает то же самое — обновляет все копии, а не кладёт вторую. Сколько панелей получат новую версию, показывает метка на графиках: N в шапке редактора.
Где лежат файлы
В Windows скрипты хранятся в папке %APPDATA%\TradingTerminal\scripts\, по одному файлу .loot на скрипт. Это обычный текст — его можно открыть любым редактором, скопировать, положить в резервную копию. Папка находится вне папки установки, поэтому обновления терминала её не трогают.
Имя файла получается из названия при первом сохранении: пробелы заменяются подчёркиванием, кириллица сохраняется. «Мой первый индикатор» станет файлом Мой_первый_индикатор.loot.
Когда папка создаётся впервые, в неё кладутся шесть стартовых скриптов — Две скользящие, RSI с зонами, Импульс объёма, Кумулятивная дельта, Интерес против цены и Фандинг годовых. Они лежат в разделе Мои скрипты; их удобно открыть и разобрать.
Второй пример: канал с настройками
Сделаем скрипт полезнее: канал из средней и двух границ на расстоянии нескольких стандартных отклонений. Период, ширину и источник цены вынесем в настройки, а верхнюю и нижнюю границы будем подсвечивать красным, когда цена за них выходит.
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/ru/loot/first-script
4Синтаксис и типы
Как устроен LootScript: выполнение по барам, объявление скрипта, пять форм присваивания, типы и квалификаторы, na, история x[n], операторы, условия, switch, циклы, функции и свои типы.
Эта страница — краткое описание языка: как выполняется скрипт, как объявлять переменные, какие есть типы, что такое na, как читать прошлые бары, как писать условия, циклы и функции. Все примеры — целые рабочие скрипты: их можно вставить в редактор и добавить на график.
Как выполняется скрипт
Всё, что написано на верхнем уровне файла, выполняется один раз на каждый бар — от самого старого загруженного к текущему, строка за строкой. Поэтому переменная в LootScript хранит не одно число, а значение на каждом баре, и к прошлым значениям можно обратиться.
indicator("Тело свечи")
body = close - open // считается заново на каждом баре
plot(body, "Тело", style = plot.style_columns)На текущем, ещё не закрытом баре скрипт пересчитывается с каждым новым тиком, начиная с состояния, которое было на закрытии предыдущего бара. Закрытые бары при этом не пересчитываются.
Объявление
Первая инструкция скрипта — ровно одно объявление: indicator(...), strategy(...) или library(...). Выше него могут стоять только комментарии и необязательная строка версии #version 1. Без объявления скрипт не скомпилируется с ошибкой «Нет объявления скрипта — начните с indicator(“Название”)».
#version 1
// Комментарии и строка версии могут стоять выше объявления.
indicator("Размах бара", shortTitle = "Размах", overlay = false)
plot(high - low, "Размах", style = plot.style_histogram)Главные параметры индикатора: title — название в списке скриптов, shortTitle — короткое имя для легенды, overlay — рисовать поверх цены (true) или в отдельной панели (false, по умолчанию). Параметры стратегии описаны на странице Стратегии и тестер.
Переменные и присваивание
| Форма | Что делает |
|---|---|
x = выражение |
Объявляет переменную. На каждом баре она считается заново. |
x := выражение |
Присваивает новое значение уже объявленной переменной. Тип должен совпадать. |
var x = выражение |
Объявляет переменную один раз, на первом баре. Значение переходит на следующие бары. |
varip x = выражение |
Как var, но значение сохраняется и между тиками текущего бара. |
[a, b, c] = функция(...) |
Раскладывает несколько результатов функции по переменным. |
Для изменения уже объявленной переменной есть и короткие формы: +=, -=, *=, /=, %=. Тип можно указать явно: 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 нужен редко — например, чтобы считать тики внутри бара. На истории тиков нет, поэтому такое значение на прошлых барах будет другим, чем было вживую. Если значение 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>, а также ваши собственные типы и перечисления (см. ниже) и графические объекты 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.* должны быть постоянными — литералом или настройкой. Иначе функции пришлось бы пересобирать своё состояние на каждом баре.
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допустимо.- Отрицательный индекс — ошибка: заглядывать в будущие бары нельзя.
- Настраивать глубину истории не нужно: скрипту доступна вся история, загруженная на график.
Операторы
От высшего приоритета к низшему:
| Приоритет | Операторы |
|---|---|
| 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 выбирает первую подходящую ветку. Форма с объектом сравнивает его со значениями веток, форма без объекта проверяет условия по порядку. Ветка => без условия — ветка по умолчанию. Проваливания в следующую ветку нет. Когда switch возвращает значение, ветка по умолчанию обязательна.
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(), "Средняя из массива")Бесконечный цикл терминал не повесит: у скрипта есть бюджет операций на бар и лимит времени. Превысив их, скрипт остановится с сообщением «Скрипт исчерпал бюджет операций на бар — упростите цикл» или «Скрипт превысил лимит времени на проход».
Функции
Функция объявляется словом 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)Функции, нужные в нескольких скриптах, выносят в библиотеку: скрипт с объявлением library("Имя", 1), перед функциями — слово export, в другом скрипте — import Имя/1 as имя. Библиотека берётся из вашей папки скриптов.
Несколько результатов
Некоторые функции возвращают сразу несколько рядов: 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 перечисление превращается в выпадающий список в настройках — см. Настройки и отрисовка.
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)Вынести вызов нельзя, только если его аргумент сам рождается внутри ветки. Тогда компилятор не угадывает, а сообщает: «Аргумент «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/ru/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), настройка вернётся к значению из кода.
Окно настроек открывается двойным щелчком по строке индикатора в легенде графика или значком настроек в этой строке. Кроме вкладки Входные данные в нём есть Стиль и Видимость — о них ниже.
Линии: 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 ставит значок на тех барах, где условие истинно. 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/ru/loot/inputs-drawing
6Данные рынка: кластеры, дельта, OI, стакан
Что скрипт на LootScript читает помимо свечей: кластеры, дельта, открытый интерес, фандинг, история и живой стакан, лента, скринер, другой таймфрейм и инструмент.
Кроме свечей скрипт на LootScript читает данные потока ордеров: кластеры, дельту, открытый интерес, фандинг, записанную историю стакана, живой стакан и ленту, метрики скринера. Включать ничего не нужно: как только скрипт обращается, например, к cluster.poc, терминал сам подписывается на кластеры инструмента и таймфрейма графика — даже если график показывает обычные свечи. Когда скрипт снимают с графика, подписка освобождается.
На этой странице — что есть в каждом пространстве имён, откуда берутся данные, на каких биржах они есть и как взять значения другого таймфрейма или другого инструмента.
Главное правило: нет данных — это na, а не 0
Любое значение из этой страницы может оказаться na. Так бывает, если биржа не покрыта сервером, таймфрейм не поддерживается, история ещё загружается или бар старше доступной истории. Ноль означал бы «торгов не было», а это другой факт: накопленная сумма с подставленными нулями выглядит правдоподобно и при этом неверна.
У каждого пространства есть флаг наличия — 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)Почему данных нет, подсказывает легенда графика рядом с именем скрипта: «площадка не покрыта», «таймфрейм не поддерживается», «данные загружаются…», «нет открытого стакана», «скринер недоступен».
Что откуда берётся
| Пространство | Что это | История на графике |
|---|---|---|
cluster.* |
Кластеры (футпринт) бара: объём по ценам | Есть, с сервера кластеров |
delta.* |
Дельта агрессивных покупок и продаж | Есть |
oi.* |
Открытый интерес | Есть |
funding.* |
Ставка фандинга и её расчёты | Есть |
depth.* |
Стакан, записанный сервером, по барам | Есть, ограниченной глубины |
book.* |
Живой стакан | Только последний бар |
tape.* |
Живая лента сделок | Только последний бар |
screener.* |
Метрики скринера по инструменту | Только последний бар |
Кластеры: cluster.*
Объём каждого ценового уровня внутри бара с разделением на агрессивные покупки и продажи — те же данные, что рисует кластерный график. Уровни нумеруются снизу вверх, от 0 до cluster.levels - 1.
| Имя | Что возвращает |
|---|---|
cluster.available |
Есть ли кластеры на этом баре |
cluster.levels |
Число ценовых уровней в баре |
cluster.price(i) |
Цена уровня i |
cluster.bid(i) |
Агрессивные покупки на уровне i |
cluster.ask(i) |
Агрессивные продажи на уровне i |
cluster.total |
Весь объём бара |
cluster.delta |
Покупки минус продажи по всем уровням |
cluster.poc, cluster.poc_index |
Цена и номер уровня с наибольшим объёмом |
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) |
Нижняя и верхняя граница зоны стоимости; pct — доля объёма, 0.7 = 70 % |
cluster.grid_step |
Шаг ценовой сетки бара |
Обратите внимание на названия: cluster.bid(i) — это покупки, которые «сняли» аск, а не заявки на покупку в стакане.
Кластеры есть на таймфреймах от 30 секунд до одного дня.
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.value |
Дельта бара: покупки минус продажи |
delta.buy, delta.sell |
Эти две части по отдельности |
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 начинается с нуля на первом загруженном баре, поэтому её уровень зависит от глубины загруженной истории. Сравнивайте изменения, а не абсолютные значения.
Дельта есть на таймфреймах от 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)Открытый интерес: oi.*
| Имя | Что возвращает |
|---|---|
oi.open, oi.high, oi.low, oi.close |
Открытый интерес за бар в единицах, которые публикует биржа |
oi.coins |
Открытый интерес в монетах |
oi.usd |
Открытый интерес в валюте котировки |
oi.change |
Изменение oi.close к предыдущему бару |
oi.available |
Есть ли данные на этом баре |
Единицы oi.open…oi.close у бирж разные, поэтому для сравнения бирж берите oi.coins или oi.usd. Открытый интерес приходит с минутной сеткой: на секундных таймфреймах все значения — 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.rate |
Прогноз ставки на ближайший расчёт |
funding.interval_hours |
Часов между расчётами |
funding.settled |
true на баре, где прошёл расчёт |
funding.settled_rate |
Ставка, реально списанная на этом баре; если расчётов в баре несколько — их сумма |
funding.cum |
Сумма списанных ставок за загруженную историю |
funding.available |
Есть ли фандинг у инструмента |
Ставка — доля, а не проценты: 0.0001 — это 0,01 %. График показывает проценты, язык ничего не пересчитывает. Для проверки гипотез на истории берите funding.settled_rate: funding.rate — это прогноз, он меняется до самого расчёта. У спота фандинга нет, на секундных таймфреймах значения — 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)История стакана: depth.*
Стакан в том виде, в каком его записал сервер, — те же данные, что рисует теплокарта, — разложенный по барам. В отличие от живого book.*, эти значения есть на каждом записанном баре. Цены сгруппированы в корзины, объём корзины — наибольший за бар, в монетах.
| Имя | Что возвращает |
|---|---|
depth.available |
Записан ли стакан для этого бара |
depth.levels |
Число непустых корзин в баре |
depth.price(i) |
Нижняя граница корзины i, по возрастанию |
depth.qty(i) |
Наибольший объём, стоявший в корзине за бар |
depth.side(i) |
+1 биды, -1 аски, 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) |
Цена и объём самой тяжёлой корзины стороны в полосе |
Ограничения:
- Данные есть там же, где серверная теплокарта, и на таймфреймах от секунды.
- Сервер хранит полосу примерно ±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)Чтобы нарисовать записанный стакан под свечами, достаточно одной строки heatmap.depth() в скрипте с overlay = true. Цвета и пороги поля — на странице Настройки и отрисовка.
indicator("Записанный стакан теплом", overlay = true)
heatmap.config(palette = heatmap.inferno, low = 25)
heatmap.depth()Живой стакан и лента: book.* и tape.*
Живой стакан и ленту никто не записывает, поэтому значения есть только на последнем баре, а на истории — всегда na. Для них нужна открытая панель стакана по тому же инструменту: иначе book.available и tape.available ложны, а в легенде — «нет открытого стакана». В режиме реплея эти данные недоступны.
| Имя | Что возвращает |
|---|---|
book.bid(i), book.ask(i) |
Цена уровня i; 0 — лучшая цена |
book.bid_qty(i), book.ask_qty(i) |
Объём на уровне, в монетах |
book.spread |
Лучший аск минус лучший бид |
book.mid |
Середина между лучшими ценами |
book.imbalance(n) |
Перекос объёма по n верхним уровням каждой стороны: от -1 до +1 |
book.available |
Есть ли снимок стакана |
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 |
Подключена ли лента |
Окно ленты и глубину book.imbalance задают числом в коде или настройкой input.int. Окно отсчитывается от времени последней сделки на бирже, а не от часов компьютера. Скрипту доступен только хвост ленты — около двух тысяч последних сделок, поэтому на активном рынке длинное окно покажет не весь интервал.
Когда такое значение попадает в 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.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) |
Относительный объём | "1h" "24h" |
screener.natr(w) |
NATR | "1m" "5m" |
screener.oi_delta(w) |
Изменение открытого интереса | "1m" "5m" "1h" "24h" |
screener.btc_corr(w) |
Корреляция с BTC | "1m" "5m" |
screener.available |
Покрыт ли инструмент скринером | — |
Окно, которого нет в таблице, даёт na. Метрика, которая не входит в вашу подписку на скринер, — тоже na. Редактор помечает вывод этих значений тем же предупреждением, что и у стакана: на истории ряд пуст.
indicator("Скринер: RVOL и NATR", overlay = false)
plot(screener.rvol("1h"), "RVOL 1h", color = color.orange)
plot(screener.natr("5m"), "NATR 5m", color = color.teal)Покрытие бирж
| Биржа | Кластеры и дельта | Открытый интерес и фандинг |
|---|---|---|
| Binance, Bybit, OKX, Bitget, Gate.io, MEXC, KuCoin, BingX, AsterDEX | Спот и фьючерсы | Фьючерсы |
| Hyperliquid | Фьючерсы; спот — нет | Фьючерсы |
| Binance Alpha | Нет: биржа не публикует сторону агрессора | Нет |
| Upbit | Нет | Нет |
| Данные | Таймфреймы |
|---|---|
| Кластеры | От 30 секунд до 1 дня |
| Дельта | От 30 секунд |
| Открытый интерес, фандинг | От 1 минуты |
| История стакана | От 1 секунды, там же, где серверная теплокарта |
| Живой стакан, лента | Любые, при открытой панели стакана |
| Скринер | Любые, для инструментов, которые видит скринер |
Покрытие определяет сервер данных, и оно может меняться. Надёжнее всего полагаться на флаг .available и подпись в легенде.
Другой таймфрейм и другой инструмент
request.security считает выражение на другой серии — старшем таймфрейме или другой монете — и сопоставляет результат с барами графика.
request.security(symbol, timeframe, expression, gaps = false, lookahead = false, ignore_invalid_symbol = false)- symbol — в формате «БИРЖА:ТИКЕР», как в TradingView:
"BINANCE:BTCUSDT.P", где.P— бессрочный фьючерс. Инструмент графика —sym.ticker. - timeframe — строка вида
"5","60","4h","1D","1W". Таймфрейм графика —tf.period. - expression — число или несколько чисел в квадратных скобках:
[high, low].
Без заглядывания вперёд. По умолчанию бар графика видит значение последнего закрытого бара старшего таймфрейма. Поэтому часовая EMA на пятиминутках — ступенька, которая сдвигается только на закрытии часа. Так результат на истории совпадает с тем, что вы увидели бы вживую.
gaps = true— значение только на первом баре графика, где появился новый старший бар, дальшеna.ignore_invalid_symbol = true— неизвестный символ даётna. Без этого скрипт останавливается с ошибкой «Символ … неизвестен».
Внутри выражения доступны свечи другой серии и расчёты по ним. Переменную графика туда передать нельзя — только значения настроек input.*. Стакан, лента и скринер внутри запроса не компилируются, а кластеры, дельта, открытый интерес и фандинг другой серии дают na. У скрипта может быть до 8 разных пар «инструмент + таймфрейм» и до 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/ru/loot/market-data
7Стратегии и тестер
Как написать стратегию на LootScript и проверить её на истории в тестере: объявление strategy(), заявки, модель исполнения, издержки, вкладки отчёта и ограничения бэктеста.
Стратегия — это скрипт, который кроме линий на графике подаёт заявки. Заявки исполняет не биржа, а симулятор внутри терминала: он прогоняет стратегию по истории графика с комиссиями, проскальзыванием и фандингом и показывает результат в окне Тестер стратегии.
Объявление 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 |
Проскальзывание в тиках |
pyramiding |
0 |
Сколько входов в одну сторону может быть открыто; 0 — один |
positionModel |
strategy.model.netting |
Одна общая позиция или раздельные длинные и короткие (strategy.model.hedging) |
processOrdersOnClose |
false |
Исполнять рыночные заявки по закрытию текущего бара |
calcOnEveryTick |
false |
Разрешить заявки на формирующемся баре |
marginLong, marginShort, leverage |
0, 0, 1 |
Маржа в процентах или плечо; при 0 ликвидация не моделируется |
applyFunding |
true |
Учитывать фандинг |
fillModel |
strategy.fill.conservative |
Предположение о пути цены внутри бара |
Значения параметров — только числа и константы прямо в тексте. Выражение или input.* в объявлении — ошибка компиляции. Параметр calcOnOrderFills принимается, но в этой версии не действует: на вкладке «Свойства» тестера он помечен «не действует в этой сборке».
Размер заявки при qty = na задаёт defaultQtyType:
| Тип | defaultQtyValue означает |
|---|---|
strategy.qty.fixed |
Количество в монетах (базовой валюте) |
strategy.qty.cash |
Сумму в валюте котировки |
strategy.qty.percent_of_equity |
Процент текущего капитала |
strategy.qty.risk_percent |
Процент капитала, которым рискуете до защитного стопа |
Для strategy.qty.risk_percent нужен strategy.exit со стопом (loss или stop), иначе компилятор остановит: «требует стоп, от которого считать размер». Количество округляется вниз до шага количества инструмента. Если после округления остаётся ноль, заявка отклоняется и попадает в счётчик тестера «Отвергнуто заявок (размер)».
Заявки
| Функция | Что делает |
|---|---|
strategy.entry(id, direction, qty, limit, stop, …) |
Открывает позицию или разворачивает её. Учитывает модель позиции и pyramiding |
strategy.order(id, direction, qty, limit, stop, …) |
То же без учёта модели позиции и pyramiding |
strategy.exit(id, from_entry, qty, qty_percent, profit, limit, loss, stop, trail_price, trail_points, trail_offset, …) |
Ставит выход — тейк, стоп или трейлинг — на открытый вход |
strategy.close(id, comment, qty, qty_percent) |
Закрывает вход рыночной заявкой |
strategy.close_all(comment) |
Закрывает всё |
strategy.cancel(id), strategy.cancel_all() |
Снимает ещё не исполненные заявки |
Направление — strategy.long или strategy.short. У всех функций есть необязательный when: when = false пропускает вызов. У входов, выходов и закрытий есть ещё comment — текстовая подпись к заявке.
- Тип входа. Без
limitиstop— рыночная заявка, сlimit— лимитная, соstop— стоп-заявка, с обоими — стоп-лимит. Повторныйstrategy.entryс тем жеidзаменяет ещё не исполненную заявку. - Разворот. В модели
nettingвход в противоположную сторону закрывает текущую позицию и открывает новую одним действием. - Единицы выхода.
profitиloss— в тиках от цены входа,limitиstop— абсолютные цены. Трейлинг задаётся парой:trail_offsetплюсtrail_priceилиtrail_points. - Выход без уровней ничего не делает. Компилятор предупредит: «strategy.exit без единого уровня (profit/loss/stop/limit/trail) — пустая операция».
- Перенос стопа. Повторный
strategy.exitс тем жеidзаменяет выход — так двигают стоп.
Состояние стратегии читается рядами: strategy.position_size (со знаком, короткая позиция — отрицательная), strategy.position_avg_price, strategy.equity, strategy.netprofit, strategy.openprofit, strategy.opentrades, strategy.closedtrades, strategy.funding_paid и другими — полный список в справочнике.
Как тестер исполняет заявки
Заявка, поданная на баре, исполняется не раньше следующего бара. Решение принимается по закрытию бара, и исполнять его по той же цене значило бы заглянуть вперёд.
| Заявка | Исполнение |
|---|---|
| Рыночная | По открытию следующего бара плюс проскальзывание. С processOrdersOnClose = true — по закрытию текущего |
| Лимитная | Когда цена проходит лимит, по цене лимита. Если бар открылся за лимитом — по открытию |
| Стоп | Когда цена проходит стоп, по цене стопа плюс проскальзывание. При гэпе — по открытию плюс проскальзывание |
Путь цены внутри бара. Настоящего пути внутри бара тестер не знает и предполагает его. Модель strategy.fill.conservative (по умолчанию) считает, что цена сначала сходила к худшему экстремуму: на растущем баре — открытие → минимум → максимум → закрытие, на падающем — наоборот. Если в одном баре оказались и стоп, и тейк, срабатывает стоп. Модель strategy.fill.optimistic предполагает обратное — годится только для сравнения. Проигрывания по младшему таймфрейму в этой версии нет: в колонке «Путь» каждая сделка отмечена как предположенная моделью.
Издержки.
- Комиссия. Если
commissionValueне задан, тестер берёт тариф по умолчанию: 0,02 % за лимитные исполнения и 0,05 % за рыночные и стоп. Тариф вашего счёта и рибейты терминалу неизвестны. Заданное число действует на все исполнения. - Проскальзывание —
slippageTicksпротив вас на рыночных и стоп-исполнениях. Лимитные не проскальзывают. - Фандинг списывается на каждом реальном расчёте биржи — по фактической ставке и цене закрытия бара расчёта. Для этого нужны данные фандинга: фьючерсы на биржах из таблицы покрытия.
- Маржа. С
marginLong/marginShortили плечом больше 1 тестер моделирует упрощённую изолированную маржу. Длинная позиция ликвидируется при цене вход × (1 − m/2), короткая — при вход × (1 + m/2), где m — доля начальной маржи. Ликвидированная сделка теряет всю начальную маржу.
Сделки, не закрытые к концу истории, закрываются по закрытию последнего бара с причиной «конец данных».
Тестер стратегии
Добавьте стратегию на график
В редакторе скриптов нажмите Добавить на график (Ctrl+Enter). Скрипт с ошибками на график не попадёт.
Откройте тестер
В панели инструментов редактора нажмите Тестер стратегии… — кнопка активна только для скрипта с strategy(...). Второй путь — настройки стратегии из легенды графика (шестерёнка), кнопка Тестер стратегии….
Дождитесь прогона
Тестер считает по свечам, загруженным на графике. Пока их нет, окно пишет «Стратегия ещё не считалась: дождитесь загрузки свечей». Когда приходят новые свечи, результат пересчитывается сам; кнопка Пересчитать запускает полный прогон вручную.
Если на графиках несколько стратегий, нужную можно выбрать прямо в окне тестера.
| Вкладка | Что на ней |
|---|---|
| Сводка | Плитки «Чистая прибыль», «Профит-фактор», «Макс. просадка (по закрытиям)», «Доля прибыльных», «SQN»; полоса «Чего этот бэктест не знает»; кривые капитала, «купил-и-держи», капитала без фандинга и двух просадок |
| Показатели | Результат, риск (просадка по закрытиям и внутри бара отдельно, Шарп, Сортино, Калмар), сделки (доля прибыльных, средние и крупнейшие, серии), издержки (комиссия и фандинг) |
| Сделки | Таблица сделок: вход, выход, причина, объём, P&L, ран-ап, просадка, комиссия, фандинг. Клик по строке прокручивает график к бару входа, Ctrl+C копирует выделенные строки |
| Свойства | Параметры объявления, диапазон баров, шаг цены, шаг количества, минимальный лот, комиссия, счётчики прогона: отклонённые заявки, пропущенные по pyramiding, ликвидации, расчёты фандинга |
В заголовке окна — метки режима: conservative или optimistic по модели исполнения и close-fill при processOrdersOnClose = true. Метки optimistic и close-fill значат, что вживую результат, скорее всего, будет хуже.
Чего стратегия читать не может
Живой стакан и лента. Стратегия, которая читает book.* или tape.*, не компилируется: «Стратегия читает … у стакана и ленты нет истории, бэктест был бы вымыслом». Для истории стакана есть depth.*, для сделок — delta.* и cluster.*.
Скринер. screener.* тоже есть только на последнем баре, но компилятор такую стратегию пропускает. На истории значения скринера — na, поэтому условия на них там не выполняются, и сделок по ним в отчёте не будет.
Заглядывание вперёд. request.security(..., lookahead = true) в стратегии даёт в редакторе предупреждение «Стратегия заглядывает вперёд … отчёт помечен как недостижимый в реальном времени». Относитесь к такому отчёту как к завышенному: на истории стратегия видит значения, которых вживую ещё не было. Подробнее — в разделе Данные рынка.
Пример
Пробой канала с подтверждением дельтой. Вход — на закрытии за границей канала за последние len баров, если дельта бара в ту же сторону. Стоп — в ATR, тейк — вдвое дальше.
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)На бирже без дельты (например, Binance Alpha) при включённой настройке «Подтверждать дельтой» стратегия не сделает ни одной сделки: delta.available там ложно. Это правило na в действии, а не ошибка.
Ограничения
- Только симуляция: реальных заявок нет.
- Лимитные заявки исполняются так, будто вы стояли первым в очереди. Для мейкерских стратегий это главный источник завышенного результата.
- Ваши сделки не двигают цену, частичных исполнений нет: заявка исполняется целиком или никак.
- Путь цены внутри бара предполагается моделью, а не берётся из младшего таймфрейма.
- Ликвидация упрощена: движок ликвидаций биржи, ADL и страховой фонд не моделируются.
- Комиссия — тариф по умолчанию, а не тариф вашего счёта.
- Отсутствие данных — не отсутствие движения: бар без кластеров всё равно двигался.
- Результат зависит от того, сколько истории загружено на графике.
Дальше
https://docs.lootx.trade/ru/loot/strategies
8Алерты из скриптов
Как скрипт на LootScript сообщает о сработке условия: alert() и alertcondition(), частота, взвод условий, куда приходит оповещение и чего у скриптовых алертов нет.
Скрипт может сообщить вам, что на живом рынке выполнилось условие: пробой уровня, всплеск дельты, пересечение линий. Для этого в LootScript есть две функции — alert(), который скрипт вызывает сам, и alertcondition(), условие, которое вы включаете вручную.
Сработка уходит в тот же конвейер, что и остальные оповещения терминала: запись в ленте Оповещения, звук, всплывающая плашка. Всё это считается внутри терминала на вашем компьютере: алерты работают, пока терминал запущен и скрипт стоит на графике.
Два способа
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 |
На каждом пересчёте живого бара, где выполнился вызов |
Частота считается для каждого вызова alert() отдельно: два вызова в одном скрипте не глушат друг друга. За один пересчёт скрипт отправляет не больше 16 алертов, остальные отбрасываются.
Пример: алерт на всплеск дельты, как только он появился на формирующемся баре.
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.available ложно и алерт молчит — подробнее о правиле na в разделе Данные рынка.
alertcondition(): условие, которое взводите вы
alertcondition(condition, title, message)condition — логическое выражение, title — название условия, message — текст оповещения. title и message — строки прямо в коде, собрать их из чисел нельзя. Без message в оповещение уйдёт title.
Условие звенит только на закрытии бара, не чаще раза за бар и только если оно взведено. По умолчанию все условия выключены.
Добавьте скрипт на график
В редакторе скриптов нажмите Добавить на график.
Откройте вкладку «Вывод»
В консоли под кодом выберите вкладку Вывод. Там показаны значения рядов на последнем баре и список «Условия алертов (alertcondition) — взведите нужные».
Взведите условия
Отметьте галочками условия, по которым хотите получать оповещения. Если скрипт стоит на нескольких графиках, у каждого свой список.
История молчит
Алерты звенят только на живых обновлениях. Первый расчёт после загрузки графика, после смены инструмента и после подгрузки более старой истории считается историей: на прошлых барах ни alert(), ни alertcondition() не срабатывают. Поэтому, добавив скрипт на график, вы не получите пачку оповещений за прошлое.
Проверить условие на истории можно глазами: нарисуйте его меткой plotshape — она покажет каждый бар, где алерт бы сработал.
Куда приходит алерт
Каждая сработка:
- Записывается в ленту «Оповещения» с источником «Скриптовый алерт». В записи — текст сообщения, имя скрипта и, для
alertcondition(), название условия. Лента открывается отдельным окном или панелью рабочего пространства; фильтр Источники оставляет в ней только скриптовые алерты. - Проигрывает звук. Его выбирают в Настройки → Оповещения, блок «Звуки», строка «Скриптовый алерт»: список звуков и переключатель, который выключает звук.
- Показывает плашку «Имя скрипта: текст».
- Подсвечивает вкладку рабочего пространства, где стоит график со скриптом.
Остальные оповещения терминала описаны на странице Алерты и уровни.
Журнал: 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, "Пробой вверх", "Цена закрылась выше канала")Граница берётся со сдвигом [1] — по предыдущим барам, иначе текущий максимум всегда был бы внутри канала. Частота freq_once_per_bar_close значит, что алерт придёт после закрытия бара над каналом, а треугольник на графике останется ровно там, где алерт прозвенел. В реальном скрипте обычно оставляют один из двух способов — здесь оба для сравнения.
Дальше
https://docs.lootx.trade/ru/loot/alerts
9ИИ-помощник в редакторе
Чат с моделью ИИ в редакторе LootScript: пишет и правит скрипты, проверяет их на свечах, отвечает про рынок. Какие провайдеры есть, где ввести ключ и что уходит с компьютера.
В редакторе LootScript есть чат с моделью ИИ. Опишите словами, какой индикатор нужен, — помощник напишет код прямо в редакторе, скомпилирует его, прогонит на реальных свечах и расскажет, что получилось. Он же правит готовые скрипты, объясняет чужой код и отвечает на вопросы о рынке по данным терминала.
Модель вы выбираете сами: облачную — со своим ключом API, или локальную — на своём компьютере. Запросы идут от терминала напрямую к выбранному провайдеру, без серверов LootX.
Как открыть помощника
- Нажмите ƒ на панели графика — откроется окно Индикаторы.
- Нажмите Редактор… рядом со строкой поиска или откройте свой скрипт.
- В верхней панели редактора, рядом с Добавить на график, нажмите Помощник.
Чат встанет справа от кода. Ширину можно менять, перетаскивая разделитель. Крестик в шапке чата (Скрыть чат) убирает его, не стирая разговор; повторное нажатие Помощник возвращает.
Подключение модели
Откройте карточку подключения
При первом вопросе карточка откроется сама. Позже её вызывает шестерёнка Ключ и подключение в шапке чата.
Выберите провайдера
Список — в таблице ниже. По умолчанию выбран Claude.
Вставьте ключ API
Под полем есть ссылка Получить ключ на … — она ведёт в кабинет провайдера. Сохранённый ключ в поле не показывается: оставьте его пустым, чтобы не менять, или нажмите Удалить ключ.
Проверьте модель и сохраните
Поле Модель заполнено моделью по умолчанию, в подсказках — ещё несколько. Имя можно вписать любое, какое знает провайдер. Нажмите Сохранить.
| Провайдер | Что нужно |
|---|---|
| Claude | Ключ API Anthropic. Подписка Claude не подходит — Anthropic запрещает сторонним программам работать по ней. |
| Gemini | Ключ API Google. Подписка Gemini не подходит по той же причине. |
| OpenAI, DeepSeek, Grok, Mistral, Qwen, Kimi, GLM, Groq | Ключ API провайдера. |
| OpenRouter | Ключ OpenRouter: через него доступны модели разных компаний. |
| Ollama, LM Studio | Ключ не нужен: модель работает на вашем компьютере. Запустите сервер, загрузите модель и впишите её имя. |
| Совместимый с OpenAI | Любой сервер с API в формате OpenAI Chat Completions: шлюз, vLLM, корпоративный прокси. Укажите адрес (обычно оканчивается на /v1), модель и ключ, если сервер его требует. |
Облачные запросы оплачиваются по тарифу вашего аккаунта у провайдера, отдельно от LootX. После каждого ответа в чате видно, сколько токенов ушло на вход и на выход.
Локальной модели нужна поддержка вызова инструментов (tool calling). Без неё помощник не сможет писать в редактор и проверять код.
Прокси и свой адрес
Если сервис провайдера недоступен из вашей сети напрямую, укажите прокси в поле Прокси — http://host:port или socks5://логин:пароль@host:port. Прокси общий для всех провайдеров. Поле Адрес API (для своего шлюза) нужно, только если вы ходите к провайдеру через собственный шлюз.
Что умеет помощник
- Пишет новый скрипт по описанию и сразу кладёт код в редактор.
- Правит готовый — точечно, не переписывая файл целиком.
- Проверяет себя. Компилирует код и запускает его на реальных свечах — по умолчанию на инструменте и таймфрейме графика, до 5000 последних баров, по просьбе на любом другом. Смотрит, что вышло в каждом ряду и нет ли ошибок выполнения.
- Добавляет скрипт на график, когда вы об этом просите.
- Отвечает про рынок. Берёт свечи любого инструмента из терминала, метрики скринера (волатильность, объём, открытый интерес, фандинг, спред) и ранжирует рынок: «Какие фьючерсы сейчас самые волатильные?».
- Сверяется со справочником языка, смотрит встроенные индикаторы и скрипты из вашей библиотеки.
Каждый шаг виден в ленте строкой: «Компилирую», «Запускаю на свечах», «Правлю код». Если модель показывает ход рассуждений, он свёрнут в блок Ход мыслей. Ответ можно прервать кнопкой Остановить.
Всё, что помощник пишет в редактор, отменяется обычным Ctrl+Z. Если код в ответе пришёл блоком, в его шапке есть кнопки. У целого скрипта это В редактор — заменить код в редакторе, у фрагмента — Вставить в позицию курсора. Копировать есть у обоих.
Быстрые команды
Наберите / в поле ввода — появится подсказка. Те же команды есть кнопками в пустом чате. Текст после команды — ваше уточнение: /fix смотри на объём.
| Команда | Что делает |
|---|---|
/fix |
Находит и исправляет ошибки: компилирует, запускает на свечах, чинит ошибки и ряды, где одни na. Сохраняет ваш замысел и стиль, в конце перечисляет правки. |
/explain |
Объясняет простыми словами, что считает скрипт, на что влияет каждая настройка, что он рисует и как читать сигналы. Код не меняет. |
/optimize |
Ускоряет скрипт, не меняя результата: заменяет самописные циклы встроенными функциями, убирает лишнюю работу и проверяет прогоном, что значения не изменились. |
Другое слово после косой уходит модели обычным вопросом.
Картинки и снимки графика
К вопросу можно приложить картинку: скрепкой под полем ввода, вставкой из буфера (Ctrl+V) или перетащив файл в чат. Кнопка с графиком рядом со скрепкой прикладывает снимок той панели, куда добавляется скрипт. В одном вопросе — до шести картинок. Перед отправкой большие изображения уменьшаются.
Не все модели видят картинки. Если выбранная не видит, чат предупредит до отправки. Если терминал не знает, видит ли модель картинки, и провайдер отклонит вопрос, картинки вернутся в поле ввода.
История разговоров
Разговор привязан к скрипту. Откроете другой скрипт — в чате его разговор. Закроете редактор или перезапустите терминал — разговор останется на месте.
- У нового, ещё не сохранённого скрипта разговор на диск не пишется. Он сохранится вместе со скриптом при первом Сохранить.
- Значок Новый чат в шапке начинает разговор заново и стирает прежний с диска.
- Удалили скрипт — удалился и его разговор.
- Пока помощник отвечает, открыть другой скрипт нельзя: сначала остановите ответ.
Весь разговор уходит модели с каждым вопросом, поэтому длинный чат дорожает. Размер разговора в токенах показан числом в шапке чата, например «42k». Нажмите на него, чтобы сжать разговор в сводку: дальше помощник помнит его по ней. Старые результаты проверок и картинки терминал сворачивает сам. В сохранённой истории старые картинки со временем заменяются пометкой «Картинка к этому вопросу больше не хранится».
Что уходит с компьютера
К выбранному провайдеру, напрямую:
- ваши сообщения и приложенные картинки;
- название скрипта, число строк и ошибок, инструмент и таймфрейм графика — с каждым вопросом;
- код из редактора и отчёт компилятора — когда помощник читает или правит скрипт;
- данные, которые помощник запросил: свечи, метрики скринера, результаты прогонов, фрагменты документации языка.
Не уходит:
- Секреты. Ключей бирж помощник не видит. Ключ провайдера хранится на этом компьютере в зашифрованном виде, не попадает в синхронизацию настроек и передаётся только самому провайдеру — для входа. Из текста, который уходит модели, терминал вырезает всё, что похоже на ключ, токен или пароль, а также пути к файлам на диске. Сообщение, в которое вы сами вставили что-то похожее на ключ, не отправляется вовсе — чат попросит убрать секрет.
- Счёт. У помощника нет доступа к балансу, позициям и заявкам — он видит только то, что вы показали на снимке. Выставлять заявки он не умеет.
- История чата. Она лежит на этом компьютере в зашифрованном виде и не попадает ни в синхронизацию, ни в экспорт настроек, ни в отчёт для поддержки.
С Ollama или LM Studio разговор и код не покидают компьютер.
Ограничения
- Потоковых данных в проверочном прогоне нет. Кластеры, дельта, открытый интерес, фандинг, стакан, лента, скринер и история стакана при запуске на свечах равны
na. Логику, которая на них опирается, помощник проверить не может — добавьте скрипт на график и посмотрите сами. - Предел шагов. За один ответ помощник делает не больше 24 шагов, потом подводит итог. Ответ, оборванный по длине, тоже можно продолжить — просто попросите.
- Модель ошибается. Прогон ловит ошибки компиляции и выполнения, но не ошибки замысла. Перед тем как полагаться на сигналы, посмотрите скрипт на графике.
- Отказы провайдера чат показывает текстом с именем провайдера: ключ не принят, исчерпан лимит запросов, закончились деньги или квота, нет связи, локальный сервер не отвечает. Для связи проверьте интернет или укажите прокси.
Дальше
https://docs.lootx.trade/ru/loot/ai-assistant
10Импорт из Pine 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.
Что делает конвертер
- Отступы → фигурные скобки. Блоки
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(…)вокруг цвета. - Имена. Старые имена без пространства получают его:
sma→ta.sma.study→indicator,security→request.security,tostring→str.tostring,syminfo.*→sym.*,timeframe.*→tf.*. Короткая формаinput(…)получает тип:input.int,input.sourceи так далее. - Занятые имена. Переменная, чьё имя в LootScript — ключевое слово или пространство (
delta,oi,tf,sym,func…), получает подчёркивание в конце везде, где встречается:delta→delta_. - Лишние аргументы — те, которых у функции в LootScript нет, — снимаются.
- Объявление. Если в файле не было
indicator(…)илиstrategy(…), конвертер добавитindicatorс именем файла. - Комментарии и пустые строки остаются на своих местах.
Конвертер не отказывает ни на каком файле. Строку, которую он не понял, он не выбрасывает, а оставляет комментарием // [не разобрано] … на прежнем месте.
Шапка с заметками
Первая строка шапки говорит, откуда файл, — «Импортировано из скрипта на Pine Script (версия 5). Заметки конвертера:». Дальше по строке на каждую правку, по порядку строк исходника: «Строка N: вид: что — подробности». Заметки пишутся на языке интерфейса.
| Вид заметки | Что значит | Проверить? |
|---|---|---|
| переименовано | Имя заменено на аналог в LootScript | нет |
| пересчитано | Прозрачность переведена в альфу | нет |
| переписано | Изменилась форма: цикл, return, тип короткого input |
взглянуть |
| имя «…» занято в LootScript | Переменной добавлено подчёркивание | нет |
| объявления indicator(…) не было | Объявление добавлено из имени файла | нет |
| аргумент снят | У функции в LootScript нет такого параметра | да |
| допущение | Конвертер угадал: направление цикла, тип ввода, который не удалось вывести | да |
| нет в этой сборке | Такой функции в терминале нет — скрипт не скомпилируется с ошибкой «неизвестное имя» | да |
| не разобрано | Строку не удалось разобрать, она сохранена комментарием | да |
Когда проверите, шапку можно удалить — это обычные комментарии.
Пример
Небольшой индикатор на 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 снят — такого параметра нет. Заметка «аргумент снят» просит проверить, не нужен ли этот параметр по смыслу. Здесь он лишь рисовал линию последнего значения, и скрипт работает без него.
Как проверить и доработать
- Прочитайте шапку. Начните со строк с видами «аргумент снят», «допущение», «нет в этой сборке» и «не разобрано».
- Посмотрите вкладку «Проблемы» в консоли редактора. Скрипт с ошибками на график не добавится.
- Добавьте на график и сравните с тем, что показывал оригинал, на нескольких участках истории.
- Попросите помощника. Откройте ИИ-помощника и наберите
/fix— он скомпилирует скрипт, прогонит его на свечах и исправит ошибки. Можно добавить уточнение:/fix разбери заметки конвертера в шапке./explainрасскажет, что делает скрипт.
Что не переносится
- Функции, которых нет в терминале. Имя остаётся в коде, заметка «нет в этой сборке» и ошибка компилятора указывают на одно и то же место. Замените вызов вручную или попросите помощника подобрать аналог.
- Многострочные строки, импорт чужих библиотек, экспорт функций. Конвертер переносит то, что может записать, и отмечает остальное.
- Больше трёх линий. Панель графика рисует только первые три
plotскрипта. Лишние ряды разнесите по отдельным скриптам. - Реальная торговля. Объявление
strategy(…)переносится, но стратегия LootScript торгует только в тестере стратегий — на симулированном счёте.
Дальше
https://docs.lootx.trade/ru/loot/pine-import
11Ошибки компиляции и выполнения
Все коды LS, которые показывают редактор и график LootScript: текст сообщения, причина и исправление, частые ошибки с примерами, пределы выполнения и случаи, когда вместо ошибки получается na.
Каждое сообщение компилятора и исполнителя LootScript начинается с кода вида LS2008. Код не меняется между версиями и не зависит от языка интерфейса, поэтому по нему удобно искать: здесь собраны все коды, которые может показать терминал, с текстом сообщения, причиной и способом исправления.
Сообщения выводятся по-русски, если интерфейс терминала на русском, и по-английски на любом другом языке. Сначала — ошибки, которые встречаются чаще всего, затем ошибки выполнения и полная таблица.
Где видны ошибки
При компиляции. Редактор компилирует скрипт в каждой паузе набора. Найденное попадает во вкладку «Проблемы» в нижней части редактора: код, текст и позиция вида «Стр 6:6». Двойной щелчок по строке переводит курсор к месту ошибки. В заголовке редактора отображается итог: «ок · 12 мс», «предупреждений: 2» или «ошибок: 1».
При выполнении. Скрипт без ошибок компиляции может остановиться на каком-то баре: закончился бюджет операций, индекс вышел за границы массива, неизвестен инструмент. Тогда во вкладке «Вывод» появится строка «Скрипт остановлен: LS6004: …», а в окне тестера стратегий — та же причина. Остальные скрипты, панели и сам терминал продолжают работать.
Диагностики бывают трёх уровней:
| Уровень | Что значит | Что с графиком |
|---|---|---|
| Ошибка | Скрипт не собран | На график не добавляется: «Скрипт с ошибками на график не кладётся — см. «Проблемы»». Если скрипт уже на графиках, там остаётся прежняя рабочая версия |
| Предупреждение | Скрипт собран, но результат может обмануть: например, перерисуется на живом баре | Скрипт работает |
| Сведение | Скрипт собран, но какая-то его настройка ничего не делает | Скрипт работает |
Как устроены коды
| Коды | Этап | О чём |
|---|---|---|
| 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 — неизвестное имя
«Неизвестное имя «…» — проверьте написание или объявите его выше». Чаще всего это опечатка или функция без своего пространства имён: все индикаторные функции живут в 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) — переменная, функция или тип названы так же, как встроенный ряд или функция: close, time, hour, volume. Переименуйте: startHour вместо hour. Имена пространств вроде color или position для переменных можно использовать.
LS2004 и LS2005 — аргументы вызова
««…» ожидает … аргумент(ов), а передано …» (LS2004) и «У «…» нет параметра «…»» (LS2005). Сверьте вызов с сигнатурой в справочнике: имена параметров пишутся ровно так, как там указано.
plot(close, colour = color.red)plot(close, color = color.red)LS3011 и LS5011 — стратегии
«strategy.* доступно только в strategy(…)» (LS3011): заявки и состояние позиции есть только у скрипта, объявленного через strategy(...). Замените indicator("…") на strategy("…").
«Стратегия читает «…»: у стакана и ленты нет истории, бэктест был бы вымыслом» (LS5011): стратегия проверяется на истории, а у book.* и tape.* истории нет — на каждом прошлом баре там na.
strategy("Перекос стакана")
if book.imbalance(10) > 0.5 {
strategy.entry("L", strategy.long)
}Для истории стакана есть пространство 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без[1]: незакрытый бар ещё изменится. - LS5002 —
lookahead = trueвrequest.security: на истории скрипт видит будущее. - LS5005 — до графика доходит
math.randomилиtimenow: два прогона дадут разные линии.
Если так и задумано — например, индикатор нужен только для живой торговли, — предупреждение можно оставить.
LS3016 — настройка принята и ничего не делает
Это сведение, а не ошибка. Оно встречается в скриптах, перенесённых с других платформ: параметр существует ради совместимости, но в терминале ни на что не влияет. Вторая часть сообщения объясняет почему.
| Что написано | Пояснение в сообщении |
|---|---|
maxBarsBack в объявлении |
история грузится колонкой целиком |
format, precision, scale в объявлении |
шкалу значений и её формат ведёт терминал |
timeframe в объявлении |
скрипт считается на таймфрейме графика, другой даёт request.security |
Толщина, стиль или другая настройка вывода, заданная выражением, а не константой (цвет plot и отметок может меняться по барам) |
эта сборка читает эту настройку только константой |
color у четвёртого и следующих plot |
панель рисует только первые три ряда |
location.absolute у plotshape или plotchar |
у отметки нет ряда, к значению которого её можно прижать |
display, которого у ряда нет |
у этого ряда нет такой поверхности |
Ошибки выполнения
Ошибка выполнения останавливает скрипт на том баре, где она случилась. Текст появляется во вкладке «Вывод» в виде «Скрипт остановлен: LS6004: …».
LS6004 и LS6005 — скрипт работает слишком долго
«Скрипт исчерпал бюджет операций на бар — упростите цикл» (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
«Символ «…» неизвестен — проверьте формат «ПЛОЩАДКА:СИМВОЛ» или задайте 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 |
8 | — |
Вызовов request.security |
32 | LS4009 при компиляции |
Когда ошибки нет, а значения нет
Многие ситуации, которые в других языках роняют программу, в LootScript дают na — пропуск на графике, а не остановку:
- арифметика с
naдаётna:close - xпри пустомx— тоже пусто; x[n]глубже начала истории —na;- целочисленное деление на ноль —
na, а дробное деление на ноль скрипт не останавливает; book.*,tape.*иscreener.*на исторических барах —na;- кластеры, дельта, открытый интерес и история стакана —
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 | Шесть или восемь шестнадцатеричных цифр |
| LS0008 | Разделитель разрядов «_» стоит в начале, в конце или сдвоен | Пишите 1_000_000 |
| LS0009 | Неверная директива версии — ожидается #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 пишется в фигурных скобках: if cond { … } | Добавьте фигурные скобки |
LS2000–LS2030 — типы и имена
| Код | Сообщение | Что делать |
|---|---|---|
| LS2000 | Несовпадение типов: ожидался …, а получен … | Передайте значение нужного типа |
| LS2001 | Нельзя преобразовать … в … | Преобразуйте явно: str.tostring, math.round |
| LS2002 | Неизвестное имя «…» — проверьте написание или объявите его выше | Исправьте опечатку, добавьте пространство (ta.), объявите выше |
| LS2003 | «…» — не функция, вызывать нельзя | Уберите скобки: это ряд или константа |
| LS2004 | «…» ожидает … аргумент(ов), а передано … | Сверьте число аргументов со справочником |
| LS2005 | У «…» нет параметра «…» | Исправьте имя параметра |
| LS2006 | Аргумент «…» передан дважды | Уберите повтор |
| LS2007 | Условие должно быть bool, а здесь … | Сравните явно: x > 0, not na(x) |
| LS2008 | Сравнение с na всегда ложно — используйте na(x) | na(x) вместо x == na |
| LS2014 | «…» в «…» требует значение не слабее …, а передано … — возьмите input.*(…) или литерал | Литерал, input.* или константа вместо ряда |
| LS2015 | «…» объявлено константой — присваивать нельзя; объявите через var | Настройку input.*, переменную цикла и параметр функции менять нельзя — скопируйте значение в свою переменную |
| LS2017 | Строку нельзя складывать с числом (… + …) — используйте str.tostring(…) | str.tostring или str.format |
| LS2018 | «…» уже объявлено в этой области | := для нового значения или другое имя |
| LS2019 | «…» затеняет встроенное имя — выберите другое | Переименуйте |
| LS2020 | Ветви дают разные типы: … и … | Приведите ветви к одному типу |
| LS2021 | switch без ветви по умолчанию «=> …» — добавьте её | Добавьте => значение |
| LS2022 | У «…» не выведен тип элемента — укажите его: … | array.new<float>() |
| LS2028 | У поля «…» типа «…» не указан тип — напишите его перед именем: float … | float price в объявлении type |
| LS2029 | export «…»: у экспортируемой функции обязаны быть объявлены типы всех параметров и тип результата | Укажите типы |
| LS2030 | «…» в «…» читается до первого бара — нужен литерал или именованная константа | В объявлении — только постоянные значения |
LS3000–LS3033 — смысл программы
| Код | Сообщение | Что делать |
|---|---|---|
| LS3002 | «…» вызывает саму себя — рекурсия в LootScript запрещена | Замените рекурсию циклом |
| LS3003 | Взаимная рекурсия запрещена: … | Разорвите круг вызовов |
| LS3004 | Аргумент «…» нельзя вычислить вне ветки — вынесите вызов ta.* на верхний уровень | Вычислите аргумент и вызов вне if |
| LS3006 | «…» затеняет имя из внешней области (предупреждение) | Переименуйте внутреннюю переменную |
| LS3007 | «…» вне цикла | break и continue — только в цикле |
| LS3008 | return вне функции | return — только в теле функции |
| LS3009 | export «…» возможен только в library(…) | Уберите export или сделайте файл библиотекой |
| LS3010 | «…» без единого уровня (profit/loss/stop/limit/trail) — пустая операция (предупреждение) | Задайте стоп, тейк или трейлинг |
| LS3011 | strategy.* доступно только в strategy(…) | Объявите скрипт через strategy(...) |
| LS3012 | В библиотеке нельзя рисовать и объявлять входы: … | Перенесите вывод и настройки в индикатор |
| LS3013 | «…» внутри request.security не станет строкой настроек — объявите вход выше и передайте его значение | Объявите input.* выше и передайте переменную |
| LS3016 | Настройка «…» принята и ничего не делает: … (сведение) | Можно оставить или удалить |
| LS3018 | Библиотека «…» не найдена в папке библиотек — имя берётся из её library(“…”, N), а не из имени файла | Проверьте имя в объявлении библиотеки |
| LS3019 | Библиотеки «…» версии … нет; установлены: … | Укажите установленную версию |
| LS3020 | «…» внутри request.security: у стакана и ленты нет истории на чужой серии | Уберите book.*, tape.* из выражения |
| LS3025 | Функция «…» объявлена, но не вызывается — её тело проверено лишь пробно (предупреждение) | Вызовите функцию или удалите |
| LS3026 | «…» требует стоп, от которого считать размер: loss/stop у входа или в strategy.exit | Добавьте стоп к входу или strategy.exit |
| LS3028 | Эта сборка не поддерживает: … | Перепишите без этой конструкции |
| LS3029 | Ветвь switch для «…» повторяется — вторая недостижима | Уберите повтор |
| LS3030 | «…» — переменная графика, а выражение request.security считается на другой серии; передайте значение через input.* или посчитайте его внутри выражения | Посчитайте внутри выражения |
| LS3031 | Библиотеки импортируют друг друга по кругу: … | Разорвите круг импортов |
| LS3032 | В библиотеке «…» допустимы только объявления функций и импорты — здесь … | Уберите из библиотеки остальной код |
| LS3033 | Библиотека «…» не компилируется (…) — откройте её в редакторе и почините | Исправьте ошибку в самой библиотеке |
LS4000–LS4009 — пределы компиляции
| Код | Сообщение | Что делать |
|---|---|---|
| LS4000 | Слишком много рядов: … при пределе 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 | Старший таймфрейм без смещения — незакрытый бар перерисуется; добавьте [1] (предупреждение) | request.security(…, close[1]) |
| LS5004 | Отрицательное смещение сдвигает вывод в прошлое — на истории линия знает будущее | Уберите отрицательный индекс x[-n] |
| LS5005 | Недетерминированное значение доходит до вывода — два прогона дадут разный ряд (предупреждение) | Не выводите math.random и timenow на график |
| LS5006 | Данные есть только в реальном времени — на истории ряд пуст (предупреждение) | Для истории стакана используйте depth.* |
| LS5011 | Стратегия читает «…»: у стакана и ленты нет истории, бэктест был бы вымыслом | Уберите book.*, tape.* из стратегии |
| LS5012 | Стратегия заглядывает вперёд («…») — отчёт помечен как недостижимый в реальном времени (предупреждение) | Уберите lookahead = true |
| LS5013 | «…» включён: заявки исполняются по закрытию бара, отчёт помечен (сведение) | Уберите processOrdersOnClose, если нужен реалистичный отчёт |
LS6000–LS6036 — выполнение
| Код | Сообщение | Что делать |
|---|---|---|
| LS6001 | Индекс … вне границ | Проверьте размер коллекции перед обращением |
| LS6002 | Отрицательное смещение истории — читать будущее нельзя | Индекс истории должен быть ≥ 0 |
| LS6003 | Превышен предел размера коллекции (…) — коллекция создана в строке … | Ограничьте рост: удаляйте старые элементы |
| LS6004 | Скрипт исчерпал бюджет операций на бар — упростите цикл | Проверьте условие выхода из цикла |
| LS6005 | Скрипт превысил лимит времени на проход | Уменьшите работу на каждом баре |
| LS6007 | Обращение к пустому объекту (na) | Создайте коллекцию или объект до обращения |
| LS6014 | Строка длиннее потолка в 100000 знаков — укоротите её или соберите по частям | Сократите строку |
| LS6015 | Неизвестный часовой пояс «…» — нужен идентификатор IANA, например «Europe/Berlin» | Пояс в формате IANA |
| LS6017 | Символ «…» неизвестен — проверьте формат «ПЛОЩАДКА:СИМВОЛ» или задайте ignore_invalid_symbol = true | Исправьте символ |
| LS6018 | Таймфрейм «…» не разбирается — ожидается «5», «60», «4h», «1D», «1W» | Исправьте таймфрейм |
| LS6019 | Объект рисования уже удалён или вытеснен по потолку — создайте его заново | Проверяйте объект или поднимите предел |
| LS6020 | str.format: плейсхолдеру {…} не передан аргумент | Передайте аргумент для каждого {n} |
| LS6021 | str.match: шаблон исчерпал бюджет шагов — упростите его | Упростите регулярное выражение |
| LS6026 | Исчерпан общий бюджет коллекций скрипта (… ячеек) — не влезла коллекция из строки … | Сократите число или размер коллекций |
| LS6027 | Недопустимый аргумент «…» в … | Например, отрицательный размер в array.new |
| LS6028 | Исчерпан бюджет строк скрипта (…) — переиспользуйте строки вместо новых на каждом баре | Не собирайте новые строки на каждом баре |
| LS6029 | В таблице больше 2000 ячеек — это потолок панели | Уменьшите таблицу |
| LS6030 | Ячейка таблицы вне сетки: … | Номер столбца и строки — внутри размера таблицы |
| LS6031 | Встроенная функция «…» объявлена, но не реализована — это дефект сборки, сообщите о нём | Сообщите в поддержку |
| LS6032 | Хэндл не указывает на объект нужного вида — объект освобождён или хэндл из другого прогона | Не храните ссылки на удалённые объекты |
| LS6033 | Поле … вне объявления типа «…» — это дефект сборки, сообщите о нём | Сообщите в поддержку |
| LS6034 | Длина окна … больше потолка 100000 — такое окно не поместится в память | Уменьшите длину окна |
| LS6035 | Шаг цикла равен нулю — счётчик не двигается, и конец недостижим | by в цикле 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/ru/loot/errors
12Примеры скриптов
Восемь готовых скриптов на LootScript: скользящие, RSI, VWAP с полосами, кумдельта с расхождениями, открытый интерес, фандинг, дисбалансы кластеров и стратегия для тестера.
Восемь готовых скриптов на LootScript: от скользящих и RSI до кумдельты, открытого интереса, фандинга и кластеров. Каждый — рабочий индикатор, который можно сразу положить на график и подстроить под себя. Все примеры собираются компилятором текущей версии без ошибок и предупреждений.
Как запустить пример
- Нажмите ƒ на панели графика, в окне Индикаторы — Редактор….
- В редакторе нажмите Новый (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превращается в выпадающий список в настройках.- Функция
maвыбирает среднюю черезswitch. Состояниеta.*живёт у каждого места вызова, поэтому три вызоваma— три независимые средние. - Цвет быстрой линии — выражение: растёт по сравнению с прошлым баром (
m1[1]) — бирюзовая, падает — красная. - Панель рисует до трёх линий
plotна скрипт — поэтому средних три.
2. RSI с зонами и оповещениями
RSI с закрашенной полосой между уровнями. Линия и фон окрашиваются, когда RSI в зоне перекупленности или перепроданности.
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 дня с полосами отклонения
Средневзвешенная по объёму цена с начала суток по UTC и полоса ±σ вокруг неё.
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начинает счёт заново на баре, где якорь истинен. У криптовалютsession.isfirstbar— первый бар после 00:00 UTC.- Переменные
varпереживают переход между барами. Их обнуляет тот же якорь, поэтому полоса считается за тот же период, что и VWAP. - Разброс — корень из средневзвешенного квадрата цены минус квадрат VWAP.
math.max(…, 0)страхует от крошечного минуса из-за округления. - Смысл есть на внутридневных таймфреймах. Хотите VWAP от последней выплаты фандинга — поставьте
anchor = funding.settled.
4. Дневная кумдельта с расхождениями
Кумулятивная дельта, которая обнуляется каждые сутки, и отметки на барах, где цена обновила экстремум, а дельта — нет.
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ложно, и линия прерывается, а не рисует ноль.- Накопитель
varобнуляется в начале суток. Нужна кумдельта по всей загруженной истории без сброса — возьмите готовый рядdelta.cum. - Расхождение: цена на максимуме окна, а кумдельта ниже своего максимума за то же окно. Для минимумов — зеркально.
location.topиlocation.bottomставят отметки у краёв подокна, а не у цены.
5. Всплески открытого интереса
Изменение открытого интереса от бара к бару в процентах и отметки там, где оно выбивается из обычного разброса.
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— открытый интерес на закрытии бара,oi.close[1]— на прошлом баре. Проверкаoi.availableне даёт посчитать изменение из пустоты.- Всплеск — бар, где изменение по модулю больше
kстандартных отклонений за окноlen. - Открытый интерес приходит поминутно. На таймфреймах меньше минуты соседние бары повторяют одно значение, и изменение там нулевое — это данные, а не ошибка.
6. Ставка финансирования
Фандинг бессрочного фьючерса в процентах за период или в пересчёте на год, с отметками выплат и подсветкой высокой ставки.
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записано дробью намеренно: деление двух целых в LootScript отбрасывает остаток. funding.settledистинно на баре, где прошла выплата, — там внизу ставится точка.- Порог задаётся за период и для годовых пересчитывается тем же множителем.
7. Дисбалансы в кластерах
Отметки на графике цены там, где в кластерах бара стоит «лесенка» дисбалансов или их просто много, плюс уровень максимального объёма (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. Порог дисбаланса берётся из настроек кластеров графика, поэтому скрипт видит то же, что вы.cluster.stacked_buy_steps— сколько уровней подряд идёт дисбаланс покупок. Циклfor i in 0 .. levelsсчитает все дисбалансы бара, не только подряд.- Скрипт сам подписывается на кластеры и работает на обычном свечном графике. На бирже без покрытия и на таймфреймах меньше 30 секунд или больше суток кластеров нет — тогда
levelsравно 0 и отметок не будет.
8. Стратегия: пересечение EMA со стопом по ATR
Вход в лонг на пересечении средних, стоп и цель — в долях 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(…)— литералы: капитал 10 000, размер позиции 10 % капитала, проскальзывание 2 тика. Комиссия не задана, поэтому тестер берёт тариф по умолчанию: 0,02 % за лимитное исполнение и 0,05 % за рыночное и стоп. Свой тариф в процентах задаётcommissionValue. - Рыночный вход исполняется по открытию следующего бара, а не по закрытию сигнального: так тестер не заглядывает в будущее.
strategy.exitставит стоп и цель от средней цены входа. Если за один бар задеты оба, тестер по умолчанию считает, что сработал стоп.- Результаты — сделки, кривая капитала, просадки — в окне Тестер стратегии… редактора. Подробнее — на странице Стратегии и тестер.
Дальше
https://docs.lootx.trade/ru/loot/examples