Справочник функций
1Справочник функций
Все встроенные функции, ряды и константы 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