← До документації
LootX

Довідник функцій

Зібрано: 2026-11-21 docs.lootx.trade
Справочник

1Довідник функцій

Усі вбудовані функції, ряди та константи LootScript: ta, math, str, color, input, відмалювання, колекції, стратегії й дані ордерфлоу — з параметрами й значеннями за замовчуванням.

Тут перераховано все, що вбудовано в 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 Ураховувати ставку фінансування безстрокових ф’ючерсів у результаті
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] Aroon вгору і вниз: як давно були максимум і мінімум вікна, 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 на іншому таймфреймі або інструменті і повертає результат на барах графіка
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 не можна читати біржовий стакан і стрічку угод і змінні графіка — тільки входи й самі ряди.
  • Ліміт — 8 різних пар «інструмент + таймфрейм» і 32 виклики на скрипт.

Приклади — в розділі Інший таймфрейм і інший інструмент.

Сповіщення і журнал

Функція Що робить
alert(message, freq = alert.freq_once_per_bar_close) Надсилає alert з текстом. Працює тільки вживу, на історії мовчить
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/uk/loot/reference