LootX

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

Թարմացվել է 30 սեպտեմբերի, 2026 թ. Այս էջը PDF-ով

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

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

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

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

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

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

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

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

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

Параметры indicator

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

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

Параметры strategy

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

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

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

Ряды бара

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

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

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

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

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

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

Таймфрейм: tf

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

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

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

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

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

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

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

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

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

Осцилляторы

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

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

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

Тренд

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

Объём

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

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

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

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

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

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

math

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

str — строки

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

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

color — цвета

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

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

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

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

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

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

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

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

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

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

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

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

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

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

line

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

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

label

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

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

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

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

table — таблицы

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

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

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

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

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

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

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

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

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

array

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

map

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

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

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

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

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

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

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

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

strategy — стратегии

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

Заявки

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

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

Состояние

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

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

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

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

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

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

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

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

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

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

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

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

Дальше

FAQ

Ինչու sma(close, 20) չի կոմպիլացվում?
LootScript-ում բոլոր Ինդիկատորային ֆունկցիաները գտնվում են ta space-ներում։ Գրեք ta.sma(close, 20). Անունը առանց space-ի կոմպիլյատորը չի ճանաչում և ցույց կտա LS2002 սխալը։
Կարելի՞ է ta.sma-ին փոխանցել տևողություն, որը բարից բար փոխվում է?
Ոչ։ Պատուհանի (window) երկարությունը պետք է հայտնի լինի մինչեւ առաջին բարը՝ որպես լիտերալ, input.int կամ կոնստանտ։ Հակառակ դեպքում կոմպիլյատորը կվերադարձնի LS2014 սխալը։
Ի քանի՞ plot շարք է նկարում ինդիկատորը?
Սկրիպտը կարող է հայտարարել մինչեւ 64 Արդյունք, բայց գրաֆիկի վահանակը նկարում է միայն plot-ի առաջին երեք շարքերը։
Առկա՞ է book.* և tape.*-ի պատմություն?
Ոչ։ order book-ն և time and sales-ը հասանելի են միայն կենդանի ռեժիմում։ Պատմական բարերի վրա դրանց արժեքները — na։ Order book-ի պատմությունը ըստ բարերի հասանելի է depth space-ում։