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

Язык Loot

LootScript — власні індикатори й сповіщення в терміналі, перевірка стратегій на історії.

Зібрано: 2026-11-21 docs.lootx.trade
Основы

1Мова LootScript

Що таке LootScript: індикатори, стратегії та бібліотеки, які працюють прямо в терміналі на даних графіка. Які дані доступні, як увімкнути скрипти і чого вони не роблять.

LootScript — мова скриптів термінала LootX. На ній пишуть власні індикатори, стратегії для перевірки ідей на історії та бібліотеки загальних функцій. Скрипт — це текстовий файл, який виконується прямо в терміналі на даних того графіка, куди ви його додали: свічки, обсяг, дельта, кластери, відкритий інтерес, ставка фінансування.

Так виглядає цілий індикатор — дельта кожного бара стовпчиками під графіком:

Loot
indicator("Дельта бара", overlay = false)

d = delta.available ? delta.value : na
plot(d, "Дельта", style = plot.style_columns, color = d >= 0 ? color.teal : color.red)

Що можна написати

Перший рядок скрипта оголошує його вид, і від виду залежить, що скрипту дозволено.

Вид Перший рядок Що робить
Індикатор indicator("Название") Рахує значення за барами та малює їх: лінії, гістограми, рівні, маркери, фон, підписи. Малює поверх ціни або в окремій панелі під графіком.
Стратегія strategy("Название") Те саме, що індикатор, плюс правила входу і виходу. Заявки стратегії віртуальні — їх виконує Тестер стратегії на історії та показує угоди, криву капіталу і показники.
Бібліотека library("Название", 1) Зберігає функції, які підключають інші ваші скрипти. На графік не додається і нічого не малює.

Крім своїх скриптів, можна перенести готові з формату Pine Script: термінал перекладе їх у LootScript під час імпорту. Як це працює і що перевірити після перекладу — на сторінці Імпорт із Pine Script.

Які дані доступні скрипту

  • Свічки графіка: open, high, low, close, volume, час бара та похідні на кшталт hl2.
  • Потік ордерів: дельта агресивних покупок і продажів, кластери за рівнями ціни, відкритий інтерес, ставка фінансування, записана історія біржового стакана, метрики скринера.
  • Живий біржовий стакан і стрічка угод — лише на поточному, ще не закритому барі: їхня історія не записується.
  • Інші таймфрейми та інструменти — через запит серії зі старшого таймфрейма або з іншої монети.

Якщо біржа не віддає якийсь показник або даних за бар немає, скрипт отримує не нуль, а спеціальне значення na — «немає значення». На графіку це розрив лінії, а не хибний нуль. Подробиці та покриття по біржах — на сторінці Дані ринку.

Де виконується скрипт

Скрипт працює всередині термінала на вашому комп’ютері. На сервер LootX він не надсилається і не виконується там.

  • Ізоляція. Скрипт не має доступу до мережі, файлів, підключень бірж та API-ключів. Таких функцій у мові просто немає — ні випадково, ні навмисно скрипт не може нікуди передати ваші дані.
  • Ліміти. Занадто довгий цикл або величезний масив зупиняє лише цей скрипт. Інші індикатори, панелі та сам термінал продовжують працювати, а причина зупинки видна в редакторі.
  • Файли. Кожен скрипт — окремий файл із розширенням .loot. У Windows вони лежать у папці %APPDATA%\TradingTerminal\scripts\, поза папкою встановлення, тому оновлення термінала їх не чіпають. Перенести скрипт на інший комп’ютер — означає скопіювати файл.

Як увімкнути скрипти

Скрипти — окремий модуль, який вмикається для вашого акаунта LootX. Щоб він запрацював, увійдіть в акаунт у терміналі.

Коли модуль увімкнено, у вікні індикаторів графіка (кнопка ƒ на панелі графіка) з’являються розділи Вибране, Мої скрипти, Вбудовані та Стратегії, а вгорі — кнопки Імпорт… та Редактор….

Коли модуль не ввімкнено, скрипти не показуються взагалі: вікно індикаторів містить лише вбудовані індикатори, редактора та імпорту немає. Замків і пропозицій купити при цьому теж немає — термінал виглядає так, ніби скриптів у ньому не існує. Щойно доступ з’явиться, вікно індикаторів перебудується саме, перезапускати термінал не потрібно.

Доступ надається на акаунт — у складі тарифу або окремо. Актуальні тарифи — на сторінці Підписки.

Чого скрипти не роблять

  • Не ходить в інтернет і не читає файли. Усе, що знає скрипт, — дані графіка, на якому він стоїть.
  • Не публікується і не продається. Каталогу скриптів немає: скрипт — ваш локальний файл, поділитися ним можна, лише передавши файл.
  • Не виконує Pine Script напряму. Скрипти в цьому форматі спочатку перекладаються в LootScript під час імпорту; однакові цифри з іншими платформами не гарантуються.

Далі

https://docs.lootx.trade/uk/loot/overview

Справочник

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

Усі вбудовані функції, ряди та константи 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

Основы

3Перший скрипт

Покроково: як відкрити редактор LootScript, написати індикатор із двох рядків, додати його на графік, читати помилки та знайти файл скрипта. Другий приклад — канал із налаштуваннями.

На цій сторінці ви пройдете шлях від порожнього редактора до власного індикатора на графіку: напишете скрипт із двох рядків, побачите, як редактор ловить помилки, дізнаєтеся, де лежить файл, і додасте вікно налаштувань. Знадобиться відкритий графік і ввімкнені скрипти — якщо їх немає у вікні індикаторів, прочитайте розділ Як увімкнути скрипти.

Відкрийте редактор

Відкрийте вікно індикаторів

На панелі графіка натисніть кнопку ƒ — підказка на ній — «Індикатори».

Запустіть редактор

Натисніть Редактор… поруч із полем пошуку або Новий скрипт унизу вікна. Щоб відкрити вже наявний скрипт, знайдіть його в розділі Мої скрипти та натисніть олівець Редагувати скрипт у його рядку (або виділіть рядок і натисніть Ctrl+E).

Знайдіть потрібні кнопки

Редактор відкривається окремим вікном зі своєю кнопкою в панелі завдань — його можна перенести на другий монітор. Угорі — випадаючий список скриптів, кнопки Новий, Зберегти та Додати на графік, внизу — вкладки Проблеми, Журнал і Вивід.

Редактор запам’ятовує панель графіка, з вікна індикаторів якої його відкрили: туди він і додасть скрипт. Якщо редактор відкритий інакше, скрипт потрапить на активну панель графіка.

Напишіть індикатор

Кнопка Новий (Ctrl+N) створює скрипт із шаблону — ковзну середню з одним налаштуванням:

Loot
indicator("Без названия", overlay = true)

length = input.int(20, "Length", minval = 1)
plot(ta.ema(close, length), "EMA", color = color.orange)

Замініть текст на найкоротший робочий індикатор — просту середню за 20 барів:

Loot
indicator("Мой первый индикатор", overlay = true)

plot(ta.sma(close, 20), "Средняя 20", color = color.orange)

Що тут написано:

  • indicator(...) — оголошення, обов’язковий перший рядок будь-якого скрипта. Назва потрапить у список Мої скрипти та в легенду графіка. overlay = true малює поверх свічок; з overlay = false індикатор отримає окрему панель під графіком.
  • ta.sma(close, 20) — середнє цін закриття за останні 20 барів.
  • plot(...) — малює лінію: одне значення на кожен бар. Другий аргумент — ім’я лінії в налаштуваннях, color — колір.

Скрипт виконується для кожного бара по черзі, від найстарішого до поточного. Першим 19 барам бракує історії для середньої, тому лінія починається не з лівого краю — це нормально. Скільки барів іде на такий «прогрів», редактор пише в рядку стану внизу.

Під час набору редактор пропонує імена функцій і констант, після відкриття дужки показує параметри функції, а при наведенні на ім’я — його опис. Список підказок можна викликати вручну сполученням Ctrl+Space.

Збережіть і додайте на графік

  • Зберегти (Ctrl+S) записує скрипт у папку скриптів. Поки є незбережені правки, перед іменем файлу в заголовку вікна стоїть крапка •.
  • Додати на графік (Ctrl+Enter) перевіряє скрипт, зберігає його та кладе на панель графіка. У панелі редактора з’явиться напис: «Мой первый индикатор» додано на графік.

Готово: лінія на графіку, ім’я індикатора — у легенді. Індикатор збережеться в розкладці й повернеться після перезапуску термінала.

Як редактор показує помилки

Скрипт перевіряється сам — за мить після того, як ви перестали друкувати. Результат видно в шапці редактора: компіляція…, потім ок · 12 мс або, якщо щось не так, помилок: 1 чи попереджень: 1.

Спробуйте помилитися: напишіть ta.smaa замість ta.sma. Місце помилки підкреслиться хвилястою лінією, лічильник у шапці покаже помилок: 1, а на вкладці Проблеми з’явиться рядок із кодом помилки, поясненням і позицією:

TEXT
LS2002  Неизвестное имя «ta.smaa» — проверьте написание или объявите его выше   Стр 3:6

Подвійне клацання по рядку переносить курсор до місця помилки. У кожної помилки є постійний код виду LS####, а текст одразу підказує, як її виправити. Розбір частих помилок — на сторінці Помилки компіляції та виконання.

Скрипт із помилками на графік не потрапить: Додати на графік відповість «Скрипт із помилками на графік не кладеться — див. «Проблеми»» і переведе курсор до першої помилки. У вікні індикаторів такий скрипт позначається червоною міткою з числом помилок замість мітки Скрипт.

Бувають і помилки під час виконання — наприклад, цикл, який не вкладається у відведений час. Тоді скрипт зупиняється, а причина видна на вкладці Вивід: «Скрипт зупинено: …». Інші індикатори й термінал продовжують працювати.

Правки скрипта, який уже на графіку

Поки ви редагуєте, графік продовжує показувати ту версію, яку ви додали. Щойно в редакторі з’явиться справна версія, відмінна від тієї на графіку, відбуваються дві речі:

  • у панелі редактора з’являється кнопка Оновити індикатор;
  • у легенді індикатора на графіку з’являється значок оновлення.

Будь-який із них зберігає скрипт і замінює його на всіх графіках, де він стоїть. Додати на графік для скрипта, який уже десь додано, робить те саме — оновлює всі копії, а не кладе другу. Скільки панелей отримають нову версію, показує мітка на графіках: N у шапці редактора.

Де лежать файли

У Windows скрипти зберігаються в папці %APPDATA%\TradingTerminal\scripts\, по одному файлу .loot на скрипт. Це звичайний текст — його можна відкрити будь-яким редактором, скопіювати, покласти в резервну копію. Папка розташована поза папкою встановлення, тому оновлення термінала її не чіпають.

Ім’я файлу утворюється з назви під час першого збереження: пробіли замінюються підкресленням, кирилиця зберігається. «Мой первый индикатор» стане файлом Мой_первый_индикатор.loot.

Коли папка створюється вперше, до неї кладуться шість стартових скриптів — Дві ковзні, RSI із зонами, Імпульс обсягу, Кумулятивна дельта, Інтерес проти ціни та Ставка фінансування річних. Вони лежать у розділі Мої скрипти; їх зручно відкрити й розібрати.

Другий приклад: канал із налаштуваннями

Зробимо скрипт кориснішим: канал із середньої та двох меж на відстані кількох стандартних відхилень. Період, ширину й джерело ціни винесемо в налаштування, а верхню та нижню межі підсвічуватимемо червоним, коли ціна за них виходить.

Loot
indicator("Канал вокруг средней", overlay = true)

length = input.int(20, "Период", minval = 2)
mult   = input.float(2.0, "Ширина в сигмах", minval = 0.1, step = 0.1)
src    = input.source(close, "Источник")

basis = ta.sma(src, length)
dev   = mult * ta.stdev(src, length)
upper = basis + dev
lower = basis - dev

plot(basis, "Середина", color = color.gray)
plot(upper, "Верх", color = close > upper ? color.red : color.teal)
plot(lower, "Низ", color = close < lower ? color.red : color.teal)

Що нового:

  • Кожен виклик input.* стає рядком у вікні налаштувань індикатора, у тому порядку, в якому він написаний. minval не дасть ввести період менше двох, а step = 0.1 означає, що поле ширини показує один знак після коми.
  • input.source перетворюється на випадаючий список рядів: close, open, hl2, volume та інші.
  • Колір меж — вираз, тому він обчислюється на кожному барі окремо.

Додайте скрипт на графік і двічі клацніть по його рядку в легенді (або натисніть у ній значок налаштувань). На вкладці Вхідні дані — три ваші налаштування: поміняйте період і лінії перерахуються одразу. Значення запам’ятовуються для цього індикатора на цьому графіку; кнопка За замовчуванням поверне ті, що написані в коді. На вкладці Стиль — колір середньої та товщина кожної лінії, на вкладці Видимість — прапорці, щоб сховати будь-яку з трьох ліній. Кольору меж у налаштуваннях немає: його обирає сам скрипт на кожному барі.

Далі

https://docs.lootx.trade/uk/loot/first-script

Основы

4Синтаксис і типи

Як влаштований LootScript: виконання по барах, оголошення скрипта, п’ять форм присвоєння, типи й кваліфікатори, na, історія x[n], оператори, умови, switch, цикли, функції й власні типи.

Ця сторінка — короткий опис мови: як виконується скрипт, як оголошувати змінні, які є типи, що таке na, як читати минулі бари, як писати умови, цикли й функції. Всі приклади — повні робочі скрипти: їх можна вставити в редактор і додати на графік.

Як виконується скрипт

Усе, що написане на верхньому рівні файлу, виконується один раз на кожен бар — від найстарішого завантаженого до поточного, рядок за рядком. Тому змінна в LootScript зберігає не одне число, а значення на кожному барі, і до минулих значень можна звертатися.

Loot
indicator("Тело свечи")

body = close - open          // считается заново на каждом баре
plot(body, "Тело", style = plot.style_columns)

На поточному, ще не закритому барі скрипт перераховується з кожним новим тіком, починаючи зі стану, яке було на закритті попереднього бара. Закриті бари при цьому не перераховуються.

Оголошення

Перша інструкція скрипта — рівно одне оголошення: indicator(...), strategy(...) або library(...). Вище нього можуть стояти тільки коментарі і необов’язковий рядок версії #version 1. Без оголошення скрипт не скомпілюється з помилкою «Немає оголошення скрипта — почніть з indicator(“Назва”)».

Loot
#version 1
// Комментарии и строка версии могут стоять выше объявления.
indicator("Размах бара", shortTitle = "Размах", overlay = false)

plot(high - low, "Размах", style = plot.style_histogram)

Головні параметри індикатора: title — назва в списку скриптів, shortTitle — коротке ім’я для легенди, overlay — малювати поверх ціни (true) або в окремій панелі (false, за замовчуванням). Параметри стратегії описані на сторінці Стратегии и тестер.

Змінні і присвоєння

Форма Що робить
x = выражение Оголошує змінну. На кожному барі вона обчислюється заново.
x := выражение Присвоює нове значення вже оголошеній змінній. Тип має співпадати.
var x = выражение Оголошує змінну один раз, на першому барі. Значення переходить на наступні бари.
varip x = выражение Як var, але значення зберігається й між тіками поточного бара.
[a, b, c] = функция(...) Розкладає кілька результатів функції по змінних.

Для зміни вже оголошеної змінної є й короткі форми: +=, -=, *=, /=, %=. Тип можна вказати явно: float level = 0. Імена вбудованих рядів і просторів (close, volume, ta та інших) зайняті — назвати так свою змінну не можна.

Головна відмінність від звичних мов — звичайна змінна не накопичує значення між барами. Для лічильників і сум потрібен var:

Loot
indicator("Счётчик зелёных свечей")

var greens = 0          // объявляется один раз и переживает переход к следующему бару
if close > open {
    greens += 1
}

today = 0               // а эта переменная равна 0 на каждом новом баре
today := today + 1      // поэтому здесь всегда 1

plot(greens, "Зелёных с начала истории")

varip потрібен рідко — наприклад, щоб рахувати тіки всередині бара. На історії тиків немає, тому таке значення на минулих барах буде іншим, ніж було вживу. Якщо значення varip потрапляє на графік, редактор попередить про перерисовку.

Типи

Тип Що зберігає Приклад
int ціле число 14, 1_000_000, 0xFF
float дробове число 2.5, .5, 1e-9
bool істина або неправда true, false
string текст "BTC", 'BTC'
color колір з прозорістю #FF9800, #FF980080, color.teal

Є й складні типи: масиви array<float>, словники map<string, float>, матриці matrix<float>, а також ваші власні типи й перерахування (див. нижче) і графічні об’єкти line, box, label, table.

Правила, через які найчастіше спотикаються:

  • Тип фіксується при оголошенні. Після x = 1 присвоїти x := 2.5 не можна: x — ціле. Пишіть x = 1.0 або float x = 1.
  • Ціле перетворюється в дробове само, назад — тільки явно: math.round, math.floor, math.ceil, math.trunc.
  • Ділення цілих — ціле: 7 / 2 рівно 3. Потрібна дробь — зробіть одне з чисел дробовим: 7.0 / 2.
  • Піднесення до степеня ^ завжди дає дробове число: 2 ^ 3 рівно 8.0.
  • Рядок не можна додати до числа. "Цена: " + close не скомпілюється — пишіть "Цена: " + str.tostring(close).
  • Умова — тільки bool. if volume { … } — помилка; пишіть if volume > 0 { … }.

Кваліфікатори: наскільки значення постійне

Окрім типу в кожного значення є кваліфікатор — наскільки воно постійне під час роботи скрипта. Від слабкого до сильного:

Кваліфікатор Коли відоме значення Приклад
const вже під час компіляції 14, "EMA"
input після зчитування налаштувань, далі не змінюється input.int(14, "Период")
simple при запуску, далі не змінюється крок ціни інструмента
series може змінюватися на кожному барі close, bar_index

На практиці це важливо в одному місці: періоди функцій ta.* повинні бути постійними — літералом або налаштуванням. Інакше функціям довелося б перебудовувати свій стан на кожному барі.

Loot
indicator("Период из настроек")

len = input.int(14, "Период", minval = 2)
plot(ta.rsi(close, len), "RSI")

// ta.rsi(close, bar_index) не скомпилируется:
// «length» в «ta.rsi» требует значение не слабее input, а передано series

na — відсутнє значення

na означає «значення відсутнє»: не вистачає історії для розрахунку, біржа не віддає показник, у даних дірка. na є в будь-якому типі.

  • Арифметика з na дає na: na + 1 — це na.
  • Будь-яке порівняння з na хибне, тому if x > 0 при x = na не виконається.
  • Перевіряйте відсутність тільки через na(x). Запис x == na компілятор відхилить з помилкою «Сравнение с na всегда ложно — используйте na(x)».
  • nz(x) підставляє 0 замість na, nz(x, v) — значення v. Те саме коротше: x ?? v.
  • na на графіку — розрив лінії, а не нуль.
Loot
indicator("Средняя без пустого начала", overlay = true)

avg = ta.sma(close, 50)             // на первых 49 барах — na

line1 = na(avg) ? close : avg       // проверка через na(x)
line2 = avg ?? close                // то же короче

plot(line2, "Средняя или цена", color = color.orange)

Історія: x[n]

x[n] — значення x на барі, який був n барів тому; x[0] — поточне. Працює з будь-яким рядом, у тому числі з вашими змінними.

Loot
indicator("Наклон средней")

ma    = ta.ema(close, 20)
slope = ma - ma[1]                  // изменение за один бар

plot(slope, "Наклон", style = plot.style_histogram,
     color = slope >= 0 ? color.teal : color.red)
  • Якщо n більше числа барів до початку історії, результат — na, а не помилка.
  • n може змінюватися від бара до бара: close[len] при змінному len допустимо.
  • Негативний індекс — помилка: заглядати в майбутні бари не можна.
  • Налаштовувати глибину історії не потрібно: скрипту доступна вся історія, завантажена на графік.

Оператори

Від найвищого пріоритету до найнижчого:

Пріоритет Оператори
1 x[n], вызов f(…), доступ через точку a.b
2 ^ — степень, вычисляется справа налево
3 унарні -, +, not
4 *, /, %
5 +, -
6 <, >, <=, >=
7 ==, !=
8 and
9 or
10 ?? — заміна na
11 ? : — умовний вираз
  • Порівняння не ланцюжаться: замість a < b < c пишіть a < b and b < c.
  • and і or не обчислюють праву частину, якщо відповідь уже ясна по лівій.
  • Степінь вище унарного мінуса: -2 ^ 2 рівне -4. Потрібно 4 — пишіть (-2) ^ 2.
  • Дробові числа порівнюйте з допуском: math.approx(a, b), бо 0.1 + 0.2 == 0.3 хибне.

Умови

Блоки завжди в фігурних дужках. if буває інструкцією і виразом; для простого вибору з двох є ? :.

Loot
indicator("Направление бара")

dir = 0
if close > open {
    dir := 1
} else if close < open {
    dir := -1
}

// if как выражение: обе ветки обязательны
bodySize = if close >= open { close - open } else { open - close }

// условный оператор для простых случаев
barColor = dir > 0 ? color.teal : color.red

plot(bodySize, "Тело", style = plot.style_columns, color = barColor)

switch

switch вибирає першу підходящу гілку. Форма з об’єктом порівнює його зі значеннями гілок, форма без об’єкта перевіряє умови по черзі. Гілка => без умови — гілка за замовчуванням. Провалювання в наступну гілку немає. Коли switch повертає значення, гілка за замовчуванням обов’язкова.

Loot
indicator("Средняя на выбор", overlay = true)

kind = input.string("EMA", "Тип средней", options = ["EMA", "SMA", "WMA"])

ma = switch kind {
    "EMA" => ta.ema(close, 20)
    "SMA" => ta.sma(close, 20)
    =>       ta.wma(close, 20)
}

zone = switch {
    close > ma * 1.02 => 1
    close < ma * 0.98 => -1
    =>                   0
}

plot(ma, "Средняя", color = zone == 1 ? color.teal : zone == -1 ? color.red : color.gray)

Цикли

for i in a .. b перебирає числа від a включно до b не включно. Крок задається словом by, у тому числі від’ємний. Змінна циклу існує тільки всередині циклу і не змінюється в тілі.

Loot
indicator("Зелёные свечи за N баров")

n = input.int(10, "Сколько баров", minval = 1, maxval = 200)

greens = 0
for i in 0 .. n {               // i = 0, 1, …, n − 1
    if close[i] > open[i] {
        greens += 1
    }
}

plot(greens, "Зелёных", style = plot.style_columns)
Loot
indicator("Виды циклов")

total = 0
for i in 0 .. 10 by 2 {         // 0, 2, 4, 6, 8
    total += i
}
for i in 10 .. 0 by -1 {        // 10, 9, …, 1
    if i % 3 == 0 {
        continue                // сразу к следующему шагу
    }
    total += i
}

var closes = array.new<float>(0)
closes.push(close)
if closes.size() > 20 {
    closes.shift()
}
sum = 0.0
for v in closes {               // по элементам массива; for [i, v] in … — с индексом
    sum += v
}

k = 0
while k < 100 {
    k += 7
    if k > 50 {
        break                   // выход из цикла
    }
}

plot(sum / closes.size(), "Средняя из массива")

Бескінечний цикл термінал не зависне: у скрипта є бюджет операцій на бар і ліміт часу. Перевищивши їх, скрипт зупиниться з повідомленням «Скрипт исчерпал бюджет операций на бар — упростите цикл» або «Скрипт превысил лимит времени на проход».

Функції

Функція оголошується словом func. Коротка форма — вираз після =>, довга — тіло в дужках з return. Типи параметрів можна не вказувати — вони виводяться з викликів, а у параметрів можуть бути значення за замовчуванням. Аргументи передаються по порядку або по імені.

Loot
indicator("Z-оценка объёма")

func barRange(h, l) => h - l

func zscore(series float src, input int len) => float {
    m = ta.sma(src, len)
    s = ta.stdev(src, len)
    return s == 0 ? na : (src - m) / s
}

func scaled(x, k = 2.0) => x * k

z = zscore(volume, 50)
plot(z, "Z объёма", style = plot.style_columns, color = z > 2 ? color.orange : color.gray)
plot(scaled(barRange(high, low), k = 0.5), "Полразмаха")
  • Рекурсії немає. Функція не може викликати саму себе, ні прямо, ні через іншу функцію. Повторення пишеться циклом.
  • Стан — у кожного виклику свій. Якщо всередині функції є ta.* або var, два виклики однієї функції ведуть незалежні розрахунки:
Loot
indicator("Два вызова одной функции", overlay = true)

func smooth(src, len) => ta.ema(src, len)

fast = smooth(close, 10)        // своя средняя
slow = smooth(close, 30)        // другая, независимая средняя

plot(fast, "Быстрая", color = color.teal)
plot(slow, "Медленная", color = color.orange)

Функції, потрібні в кількох скриптах, виносять у бібліотеку: скрипт з оголошенням library("Имя", 1), перед функціями — слово export, в іншому скрипті — import Имя/1 as имя. Бібліотека береться з вашої папки скриптів.

Кілька результатів

Деякі функції повертають одразу кілька рядів: ta.bb, ta.macd, ta.kc, ta.dmi, ta.supertrend та інші. Їх результат розкладається по змінних у квадратних дужках; число імен має збігатися з числом результатів.

Loot
indicator("Полосы Боллинджера", overlay = true)

[basis, upper, lower] = ta.bb(close, 20, 2.0)

plot(basis, "Середина", color = color.gray)
plot(upper, "Верх", color = color.teal)
plot(lower, "Низ", color = color.teal)

Власні типи та перерахування

type збирає кілька полів в одну структуру. Об’єкт створюється через Имя.new(...), поля читаються і змінюються через крапку.

Loot
indicator("Последний локальный максимум", overlay = true)

type Swing {
    int   barIndex
    float price
}

var Swing last = Swing.new(barIndex = 0, price = high)

ph = ta.pivothigh(high, 5, 5)
if not na(ph) {
    last.barIndex := bar_index - 5
    last.price := ph
}

plot(last.price, "Максимум", style = plot.style_stepline, color = color.orange)

enum — закритий список варіантів із підписами. Зручніше рядками: опечатка в імені варіанта — помилка компіляції, а не тихо неспрацювавша умова. Разом з input.enum перерахування перетворюється в випадаючий список у налаштуваннях — див. Настройки и отрисовка.

Loot
indicator("Режим рынка")

enum Regime {
    trend = "Тренд"
    flat  = "Флэт"
}

regime = math.abs(close - close[20]) > ta.atr(14) * 3 ? Regime.trend : Regime.flat

plot(regime == Regime.trend ? 1 : 0, "Тренд", style = plot.style_stepline)

Функції ta.* всередині умов

Функції на кшталт ta.ema, ta.rsi або ta.atr пам’ятають свій стан з минулого бара. Якби такий виклик виконувався тільки на частині барів — всередині if або однієї гілки ? : — його розрахунок пропускав би бари й тихо давав некоректні числа.

LootScript цього не допускає: компілятор сам виносить кожен виклик ta.* з умови і виконує його на кожному барі, а умова лише вибирає, використовувати чи результат. Тож такий код рахує RSI правильно:

Loot
indicator("RSI только на зелёных барах")

r = close > open ? ta.rsi(close, 14) : na

plot(r, "RSI", style = plot.style_circles)

Винести виклик не можна, лише якщо його аргумент сам народжується всередині гілки. Тоді компілятор не вгадає й повідомить: «Аргумент «len» нельзя вычислить вне ветки — вынесите вызов ta.* на верхний уровень». Рішення — порахувати аргумент до умови:

Loot
indicator("Аргумент до условия")

// Так нельзя — len объявлена внутри ветки:
// if close > open {
//     len = 10
//     e = ta.ema(close, len)
// }

len = 10
e = ta.ema(close, len)

plot(close > open ? e : na, "EMA на зелёных барах", style = plot.style_circles)

Коментарі та перенесення рядків

  • // — коментар до кінця рядка, /* … */ — блочний, блоки можна вкладати один в одного.
  • Інструкція закінчується з кінцем рядка, крапка з комою не потрібна.
  • Довгий вираз продовжується на наступному рядку, якщо рядок обірвано всередині дужок, закінчується оператором або наступний рядок починається з оператора, ? або :.
Loot
indicator("Перенос строк")

typical = high
        + low
        + close

signal = close > open
    ? typical / 3
    : na

plot(signal, "Типичная цена на зелёных барах", style = plot.style_circles)

Далі

https://docs.lootx.trade/uk/loot/syntax

Основы

5Налаштування та відображення

Налаштування input.* у вікні індикатора, лінії plot та їхні стилі, рівні hline, заливки fill, фон і колір свічок, маркери, підписи, відрізки, прямокутники, таблиці, кольори та прозорість. Межі: три лінії plot і 500 об’єктів кожного виду.

Ця сторінка про те, що користувач бачить і може змінювати. Тут описано налаштування, які скрипт виносить у вікно індикатора, лінії та їхні стилі, рівні й заливки, фон і колір свічок, маркери, підписи, відрізки, прямокутники та таблиці, а також кольори та прозорість. Наприкінці є розділ про межі, які варто знати заздалегідь.

Налаштування: input.*

Кожен виклик input.* стає рядком на вкладці Вхідні дані у вікні налаштувань індикатора. Рядки йдуть у тому порядку, в якому виклики написані в скрипті. Перший аргумент задає значення за замовчуванням, другий — підпис рядка.

Виклик Що з’явиться у вікні налаштувань
input.int Поле для цілого числа
input.float Поле для дробового числа
input.bool Прапорець
input.color Вибір кольору
input.string Спадний список, якщо задано options; без нього — текстове поле
input.source Спадний список рядів: open, high, low, close, hl2, hlc3, ohlc4, hlcc4, volume
input.enum Спадний список із підписів переліку
input.timeframe Текстове поле; з options — спадний список
input.symbol Текстове поле

Приклад нижче збирає в одному скрипті п’ять видів налаштувань:

Loot
indicator("Средняя на выбор", overlay = true)

enum Basis {
    sma = "Простая"
    ema = "Экспоненциальная"
    wma = "Взвешенная"
}

basis     = input.enum(Basis.ema, "Тип средней")
length    = input.int(50, "Период", minval = 1, maxval = 500)
src       = input.source(close, "Источник")
lineColor = input.color(color.orange, "Цвет линии")
showBg    = input.bool(false, "Подсвечивать фон")

avg = switch basis {
    Basis.sma => ta.sma(src, length)
    Basis.ema => ta.ema(src, length)
    =>           ta.wma(src, length)
}

plot(avg, "Средняя", color = lineColor, linewidth = 2)
bgcolor(showBg and close > avg ? color.new(color.teal, 40) : na, title = "Фон")

У вікні налаштувань вийде спадний список «Тип средней» із пунктами «Простая», «Экспоненциальная» і «Взвешенная». Нижче будуть поле періоду, список джерел, вибір кольору та прапорець. Як оголошувати переліки, розказано в розділі Свої типи та переліки.

Параметри чисел і рядків

  • minval і maxval задають межі: поле не прийме період менший за minval або більший за maxval.
  • step у input.float задає, скільки знаків після коми показує поле: при step = 0.1 видно один знак. Стрілок біля поля немає, значення вводиться з клавіатури.
  • options у input.string і input.timeframe перетворює поле на спадний список. Значення за замовчуванням мусить бути одним із пунктів, інакше компілятор видасть помилку.
  • tooltip, group та inline компілятор приймає, але на вигляд вікна налаштувань вони поки не впливають.
Loot
indicator("Цена для расчёта")

mode  = input.string("Закрытие", "Считать по", options = ["Закрытие", "Середина свечи"])
price = mode == "Закрытие" ? close : hl2

plot(ta.rsi(price, 14), "RSI", color = color.purple)

У input.source за замовчуванням може бути й ряд ринкових даних, наприклад delta.cum. Такий ряд стане першим пунктом списку, перед ціновими рядами. Якщо ж за замовчуванням стоїть вираз на зразок (high + low) / 2, рядка у вікні налаштувань не буде: вибирати нема з чого.

Окремих налаштувань для часу, торгової сесії та ціни, яку вибирають клацанням на графіку, у мові поки немає.

Де зберігаються вибрані значення

Значення запам’ятовуються для кожного індикатора на кожному графіку окремо: дві копії одного скрипта на різних панелях можуть стояти з різними періодами. Кнопка За замовчуванням у вікні налаштувань повертає значення, написані в коді.

Значення прив’язане до імені змінної, в яку записано виклик input.*. Підпис рядка можна змінювати вільно, вибране значення збережеться. Рядки можна й переставляти. А якщо перейменувати змінну (length на period), налаштування повернеться до значення з коду.

Вікно налаштувань відкривається подвійним клацанням по рядку індикатора в легенді графіка або значком налаштувань у цьому рядку. Крім вкладки Вхідні дані в ньому є Стиль і Видимість — про них нижче.

Лінії: plot

plot малює ряд, по одному значенню на кожен бар. Обов’язковий лише перший аргумент — сам ряд. Решта параметрів задаються за іменем:

  • title — ім’я лінії в легенді та у вікні налаштувань;
  • color — колір, постійний або обчислюваний на кожному барі;
  • linewidth — товщина;
  • style — спосіб відображення, див. таблицю;
  • offset — зсув на задану кількість барів: додатний праворуч, від’ємний ліворуч;
  • show_last — малювати лише останні N барів;
  • join = true — з’єднати лінією точки стилів circles і cross;
  • editable = false — прибрати лінію з вікна налаштувань;
  • display = display.none — сховати лінію при додаванні; увімкнути її можна на вкладці Видимість.
Стиль Як виглядає
plot.style_line Ламана лінія, стиль за замовчуванням
plot.style_linebr Те саме, що line
plot.style_stepline Сходинки
plot.style_stepline_diamond Сходинки з ромбами
plot.style_histogram Тонкі стовпчики від нуля завтовшки в лінію
plot.style_columns Стовпчики від нуля завширшки у свічку
plot.style_area Область, зафарбована до нуля
plot.style_areabr Те саме, що area
plot.style_circles Точки
plot.style_cross Хрестики

Лінія завжди переривається там, де в ряду немає значення (na), і не перестрибує пропуск прямим відрізком. Тому пари line/linebr та area/areabr малюються однаково.

Loot
indicator("Стили линий")

d = close - open

plot(d, "Тело свечи", style = plot.style_histogram, color = d >= 0 ? color.teal : color.red)
plot(ta.sma(d, 10), "Средняя 10", style = plot.style_stepline, color = color.orange, linewidth = 2)
plot(ta.sma(d, 30), "Средняя 30", style = plot.style_circles, color = color.gray)

Колір по барах

Колір може бути виразом: тоді він обчислюється на кожному барі заново. Колір na означає, що на цьому барі лінії немає:

Loot
indicator("Средняя только над ценой", overlay = true)

m = ta.sma(close, 50)
plot(m, "Средняя", color = close > m ? color.teal : na)

Що лінія отримує у вікні налаштувань

  • На вкладці Стиль налаштовується товщина кожної лінії. Рядок кольору з’являється лише в лінії з постійним кольором: якщо колір вибирає скрипт на кожному барі, міняти у вікні нічого.
  • На вкладці Видимість у кожної лінії є прапорець показу. Він з’являється, якщо ліній більше однієї або якщо лінію сховано через display.
  • Лінія з editable = false не отримує рядків на жодній вкладці.

Рівні та заливки

hline малює горизонтальну лінію на постійній ціні — наприклад, межі зон RSI. Ціна має бути числом або налаштуванням input.*: ряд, що змінюється від бара до бара, сюди не підходить. Для такої лінії потрібен plot. Стиль лінії задають hline.style_solid, hline.style_dashed та hline.style_dotted.

fill зафарбовує область між двома межами. Щоб отримати межу, результат hline або plot записують у змінну:

Loot
indicator("RSI с зонами")

length = input.int(14, "Период", minval = 1)
r = ta.rsi(close, length)

top    = hline(70, "Перекупленность", color = color.gray, linestyle = hline.style_dashed)
bottom = hline(30, "Перепроданность", color = color.gray, linestyle = hline.style_dashed)
fill(top, bottom, color = color.new(color.purple, 30), title = "Зона")

plot(r, "RSI", color = r > 70 ? color.red : r < 30 ? color.teal : color.purple)

Обидві межі мають бути одного роду: два рівні hline або дві лінії plot. Заливку між лінією та рівнем компілятор не прийме.

Колір заливки між двома лініями може змінюватися від бара до бара. Так виходить «хмара» з двох середніх:

Loot
indicator("Облако", overlay = true)

fast = ta.ema(close, 9)
slow = ta.ema(close, 21)

pf = plot(fast, "Быстрая", color = color.teal)
ps = plot(slow, "Медленная", color = color.orange)
fill(pf, ps, color = fast > slow ? color.new(color.teal, 50) : color.new(color.red, 50), title = "Облако")

Є й градієнтна заливка. Задайте top_value і bottom_value, щоб указати висоти, де колір дорівнює top_color та bottom_color; між ними колір плавно переходить. Ці висоти мають бути постійними числами. Якщо потрібна заливка до постійного рівня, зробіть його лінією, plot(50). Але пам’ятайте, що це одна з трьох ліній, які малюються.

Loot
indicator("RSI с градиентом")

r  = ta.rsi(close, 14)
pr = plot(r, "RSI", color = color.purple)
pm = plot(50, "Середина", color = color.gray)
fill(pr, pm, top_value = 80, bottom_value = 50,
     top_color = color.new(color.teal, 160), bottom_color = color.new(color.teal, 0))

Фон і колір свічок

bgcolor зафарбовує фон під баром, barcolor перефарбовує саму свічку. Обидва приймають колір, обчислюваний на кожному барі; на барах із кольором na нічого не змінюється.

Loot
indicator("Подсветка объёма", overlay = true)

avgVol = ta.sma(volume, 20)
spike  = volume > avgVol * 2

bgcolor(spike ? color.new(color.orange, 40) : na, title = "Всплеск объёма")
barcolor(close > open ? color.teal : color.red, title = "Цвет свечей")

Маркери: plotshape і plotchar

plotshape ставить значок на тих барах, де умова істинна. plotchar робить те саме з будь-яким символом.

Loot
indicator("Пересечения", overlay = true)

fast = ta.ema(close, 9)
slow = ta.ema(close, 21)

plotshape(ta.crossover(fast, slow), "Вверх", style = shape.triangleup,
          location = location.belowbar, color = color.teal, size = size.small)
plotshape(ta.crossunder(fast, slow), "Вниз", style = shape.triangledown,
          location = location.abovebar, color = color.red, size = size.small)
plotchar(volume > ta.sma(volume, 20) * 3, "Объём", char = "●", location = location.top, color = color.orange)
  • Форма, shape.*: triangleup, triangledown, arrowup, arrowdown, circle, square, diamond, cross, xcross, flag, labelup, labeldown.
  • Місце, location.*: abovebar — над свічкою, belowbar — під свічкою, top і bottom — біля верхнього та нижнього краю панелі. В окремій панелі під графіком «над свічкою» і «під свічкою» теж означають верхній і нижній край: у такої панелі своя шкала, і ціни свічок на ній не відкладені.
  • Розмір, size.*: auto, tiny, small, normal, large, huge.
  • text додає до значка короткий підпис. Коли графік сильно віддалений і свічки вузькі, підписи ховаються, а значки залишаються.

Графічні об’єкти

Крім рядів, скрипт може малювати окремі об’єкти: підписи label.new, відрізки line.new, прямокутники box.new і таблиці table.new. Кожен виклик *.new повертає об’єкт. Його можна пересунути функціями set_* (label.set_xy, line.set_x2, box.set_top і так далі), прочитати через get_*, скопіювати через copy або видалити через delete.

По горизонталі об’єкт за замовчуванням прив’язаний до номера бара, bar_index. З параметром xloc = xloc.bar_time координата задається часом бара. Відрізку та прямокутнику параметр extend (extend.right, extend.left, extend.both) продовжує край до межі графіка.

Об’єкт залишається на графіку, поки його не видалять. Скрипт виконується на кожному барі, тому label.new без умови створить по підпису на кожен бар. Щоб тримати один об’єкт і рухати його, зберігайте його у змінній var, а старий видаляйте:

Loot
indicator("Последний пивот", overlay = true, maxLabelsCount = 50)

ph = ta.pivothigh(high, 10, 10)

var line level = na
if not na(ph) {
    label.new(bar_index - 10, ph, str.tostring(ph), style = label.style_label_down,
              color = color.orange, textcolor = color.white, size = size.small)
    line.delete(level)
    level := line.new(bar_index - 10, ph, bar_index, ph, extend = extend.right,
                      color = color.orange, style = line.style_dashed)
}

Скрипт підписує кожен знайдений максимум і тягне пунктир від останнього з них праворуч. Попередній пунктир він при цьому видаляє.

Живих об’єктів кожного виду одночасно буває не більше 500. Коли з’являється п’ятсот перший, найстаріший зникає. Параметри maxLinesCount, maxLabelsCount і maxBoxesCount в indicator() зменшують цю межу. Значення більше за 500 урізається до 500.

Таблиці

Таблиця прив’язана не до барів, а до кута чи краю панелі та не рухається під час прокручування графіка. Місце задає position.*: top_left, top_center, top_right, middle_left, middle_center, middle_right, bottom_left, bottom_center, bottom_right. Комірки заповнює table.cell. Зручно робити це лише на останньому барі, щоб не переписувати таблицю на всій історії:

Loot
indicator("Сводка", overlay = true)

var t = table.new(position.top_right, 2, 2, bgcolor = color.new(color.black, 160))
if barstate.islast {
    table.cell(t, 0, 0, "RSI", text_color = color.white)
    table.cell(t, 1, 0, str.tostring(math.round(ta.rsi(close, 14), 1)), text_color = color.white)
    table.cell(t, 0, 1, "ATR", text_color = color.white)
    table.cell(t, 1, 1, str.tostring(math.round(ta.atr(14), 2)), text_color = color.white)
}

У таблиці не більше 200 стовпців і 200 рядків. Таблиця, в якій понад 2000 комірок, не створюється.

Кольори

Іменовані кольори: color.red, color.green, color.blue, color.teal, color.orange, color.purple, color.yellow, color.white, color.black, color.gray, color.silver, color.maroon, color.navy, color.olive, color.lime, color.aqua, color.fuchsia.

Колір можна записати й кодом: #FF8800 — непрозорий, #FF880040 — із прозорістю. Остання пара цифр задає непрозорість: 00 — повністю прозорий, FF — суцільний.

  • color.rgb(r, g, b) збирає колір зі складників від 0 до 255. Четвертий аргумент — непрозорість, за замовчуванням 255.
  • color.from_gradient(value, bottomValue, topValue, bottomColor, topColor) повертає колір між двома крайніми за положенням value у діапазоні. Зручно розфарбовувати осцилятор від холодного до гарячого.
  • na замість кольору означає «не малювати».
Loot
indicator("RSI в цвете")

r = ta.rsi(close, 14)
heat = color.from_gradient(r, 30, 70, color.rgb(0, 150, 136), color.rgb(244, 67, 54))

plot(r, "RSI", color = heat, linewidth = 2)
bgcolor(r > 70 ? color.new(color.red, 30) : r < 30 ? color.new(color.teal, 30) : na, title = "Зоны")

Далі

https://docs.lootx.trade/uk/loot/inputs-drawing

Основы

6Ринкові дані: кластери, дельта, OI, біржовий стакан

Що скрипт на LootScript читає крім свічок: кластери, дельта, відкритий інтерес, ставка фінансування, записана і жива історія біржового стакана, стрічка угод, скринер, інший таймфрейм і інструмент.

Окрім свічок, скрипт на LootScript читає дані потоку ордерів: кластери, дельту, відкритий інтерес, ставку фінансування, записану історію біржового стакана, живий біржовий стакан і стрічку угод, метрики скринера. Нічого вмикати не потрібно: щойно скрипт звертається, наприклад, до cluster.poc, термінал сам підписується на кластери інструмента і таймфрейма графіка — навіть якщо графік показує звичайні свічки. Коли скрипт знімають із графіка, підписка звільняється.

На цій сторінці — що є в кожному просторі імен, звідки беруться дані, на яких майданчиках вони доступні і як узяти значення іншого таймфрейма або іншого інструмента.

Головне правило: немає даних — це na, а не 0

Будь‑яке значення з цієї сторінки може виявитися na. Так відбувається, якщо майданчик не покритий сервером, таймфрейм не підтримується, історія ще завантажується або бар старший за доступну історію. Нуль означав би «торгів не було», а це інший факт: накопичена сума з підставленими нулями виглядає правдоподібно й водночас невірна.

У кожного простору є прапорець наявності — cluster.available, delta.available, oi.available тощо. Перевіряйте його або функцією na(x). Порівняння з na через == компілятор не пропустить.

Loot
indicator("Накопленная дельта без подмены нулём", overlay = false)
var float cvd = 0.0
if delta.available {
    cvd := cvd + delta.value
}
plot(delta.available ? cvd : na, "CVD", color = color.teal)

Чому даних немає, підказує легенда графіка поруч із назвою скрипта: «майданчик не покритий», «таймфрейм не підтримується», «дані завантажуються…», «немає відкритого стакана», «скринер недоступний».

Звідки що береться

Простір Що це Історія на графіку
cluster.* Кластери (футпринт) бара: об’єм по цінах Є, з сервера кластерів
delta.* Дельта агресивних покупок і продажів Є
oi.* Відкритий інтерес Є
funding.* Ставка фінансування і її розрахунки Є
depth.* Біржовий стакан, записаний сервером, по барах Є, обмеженої глибини
book.* Живий біржовий стакан Лише останній бар
tape.* Жива стрічка угод Лише останній бар
screener.* Метрики скринера по інструменту Лише останній бар

Кластери: cluster.*

Об’єм кожного цінового рівня всередині бару з розподілом на агресивні покупки і продажі — ті самі дані, що малює кластерний графік. Рівні нумеруються знизу вгору, від 0 до cluster.levels - 1.

Ім’я Що повертає
cluster.available Чи є кластери на цьому барі
cluster.levels Число цінових рівнів у барі
cluster.price(i) Ціна рівня i
cluster.bid(i) Агресивні покупки на рівні i
cluster.ask(i) Агресивні продажі на рівні i
cluster.total Весь об’єм бару
cluster.delta Покупки мінус продажі по всіх рівнях
cluster.poc, cluster.poc_index Ціна і номер рівня з найбільшим об’ємом
cluster.max_cell Об’єм найважчої клітинки бару
cluster.imbalance(i) Перекіс рівня: +1 покупки, -1 продажі, 0 немає
cluster.stacked_buy, cluster.stacked_sell Ціна, з якої починається найдовша серія рівнів із перекосом
cluster.stacked_buy_steps, cluster.stacked_sell_steps Довжина цієї серії в рівнях
cluster.value_area(pct) Нижня й верхня межі зони вартості; pct — частка об’єму, 0.7 = 70 %
cluster.grid_step Крок цінової сітки бару

Зверніть увагу на назви: cluster.bid(i) — це покупки, які «зняли» аск, а не заявки на покупку в біржовому стакані.

Кластери є на таймфреймах від 30 секунд до одного дня.

Loot
indicator("POC и зона стоимости", overlay = true)
[vaLow, vaHigh] = cluster.value_area(0.7)
plot(cluster.poc, "POC", color = color.orange, style = plot.style_circles)
plot(vaHigh, "Верх зоны", color = color.gray, style = plot.style_linebr)
plot(vaLow, "Низ зоны", color = color.gray, style = plot.style_linebr)

Дельта: delta.*

Різниця між агресивними покупками і продажами за бар. Об’єми — в монетах (базовій валюті).

Ім’я Що повертає
delta.value Дельта бару: покупки мінус продажі
delta.buy, delta.sell Ці дві частини окремо
delta.cum Накопичена дельта від початку завантаженої історії
delta.min, delta.max Мінімум і максимум бігаючої дельти всередині бару
delta.open, delta.high, delta.low, delta.close Дельта бару у вигляді свічки
delta.trades Число угод у барі
delta.usd Дельта в валюті котирування, за сумами самих угод
delta.available Чи є дельта на цьому барі

delta.min і delta.max з кластерів не порахувати — це шлях дельти всередині бару, його рахує сервер. За ними видно, що покупці вели бар, а закрили його продавці. delta.usd точніша, ніж delta.value * close: на різкому барі ціна угод сильно відрізняється від ціни закриття.

delta.cum починається з нуля на першому завантаженому барі, тому її рівень залежить від глибини завантаженої історії. Порівнюйте зміни, а не абсолютні значення.

Дельта є на таймфреймах від 30 секунд.

Loot
indicator("Дельта и разворот внутри бара", overlay = false)
d = delta.value
reversed = delta.available and d < 0 and delta.max > -d
plot(d, "Дельта", style = plot.style_columns, color = d >= 0 ? color.teal : color.red)
plotshape(reversed, "Разворот", style = shape.xcross, location = location.top, color = color.orange, size = size.tiny)

Відкритий інтерес: oi.*

Ім’я Що повертає
oi.open, oi.high, oi.low, oi.close Відкритий інтерес за бар у одиницях, які публікує майданчик
oi.coins Відкритий інтерес в монетах
oi.usd Відкритий інтерес у валюті котирування
oi.change Зміна oi.close до попереднього бару
oi.available Чи є дані на цьому барі

Одиниці oi.open…oi.close у майданчиків різні, тому для порівняння майданчиків беріть oi.coins або oi.usd. Відкритий інтерес надходить з хвилинною сіткою: на секундних таймфреймах всі значення — na.

Loot
indicator("Цена и открытый интерес", overlay = false)
dp = ta.change(close)
build = oi.available and dp > 0 and oi.change > 0
plot(oi.change, "Изменение OI", style = plot.style_columns, color = build ? color.teal : color.gray)

Ставка фінансування: funding.*

Ім’я Що повертає
funding.rate Прогноз ставки на найближчий розрахунок
funding.interval_hours Годин між розрахунками
funding.settled true на барі, де пройшов розрахунок
funding.settled_rate Ставка, реально списана на цьому барі; якщо розрахунків у барі кілька — їх сума
funding.cum Сума списаних ставок за завантажену історію
funding.available Чи є ставка фінансування у інструмента

Ставка — частка, а не відсотки: 0.0001 — це 0,01 %. Графік показує відсотки, мова нічого не перераховує. Для перевірки гіпотез на історії беріть funding.settled_rate: funding.rate — це прогноз, він змінюється до самого розрахунку. У спота ставки фінансування немає, на секундних таймфреймах значення — na.

Loot
indicator("Фандинг за расчёт, %", overlay = false)
plot(funding.rate * 100, "Прогноз ставки", style = plot.style_area, color = funding.rate >= 0 ? color.teal : color.red)
plotshape(funding.settled, "Расчёт", style = shape.circle, location = location.bottom, color = color.orange, size = size.tiny)

Історія біржового стакана: depth.*

Біржовий стакан у тому вигляді, в якому його записав сервер, — ті самі дані, що малює теплова карта, — розкладений по барах. На відміну від живого book.*, ці значення є на кожному записаному барі. Ціни згруповані в корзини, об’єм корзини — найбільший за бар, у монетах.

Ім’я Що повертає
depth.available Чи записаний стакан для цього бару
depth.levels Число непорожніх корзин у барі
depth.price(i) Нижня межа корзини i, за зростанням
depth.qty(i) Найбільший об’єм, що стояв у корзині за бар
depth.side(i) +1 біди, -1 аски, 0 корзина була по обох боках
depth.at(price) Об’єм у корзині, куди потрапляє ціна
depth.grid_step Розмір корзини в одиницях ціни
depth.best_bid, depth.best_ask Найкращі ціни на кінець бару
depth.max_cell Об’єм найважчої корзини
depth.bid_sum(pct), depth.ask_sum(pct) Об’єм сторони в межах pct % від середини
depth.imbalance(pct) Перекіс у тій же смузі: від -1 до +1
depth.max_bid(pct), depth.max_ask(pct) Ціна й об’єм найважчої корзини сторони в смузі

Обмеження:

  • Дані є там же, де серверна теплова карта, і на таймфреймах від секунди.
  • Сервер зберігає смугу приблизно ±4 % від ціни. Поза нею depth.at повертає na, всередині смуги порожня корзина — 0.
  • Глибина історії обмежена: найстаріші бари довгої історії дають na.
  • Значення формуючогося бару змінюються, доки надходять дані.
Loot
indicator("Перекос записанного стакана", overlay = false)
band = input.float(1.0, "Полоса, % от цены", minval = 0.1, maxval = 4.0, step = 0.1)
imb = depth.imbalance(band)
plot(imb, "Перекос", style = plot.style_columns, color = imb >= 0 ? color.teal : color.red)

Щоб намалювати записаний біржовий стакан під свічками, достатньо одного рядка heatmap.depth() в скрипті з overlay = true. Кольори й пороги поля — на сторінці Налаштування і відображення.

Loot
indicator("Записанный стакан теплом", overlay = true)
heatmap.config(palette = heatmap.inferno, low = 25)
heatmap.depth()

Живий біржовий стакан і стрічка угод: book.* і tape.*

Живий біржовий стакан і стрічку ніхто не записує, тому значення є тільки на останньому барі, а в історії — завжди na. Для них потрібна відкрита панель біржового стакана того ж інструмента: інакше book.available і tape.available хибні, а в легенді — «немає відкритого стакана». У режимі реплея ці дані недоступні.

Ім’я Що повертає
book.bid(i), book.ask(i) Ціна рівня i; 0 — найкраща ціна
book.bid_qty(i), book.ask_qty(i) Об’єм на рівні, в монетах
book.spread Найкращий аск мінус найкращий бид
book.mid Середина між найкращими цінами
book.imbalance(n) Перекіс об’єму по n верхнім рівням кожної сторони: від -1 до +1
book.available Чи є знімок стакана
tape.last_price, tape.last_qty Ціна й об’єм останньої угоди
tape.last_side +1 покупець‑агресор, -1 продавець, 0 — угод ще не було
tape.count(ms) Число угод за останні ms мілісекунд
tape.buy_volume(ms), tape.sell_volume(ms) Об’єм агресивних покупок і продажів за вікно
tape.max_print(ms) Найбільша угода за вікно
tape.available Підключена чи стрічка

Вікно стрічки і глибину book.imbalance задають числом у коді або налаштуванням input.int. Вікно відлічується від часу останньої угоди на майданчику, а не від годинника комп’ютера. Скрипту доступний лише хвіст стрічки — близько двох тисяч останніх угод, тому на активному ринку довге вікно покаже не весь інтервал.

Коли таке значення потрапляє в plot, редактор попереджає: «Дані є тільки в реальному часі — в історії ряд порожній». Це очікувано: ліворуч від останнього бару ряд порожній. Стратегії ці дані читати не можуть — див. Стратегії і тестер.

Loot
indicator("Перекос стакана", overlay = false)
levels = input.int(20, "Уровней с каждой стороны", minval = 1, maxval = 200)
imb = book.available ? book.imbalance(levels) : na
plot(imb, "Перекос", style = plot.style_area, color = imb >= 0 ? color.teal : color.red)
hline(0, "Ноль", color = color.gray)

Скринер: screener.*

Метрики скринера для інструмента графіка — ті самі числа, що в його колонках. Історії в них немає: значення є тільки на останньому барі. Вікно задається рядком, і не в кожної метрики є кожне вікно.

Функція Що показує Вікна
screener.change(w) Зміна ціни "1m" "5m" "15m" "1h" "24h"
screener.vol(w) Оборот "1m" "5m" "15m" "1h" "24h"
screener.avg_vol(w) Середній оборот "1m" "5m" "15m" "1h"
screener.rvol(w) Відносний об’єм "1h" "24h"
screener.natr(w) NATR "1m" "5m"
screener.oi_delta(w) Зміна відкритого інтересу "1m" "5m" "1h" "24h"
screener.btc_corr(w) Кореляція з BTC "1m" "5m"
screener.available Чи покритий інструмент скринером —

Вікно, якого немає в таблиці, дає na. Метрика, яка не входить у вашу підписку на скринер, — теж na. Редактор помічає вивід цих значень тим самим попередженням, що й у стакана: в історії ряд порожній.

Loot
indicator("Скринер: RVOL и NATR", overlay = false)
plot(screener.rvol("1h"), "RVOL 1h", color = color.orange)
plot(screener.natr("5m"), "NATR 5m", color = color.teal)

Покриття майданчиків

Майданчик Кластери і дельта Відкритий інтерес і ставка фінансування
Binance, Bybit, OKX, Bitget, Gate.io, MEXC, KuCoin, BingX, AsterDEX Спот і ф’ючерси Ф’ючерси
Hyperliquid Ф’ючерси; спот — ні Ф’ючерси
Binance Alpha Ні: майданчик не публікує сторону агресора Ні
Upbit Ні Ні
Дані Таймфрейми
Кластери Від 30 секунд до 1 дня
Дельта Від 30 секунд
Відкритий інтерес, ставка фінансування Від 1 хвилини
Історія біржового стакана Від 1 секунди, там же, де серверна теплова карта
Живий біржовий стакан, стрічка угод Будь‑які, за умови відкритої панелі біржового стакана
Скринер Будь‑які, для інструментів, які бачить скринер

Покриття визначає сервер даних, і воно може змінюватися. Надійніше за все опиратися на прапорець .available і підпис у легенді.

Інший таймфрейм і інший інструмент

request.security рахує вираз на іншій серії — старшому таймфреймі або іншій монеті — і зіставляє результат з барами графіка.

TEXT
request.security(symbol, timeframe, expression, gaps = false, lookahead = false, ignore_invalid_symbol = false)
  • symbol — у форматі «МАЙДАНЧИК:ТИКЕР», як у TradingView: "BINANCE:BTCUSDT.P", де .P — безстроковий ф’ючерс. Інструмент графіка — sym.ticker.
  • timeframe — рядок виду "5", "60", "4h", "1D", "1W". Таймфрейм графіка — tf.period.
  • expression — число або кілька чисел у квадратних дужках: [high, low].

Без зазірнення вперед. За замовчуванням бар графіка бачить значення останній закритий бар старшого таймфрейма. Тому годинна EMA на п’ятихвилинках — це сходинка, яка зсувається лише на закритті години. Так результат на історії співпадає з тим, що ви б побачили наживо.

  • gaps = true — значення лише на першому барі графіка, де з’явився новий старший бар, далі na.
  • ignore_invalid_symbol = true — невідомий символ дає na. Без цього скрипт зупиняється з помилкою «Символ … невідомий».

Всередині виразу доступні свічки іншої серії й розрахунки по них. Передати туди змінну графіка не можна — лише значення налаштувань input.*. Біржовий стакан, стрічка й скринер всередині запиту не компілюються, а кластери, дельта, відкритий інтерес і ставка фінансування іншої серії дають na. У скрипта може бути до 8 різних пар «інструмент + таймфрейм» і до 32 викликів request.security.

Loot
indicator("EMA старшего таймфрейма", overlay = true)
len = input.int(20, "Длина EMA", minval = 2, maxval = 500)
tfHigh = input.timeframe("60", "Старший таймфрейм")
emaHigh = request.security(sym.ticker, tfHigh, ta.ema(close, len))
plot(emaHigh, "EMA", color = color.orange, style = plot.style_stepline)
Loot
indicator("Спред к другой бирже", overlay = false)
other = input.symbol("BYBIT:BTCUSDT.P", "Сравнить с")
px = request.security(other, tf.period, close, ignore_invalid_symbol = true)
plot(close - px, "Разница", color = color.orange)

Далі

https://docs.lootx.trade/uk/loot/market-data

Основы

7Стратегії та тестер

Як написати стратегію на LootScript і перевірити її на історії в тестері: оголошення strategy(), заявки, модель виконання, витрати, вкладки звіту і обмеження бектесту.

Стратегія — це скрипт, який крім ліній на графіку подає заявки. Заявки виконує не біржа, а симулятор всередині терміналу: він проганяє стратегію по історії графіка з комісіями, прослизанням і ставкою фінансування та показує результат у вікні Тестер стратегії.

Оголошення strategy()

Стратегію відрізняє від індикатора перший рядок: strategy(...) замість indicator(...). Усе інше — налаштування, відображення, дані ринку — працює так само. Функції strategy.* в індикаторі не компілюються: «strategy.* доступно лише в strategy(…)».

Параметр За замовчуванням Що задає
initialCapital 10000 Стартовий капітал
defaultQtyType, defaultQtyValue strategy.qty.fixed, 1 Розмір заявки, якщо в ній не вказано qty
commissionType, commissionValue відсоток, не задана Комісія: strategy.commission.percent — відсоток від обороту (0.05 = 0,05 %), strategy.commission.cash_per_contract — сума за одиницю кількості, strategy.commission.cash_per_order — сума за виконання
slippageTicks 0 Прослизання в тиках
pyramiding 0 Скільки входів в один бік може бути відкрито; 0 — один
positionModel strategy.model.netting Одна загальна позиція або роздільні довгі і короткі (strategy.model.hedging)
processOrdersOnClose false Виконувати ринкові заявки по закриттю поточного бару
calcOnEveryTick false Дозволити заявки на формуючомуся барі
marginLong, marginShort, leverage 0, 0, 1 Маржа у відсотках або плече; при 0 ліквідація не моделюється
applyFunding true Враховувати ставку фінансування
fillModel strategy.fill.conservative Припущення про шлях ціни всередині бару

Значення параметрів — лише числа і константи прямо в тексті. Вираз або input.* в оголошенні — помилка компіляції. Параметр calcOnOrderFills приймається, але в цій версії не діє: на вкладці «Властивості» тестера він позначений «не діє в цій збірці».

Розмір заявки при qty = na задає defaultQtyType:

Тип defaultQtyValue означає
strategy.qty.fixed Кількість у монетах (базовій валюті)
strategy.qty.cash Суму в валюті котирування
strategy.qty.percent_of_equity Відсоток поточного капіталу
strategy.qty.risk_percent Відсоток капіталу, яким ризикуєте до захисного стопа

Для strategy.qty.risk_percent потрібен strategy.exit зі стопом (loss або stop), інакше компілятор зупинить: «вимагає стоп, від якого рахувати розмір». Кількість округлюється вниз до кроку кількості інструмента. Якщо після округлення залишається нуль, заявка відхиляється і потрапляє в лічильник тестера «Відхилено заявок (розмір)».

Заявки

Функція Що робить
strategy.entry(id, direction, qty, limit, stop, …) Відкриває позицію або розгортає її. Враховує модель позиції і pyramiding
strategy.order(id, direction, qty, limit, stop, …) Те саме без урахування моделі позиції і pyramiding
strategy.exit(id, from_entry, qty, qty_percent, profit, limit, loss, stop, trail_price, trail_points, trail_offset, …) Виставляє вихід — тейк-профіт, стоп-лос або трейлінг — на відкритий вхід
strategy.close(id, comment, qty, qty_percent) Закриває вхід ринковою заявкою
strategy.close_all(comment) Закриває все
strategy.cancel(id), strategy.cancel_all() Знімає ще не виконані заявки

Напрям — strategy.long або strategy.short. У всіх функцій є необов’язковий when: when = false пропускає виклик. У входів, виходів і закриттів є ще comment — текстовий підпис до заявки.

  • Тип входу. Без limit і stop — ринкова заявка, з limit — лімітна, зі stop — стоп-заявка, з обома — стоп-ліміт. Повторний strategy.entry з тим же id замінює ще не виконану заявку.
  • Розворот. У моделі netting вхід в протилежний бік закриває поточну позицію і відкриває нову одним діянням.
  • Одиниці виходу. profit і loss — в тиках від ціни входу, limit і stop — абсолютні ціни. Трейлінг задається парою: trail_offset плюс trail_price або trail_points.
  • Вихід без рівнів нічого не робить. Компілятор попередить: «strategy.exit без жодного рівня (profit/loss/stop/limit/trail) — порожня операція».
  • Перенос стопа. Повторний strategy.exit з тим же id замінює вихід — так рухають стоп.

Стан стратегії читається рядками: strategy.position_size (зі знаком, коротка позиція — від’ємна), strategy.position_avg_price, strategy.equity, strategy.netprofit, strategy.openprofit, strategy.opentrades, strategy.closedtrades, strategy.funding_paid та іншими — повний список у довіднику.

Як тестер виконує заявки

Заявка, подана на барі, виконується не раніше наступного бару. Рішення приймається по закриттю бару, і виконувати його по тій же ціні означало б зазирнути наперед.

Заявка Виконання
Ринкова По відкриттю наступного бару плюс прослизання. З processOrdersOnClose = true — по закриттю поточного
Лімітна Коли ціна проходить ліміт, по ціні ліміту. Якщо бар відкрився за лімітом — по відкриттю
Стоп Коли ціна проходить стоп, по ціні стопа плюс прослизання. При гепі — по відкриттю плюс прослизання

Шлях ціни всередині бару. Справжнього шляху всередині бару тестер не знає і припускає його. Модель strategy.fill.conservative (за замовчуванням) вважає, що ціна спочатку йшла до гіршого екстремуму: на зростаючому барі — відкриття → мінімум → максимум → закриття, на падаючому — навпаки. Якщо в одному барі опинилися і стоп, і тейк, спрацьовує стоп. Модель strategy.fill.optimistic припускає зворотне — підходить тільки для порівняння. Відтворень по молодшому таймфрейму в цій версії немає: у колонці «Шлях» кожна угода позначена як припущена моделлю.

Витрати.

  • Комісія. Якщо commissionValue не задано, тестер бере тариф за замовчуванням: 0,02 % за лімітні виконання і 0,05 % за ринкові та стоп-исполнення. Тариф вашого рахунку і рібейти терміналу невідомі. Задане число діє на всі виконання.
  • Прослизання — slippageTicks проти вас на ринкових і стоп-виконаннях. Лімітні — без прослизання.
  • Ставка фінансування списується на кожному реальному розрахунку біржі — за фактичною ставкою і ціною закриття бару розрахунку. Для цього потрібні дані по ставках фінансування: ф’ючерси на біржах із таблиці покриття.
  • Маржа. З marginLong/marginShort або плечем більше 1 тестер моделює спрощену ізольовану маржу. Довга позиція ліквідується при ціні входу × (1 − m/2), коротка — при вході × (1 + m/2), де m — частка початкової маржі. Ліквідована угода втрачає всю початкову маржу.

Угоди, не закриті до кінця історії, закриваються по закриттю останнього бару з причиною «кінець даних».

Тестер стратегії

Додайте стратегію на графік

У редакторі скриптів натисніть Додати на графік (Ctrl+Enter). Скрипт з помилками на графік не потрапить.

Відкрийте тестер

У панелі інструментів редактора натисніть Тестер стратегії… — кнопка активна лише для скрипта з strategy(...). Другий шлях — налаштування стратегії з легенди графіка (шестерня), кнопка Тестер стратегії….

Дочекайтеся прогону

Тестер рахує за свічками, завантаженими на графік. Якщо їх немає, вікно показує «Стратегія ще не розраховувалася: дочекайтеся завантаження свічок». Коли приходять нові свічки, результат перераховується сам; кнопка Перерахувати запускає повний прогін вручну.

Якщо на графіках кілька стратегій, потрібну можна вибрати прямо у вікні тестера.

Вкладка Що на ній
Зведення Плитки «Чистий прибуток», «Профіт-фактор», «Макс. просідання (по закриттях)», «Доля прибуткових», «SQN»; смуга «Чого цей бектест не знає»; криві капіталу, «купив-і-тримай», капіталу без ставки фінансування і двох просідань
Показники Результат, ризик (просідання по закриттях і всередині бару окремо, Шарп, Сортино, Калмар), угоди (доля прибуткових, середні та найбільші, серії), витрати (комісія і ставка фінансування)
Угоди Таблиця угод: вхід, вихід, причина, об’єм, P&L, ран-ап, просідання, комісія, ставка фінансування. Клік по рядку прокручує графік до бару входу, Ctrl+C копіює виділені рядки
Властивості Параметри оголошення, діапазон барів, крок ціни, крок кількості, мінімальний лот, комісія, лічильники прогону: відхилені заявки, пропущені по pyramiding, ліквідації, розрахунки ставки фінансування

У заголовку вікна — мітки режиму: conservative або optimistic по моделі виконання і close-fill при processOrdersOnClose = true. Мітки optimistic і close-fill означають, що в реалі результат, швидше за все, буде гіршим.

Чого стратегія читати не може

Живий біржовий стакан і стрічка угод. Стратегія, яка читає book.* або tape.*, не компілюється: «Стратегія читає …: у біржового стакана й стрічки немає історії; бектест був би вигадкою». Для історії стакана є depth.*, для угод — delta.* і cluster.*.

Скринер. screener.* теж є лише на останньому барі, але компілятор таку стратегію пропускає. На історії значення скринера — na, тому умови на них там не виконуються, і угод по них у звіті не буде.

Зазиряння наперед. request.security(..., lookahead = true) в стратегії дає в редакторі попередження «Стратегія зазирає наперед … звіт позначений як недосяжний у реальному часі». Ставтеся до такого звіту як до завищеного: на історії стратегія бачить значення, яких у реалі ще не було. Детальніше — у розділі Дані ринку.

Приклад

Пробій каналу з підтвердженням дельтою. Вхід — на закритті поза межею каналу за останні len барів, якщо дельта бару в той самий бік. Стоп — в ATR, тейк-профіт — удвічі далі.

Loot
strategy("Пробой канала с дельтой", overlay = true,
         initialCapital = 10000,
         defaultQtyType = strategy.qty.percent_of_equity, defaultQtyValue = 20,
         commissionValue = 0.05, slippageTicks = 2)

len      = input.int(20, "Канал, баров", minval = 5, maxval = 200)
stopAtr  = input.float(1.5, "Стоп, ATR", minval = 0.5, maxval = 10, step = 0.1)
needFlow = input.bool(true, "Подтверждать дельтой")

upper = ta.highest(high, len)[1]
lower = ta.lowest(low, len)[1]
atr   = ta.atr(14)

flowLong  = not needFlow or (delta.available and delta.value > 0)
flowShort = not needFlow or (delta.available and delta.value < 0)

if close > upper and flowLong and strategy.position_size <= 0 {
    strategy.entry("L", strategy.long, comment = "пробой вверх")
}
if close < lower and flowShort and strategy.position_size >= 0 {
    strategy.entry("S", strategy.short, comment = "пробой вниз")
}

stopTicks = math.round(atr * stopAtr / sym.tick_size)
strategy.exit("L-x", from_entry = "L", loss = stopTicks, profit = stopTicks * 2)
strategy.exit("S-x", from_entry = "S", loss = stopTicks, profit = stopTicks * 2)

plot(upper, "Верх канала", color = color.teal)
plot(lower, "Низ канала", color = color.red)

На біржі без дельти (наприклад, Binance Alpha) при увімкненій налаштуванні «Підтверджувати дельтою» стратегія не зробить жодної угоди: delta.available там хибне. Це правило na в дії, а не помилка.

Обмеження

  • Лише симуляція: реальних заявок немає.
  • Лімітні заявки виконуються так, ніби ви стояли першим у черзі. Для мейкерських стратегій це головне джерело завищеного результату.
  • Ваші угоди не рухають ціну, часткових виконань немає: заявка виконується цілком або ніяк.
  • Шлях ціни всередині бару припускається моделлю, а не береться з молодшого таймфрейму.
  • Ліквідація спрощена: механізм ліквідацій біржі, ADL і страховий фонд не моделюються.
  • Комісія — тариф за замовчуванням, а не тариф вашого рахунку.
  • Відсутність даних — не відсутність руху: бар без кластерів все одно рухався.
  • Результат залежить від того, скільки історії завантажено на графік.

Далі

https://docs.lootx.trade/uk/loot/strategies

Основы

8Сповіщення зі скриптів

Як скрипт на LootScript повідомляє про спрацювання умови: alert() і alertcondition(), частота, увімкнення умов, куди приходить сповіщення і чого в скриптових сповіщень немає.

Скрипт може повідомити вам, що на живому ринку виконалася умова: пробій рівня, сплеск дельти, перетин ліній. Для цього в LootScript є дві функції — alert(), яку скрипт викликає сам, і alertcondition(), умова, яку ви вмикаєте вручну.

Спрацювання потрапляє в той самий конвеєр, що й інші сповіщення терміналу: запис у стрічці Оповіщення, звук, спливаюча плашка. Усе це рахується всередині терміналу на вашому комп’ютері: сповіщення працюють, поки термінал запущено і скрипт стоїть на графіку.

Два способи

alert() alertcondition()
Хто вирішує, чи дзвонити Код скрипта Ви: умову потрібно увімкнути
Коли спрацьовує За вибраною частотою, в тому числі на незакритому барі Лише на закритті бару, не частіше за раз на бар
Текст Будь-який рядок, можна зібрати з чисел Фіксований текст у коді
Де вмикається Завжди, поки скрипт на графіку Галочкою в консолі редактора

Якщо сповіщення потрібно завжди — використовуйте alert(). Якщо скрипт оголошує кілька сигналів, а дзвонити повинні тільки деякі — оголосіть їх через alertcondition() і увімкніть потрібні.

alert(): сповіщення з коду

TEXT
alert(message, freq = alert.freq_once_per_bar_close)

message — рядок. Числа в нього вставляють через str.tostring: "Цена " + str.tostring(close). Текст приходить у сповіщення як є, термінал його не перекладає і не править.

Частота задається константою:

Частота Коли спрацьовує
alert.freq_once_per_bar_close За замовчуванням. Один раз, коли бар закрився: при першому оновленні наступного бару, за значеннями закритого
alert.freq_once_per_bar У перший момент, коли виклик відбувся на цьому барі — навіть якщо бар ще формується. Далі мовчить до наступного бару
alert.freq_all На кожному перерахунку живого бару, де виклик спрацював

Частота рахується для кожного виклику alert() окремо: два виклики в одному скрипті не заглушують один одного. За один перерахунок скрипт відправляє не більше 16 сповіщень, решта відкидаються.

Приклад: сповіщення про сплеск дельти, щойно він з’явився на формуючомуся барі.

Loot
indicator("Всплеск дельты", overlay = false)
mult = input.float(3.0, "Во сколько раз больше обычного", minval = 1.5, step = 0.5)
base = ta.sma(math.abs(delta.value), 50)
spike = delta.available and math.abs(delta.value) > base * mult
plot(delta.value, "Дельта", style = plot.style_columns, color = delta.value >= 0 ? color.teal : color.red)
if spike {
    alert("Всплеск дельты: " + str.tostring(delta.value, "#.##"), freq = alert.freq_once_per_bar)
}

Там, де дельти немає, delta.available хибне й сповіщення не спрацьовує — детальніше про правило na в розділі Дані ринку.

alertcondition(): умова, яку вмикаєте ви

TEXT
alertcondition(condition, title, message)

condition — логічний вираз, title — назва умови, message — текст сповіщення. title і message — рядки прямо в коді, зібрати їх із чисел не можна. Без message у сповіщення піде title.

Умова дзвонить лише на закритті бару, не частіше разу за бар і тільки якщо вона увімкнена. За замовчуванням усі умови вимкнені.

Додайте скрипт на графік

В редакторі скриптів натисніть Додати на графік.

Відкрийте вкладку «Вивід»

У консолі під кодом виберіть вкладку Вивід. Там показані значення рядів на останньому барі і список «Умови алертів (alertcondition) — увімкніть потрібні».

Увімкніть умови

Позначте галочками умови, за якими хочете отримувати сповіщення. Якщо скрипт стоїть на кількох графіках, у кожного свій список.

Історія мовчить

Сповіщення дзвонять тільки на живих оновленнях. Перший розрахунок після завантаження графіка, після зміни інструмента і після підвантаження більш старшої історії вважається історією: на минулих барах ні alert(), ні alertcondition() не спрацьовують. Тому, додавши скрипт на графік, ви не отримаєте купу сповіщень за минуле.

Перевірити умову на історії можна візуально: намалюйте її міткою plotshape — вона покаже кожний бар, де сповіщення б спрацювало.

Куди приходить сповіщення

Кожне спрацювання:

  • Записується в стрічку «Оповіщення» з джерелом «Скриптовий алерт». У записі — текст повідомлення, ім’я скрипта і, для alertcondition(), назва умови. Стрічка відкривається окремим вікном або панеллю робочого простору; фільтр Джерела залишає в ній лише скриптові алерти.
  • Програє звук. Його вибирають в Налаштування → Сповіщення, блок «Звуки», рядок «Скриптовий алерт»: список звуків і перемикач, який вимикає звук.
  • Показує плашку «Ім’я скрипта: текст».
  • Підсвічує вкладку робочого простору, де стоїть графік зі скриптом.

Інші сповіщення терміналу описані на сторінці Алерти і рівні.

Журнал: log.*

Для налагодження умов є журнал. log.info, log.warning і log.error пишуть рядок у вкладку Журнал консолі редактора — туди ж, де Проблеми і Вивід.

  • Журнал, як і сповіщення, пишеться тільки на живих оновленнях — на історії мовчить.
  • На один бар — не більше 16 рядків, решта відкидаються.
  • Консоль зберігає останні 256 рядків. Більш старі витісняються, їх кількість показано як «витіснено рядків». Кнопка Очистити очищує журнал.
Loot
indicator("Проверка условия", overlay = true)
len = input.int(20, "Канал, баров", minval = 2, maxval = 500)
upper = ta.highest(high, len)[1]
plot(upper, "Верх канала", color = color.teal)
if barstate.islast {
    log.info("Закрытие " + str.tostring(close) + ", верх канала " + str.tostring(upper))
}

Приклад: пробій каналу

Скрипт малює верхню межу каналу, відзначає пробої трикутником і повідомляє про них двома способами: alert() дзвонить завжди, а умова «Пробой вверх» — тільки якщо ви її увімкнули.

Loot
indicator("Пробой канала с алертом", overlay = true)
len = input.int(20, "Канал, баров", minval = 2, maxval = 500)
upper = ta.highest(high, len)[1]
breakUp = ta.crossover(close, upper)
plot(upper, "Верх канала", color = color.teal)
plotshape(breakUp, "Пробой", style = shape.triangleup, location = location.belowbar, color = color.teal, size = size.small)
if breakUp {
    alert("Пробой вверх, цена " + str.tostring(close), alert.freq_once_per_bar_close)
}
alertcondition(breakUp, "Пробой вверх", "Цена закрылась выше канала")

Межа береться зі зсувом [1] — по попередніх барах, інакше поточний максимум завжди був би всередині каналу. Частота freq_once_per_bar_close означає, що сповіщення прийде після закриття бару над каналом, а трикутник на графіку залишиться саме там, де сповіщення пролунало. У реальному скрипті зазвичай лишають один із двох способів — тут обидва для порівняння.

Далі

https://docs.lootx.trade/uk/loot/alerts

Основы

9ШІ‑помічник у редакторі

Чат із моделлю ШІ в редакторі LootScript: пише й править скрипти, перевіряє їх на свічках, відповідає на питання про ринок. Які провайдери доступні, де ввести ключ і що передається з комп’ютера.

У редакторі LootScript є чат із моделлю ШІ. Опишіть словами, який індикатор потрібен — помічник напише код просто в редакторі, скомпілює його, прогоне на реальних свічках і розкаже, що вийшло. Він також править готові скрипти, пояснює чужий код і відповідає на питання про ринок за даними терміналу.

Модель ви обираєте самі: хмарну — зі своїм ключем API, або локальну — на своєму комп’ютері. Запити йдуть від терміналу безпосередньо до обраного провайдера, без серверів LootX.

Як відкрити помічника

  1. Натисніть ƒ на панелі графіка — відкриється вікно Індикатори.
  2. Натисніть Редактор… поруч зі рядком пошуку або відкрийте свій скрипт.
  3. У верхній панелі редактора, поруч із Додати на графік, натисніть Помічник.

Чат з’явиться праворуч від коду. Ширину можна змінювати, перетягуючи роздільник. Хрестик у шапці чату (Сховати чат) прибирає його, не видаляючи розмову; повторне натискання Помічник повертає.

Підключення моделі

Відкрийте картку підключення

При першому запиті картка відкриється автоматично. Пізніше її викликає шестерня Ключ і підключення у шапці чату.

Оберіть провайдера

Список — у таблиці нижче. За замовчуванням обрано Claude.

Вставте ключ API

Під полем є посилання Отримати ключ на … — воно веде в кабінет провайдера. Збережений ключ у полі не показується: залиште його порожнім, щоб не змінювати, або натисніть Видалити ключ.

Перевірте модель і збережіть

Поле Модель заповнене моделлю за замовчуванням, у підказках — ще кілька. Ім’я можна вписати будь‑яке, яке знає провайдер. Натисніть Зберегти.

Провайдер Що потрібно
Claude Ключ API Anthropic. Підписка Claude не підходить — Anthropic забороняє стороннім програмам працювати по ній.
Gemini Ключ API Google. Підписка Gemini не підходить з тієї ж причини.
OpenAI, DeepSeek, Grok, Mistral, Qwen, Kimi, GLM, Groq Ключ API провайдера.
OpenRouter Ключ OpenRouter: через нього доступні моделі різних компаній.
Ollama, LM Studio Ключ не потрібен: модель працює на вашому комп’ютері. Запустіть сервер, завантажте модель і впишіть її назву.
Сумісний з OpenAI Будь‑який сервер з API у форматі OpenAI Chat Completions: шлюз, vLLM, корпоративний проксі. Укажіть адресу (зазвичай закінчується на /v1), модель і ключ, якщо сервер його вимагає.

Хмарні запити оплачуються за тарифом вашого облікового запису у провайдера, окремо від LootX. Після кожної відповіді в чаті видно, скільки токенів витрачено на вхід і на вихід.

Локальній моделі потрібна підтримка виклику інструментів (tool calling). Без неї помічник не зможе писати в редактор і перевіряти код.

Проксі і власна адреса

Якщо сервіс провайдера недоступний з вашої мережі безпосередньо, вкажіть проксі в полі Проксі — http://host:port або socks5://логін:пароль@host:port. Проксі спільний для всіх провайдерів. Поле Адреса API (для власного шлюзу) потрібно тільки якщо ви заходите до провайдера через власний шлюз.

Що вміє помічник

  • Пише новий скрипт за описом і відразу кладе код у редактор.
  • Править готовий — точково, не переписуючи файл повністю.
  • Перевіряє себе. Компілює код і запускає його на реальних свічках — за замовчуванням на інструменті і таймфреймі графіка, до 5000 останніх барів, за запитом на будь‑якому іншому. Перевіряє результати в кожному ряді і наявність помилок виконання.
  • Додає скрипт на графік, коли ви про це просите.
  • Відповідає про ринок. Бере свічки будь‑якого інструмента з терміналу, метрики скрінера (волатильність, обсяг, відкритий інтерес, ставка фінансування, спред) і ранжирує ринок: «Які ф’ючерси зараз найволатильніші?».
  • Звіряється зі довідником мови, дивиться вбудовані індикатори і скрипти з вашої бібліотеки.

Кожен крок видно в стрічці угод рядком: «Компілюю», «Запускаю на свічках», «Правлю код». Якщо модель показує хід міркувань, він згорнутий у блок Хід думок. Відповідь можна перервати кнопкою Зупинити.

Усе, що помічник пише в редактор, відміняється звичайним Ctrl+Z. Якщо код у відповіді прийшов блоком, у його шапці є кнопки. У цілого скрипта це У редактор — замінити код у редакторі, у фрагмента — Вставити у позицію курсора. Копіювати є в обох.

Швидкі команди

Наберіть / у полі вводу — з’явиться підказка. Ті самі команди є кнопками в порожньому чаті. Текст після команди — ваше уточнення: /fix дивись на обсяг.

Команда Що робить
/fix Знаходить і виправляє помилки: компілює, запускає на свічках, лагодить помилки і ряди, де одні na. Зберігає вашу ідею й стиль, наприкінці перераховує правки.
/explain Пояснює простими словами, що робить скрипт, на що впливає кожне налаштування, що він малює і як читати сигнали. Код не змінює.
/optimize Прискорює скрипт, не змінюючи результат: замінює самописні цикли вбудованими функціями, прибирає зайву роботу і перевіряє прогоном, що значення не змінилися.

Інше слово після косої відправляється моделі як звичайне питання.

Картинки і знімки графіка

До питання можна додати картинку: скріпкою під полем вводу, вставкою з буфера (Ctrl+V) або перетягнувши файл у чат. Кнопка з графіком поруч зі скріпкою додає знімок тієї панелі, куди додається скрипт. В одному питанні — до шести картинок. Перед відправкою великі зображення зменшуються.

Не всі моделі бачать картинки. Якщо обрана модель не бачить, чат попередить до відправлення. Якщо термінал не знає, чи бачить модель картинки, і провайдер відхилить питання, картинки повернуться в поле вводу.

Історія розмов

Розмова прив’язана до скрипту. Відкриєте інший скрипт — у чаті відобразиться його розмова. Закриєте редактор або перезапустите термінал — розмова залишиться на місці.

  • У нового, ще не збереженого скрипта розмова на диск не пишеться. Вона збережеcя разом зі скриптом при першому Зберегти.
  • Значок Новий чат у шапці починає розмову заново і стирає попередню з диска.
  • Видалили скрипт — видалилася і його розмова.
  • Поки помічник відповідає, відкрити інший скрипт не можна: спочатку зупиніть відповідь.

Усю розмову помічник відправляє моделі з кожним питанням, тому довга чат‑історія дорожча. Розмір розмови в токенах показано числом у шапці чату, наприклад «42k». Натисніть на нього, щоб стиснути розмову в зведення: далі помічник пам’ятає її по ньому. Старі результати перевірок і картинки термінал згортатиме сам. У збереженій історії старі картинки з часом замінюються позначкою «Картинка до цього питання більше не зберігається».

Що відправляється з комп’ютера

До обраного провайдера, напряму:

  • ваші повідомлення і прикріплені картинки;
  • назва скрипта, число рядків і помилок, інструмент і таймфрейм графіка — з кожним питанням;
  • код з редактора і звіт компілятора — коли помічник читає або править скрипт;
  • дані, які помічник запросив: свічки, метрики скрінера, результати прогонів, фрагменти документації мови.

Не відправляється:

  • Таємниці. Ключів бірж помічник не бачить. Ключ провайдера зберігається на цьому комп’ютері в зашифрованому вигляді, не потрапляє в синхронізацію налаштувань і передається лише самому провайдеру — для входу. З тексту, що відправляється моделі, термінал вирізує все, що схоже на ключ, токен або пароль, а також шляхи до файлів на диску. Повідомлення, в яке ви самі вставили щось схоже на ключ, не відправляється взагалі — чат попросить прибрати секрет.
  • Рахунок. У помічника немає доступу до балансу, позицій і заявок — він бачить тільки те, що ви показали на знімку. Виставляти ордери він не вміє.
  • Історія чату. Вона лежить на цьому комп’ютері в зашифрованому вигляді і не потрапляє ні в синхронізацію, ні в експорт налаштувань, ні в звіт для підтримки.

З Ollama або LM Studio розмова і код не покидають комп’ютер.

Обмеження

  • Потокових даних у перевірочному прогоні немає. Кластер, дельта, відкритий інтерес, ставка фінансування, біржовий стакан, стрічка угод, скринер і історія біржового стакана при запуску на свічках рівні na. Логіку, яка на них опирається, помічник перевірити не може — додайте скрипт на графік і подивіться самі.
  • Ліміт кроків. За одну відповідь помічник робить не більше 24 кроків, потім підводить підсумок. Відповідь, обірвана за довжиною, також можна продовжити — просто попросіть.
  • Модель помиляється. Прогін ловить помилки компіляції й виконання, але не помилки задуму. Перед тим як покладатися на сигнали, подивіться скрипт на графіку.
  • Відмови провайдера чат показує текстом із назвою провайдера: ключ не прийнято, вичерпано ліміт запитів, закінчилися гроші або квота, немає зв’язку, локальний сервер не відповідає. Для зв’язку перевірте інтернет або вкажіть проксі.

Далі

https://docs.lootx.trade/uk/loot/ai-assistant

Основы

10Імпорт із Pine Script

Як перенести індикатор з Pine Script у LootScript: де кнопка імпорту, що конвертер змінює автоматично, що позначає для перевірки й як довести результат.

Якщо індикатор уже написаний на Pine Script, переписувати його вручну не потрібно. термінал конвертує файл .pine у LootScript: змінює синтаксис і імена, додає відсутнє й записує на початок файлу нотатки про те, що змінено й де конвертеру довелося вгадувати.

Конвертер — перекладач, а не шар сумісності. Він не гарантує тих же чисел, що в оригінальній середовищі, і не додає в термінал функцій, яких там немає. Тому після імпорту скрипт потрібно відкрити, прочитати нотатки й перевірити на графіку. LootScript розроблено незалежно і не пов’язано з TradingView: синтаксис навмисно схожий, але мови не сумісні.

Як імпортувати

Відкрийте вікно індикаторів

Натисніть ƒ на панелі графіка — відкриється вікно Індикатори.

Натисніть «Імпорт…»

Кнопка стоїть поруч із рядком пошуку. Оберіть файл .pine, .loot або .txt. Файл .loot потрапить у бібліотеку як є. Файл .pine — текстовий файл, схожий на Pine Script — пройде через конвертер.

Прочитайте підсумок

Під рядком пошуку з’явиться один із рядків:

  • «Імпортовано «…»» — нотаток немає, скрипт готовий;
  • «Імпортовано «…»: нотаток конвертера — N, див. шапку скрипта»;
  • «Імпортовано «…», але скрипт не компілюється (помилок: N)…» — поруч із текстом першої помилки.

Вікно переключиться на розділ Мої скрипти, а в пошук підставиться ім’я нового скрипта.

Відкрийте скрипт у редакторі

Прочитайте шапку з нотатками й виправте те, на що вона вказує. Як — нижче.

Імпорт не перезаписує скрипт з тим самим ім’ям: новий отримає суфікс, наприклад -2. Початковий файл не змінюється.

Через папку скриптів

Можна просто покласти файл имя.pine в папку скриптів — на Windows це %APPDATA%\TradingTerminal\scripts. При наступному запуску термінал створить поруч имя.loot. Якщо имя.loot уже є, він його не чіпає — ваші правки не пропадуть. Щоб сконвертувати заново, наприклад після оновлення терміналу, видаліть .loot.

Що робить конвертер

  • Відступи → фігурні дужки. Блоки if, else if, else, циклів і функцій отримують дужки. Рядки-продовження склеюються в один.
  • Функції. f(x) => стає func f(x), а останній вираз функції — явним return.
  • Цикли. Включний for i = 0 to 9 стає напіввідкритим for i in 0 .. 10. Напрям береться з кроку або з літералів меж; якщо його не видно, конвертер вважає цикл зростаючим і пише про це.
  • Умови-значення. if з одним виразом у гілках перетворюється на тернарний оператор, switch отримує дужки.
  • Прозорість → альфа. У Pine Script прозорість йде від 0 до 100, де 0 — непрозоро. У LootScript альфа — від 0 до 255, де 255 — непрозоро. color.new(c, 50) стане color.new(c, 128), а аргумент transp= перетвориться на color.new(…) навколо кольору.
  • Імена. Старі імена без простору отримують його: sma → ta.sma. study → indicator, security → request.security, tostring → str.tostring, syminfo.* → sym.*, timeframe.* → tf.*. Коротка форма input(…) отримує тип: input.int, input.source і так далі.
  • Зайняті імена. Змінна, чиє ім’я в LootScript — ключове слово або простір (delta, oi, tf, sym, func …), отримує підкреслення в кінці скрізь, де зустрічається: delta → delta_.
  • Зайві аргументи — ті, яких у функції в LootScript немає, — знімаються.
  • Оголошення. Якщо у файлі не було indicator(…) або strategy(…), конвертер додасть indicator з ім’ям файлу.
  • Коментарі та порожні рядки лишаються на своїх місцях.

Конвертер не відмовляється від жодного файлу. Рядок, який він не зрозумів, він не викидає, а залишає коментарем // [не разобрано] … на попередньому місці.

Шапка з нотатками

Перша стрічка шапки каже, звідки файл, — «Імпортовано зі скрипта на Pine Script (версія 5). Нотатки конвертера:». Далі — по рядку на кожну правку, у порядку рядків вихідника: «Рядок N: вид: що — подробиці». Нотатки пишуться мовою інтерфейсу.

Вид нотатки Що означає Перевірити?
перейменовано Ім’я замінено на аналог у LootScript ні
перераховано Прозорість переведена в альфу ні
переписано Змінилася форма: цикл, return, тип короткого input поглянути
ім’я «…» зайнято в LootScript Змінній додано підкреслення ні
оголошення indicator(…) не було Оголошення додано з імені файлу ні
аргумент знято У функції в LootScript немає такого параметра так
припущення Конвертер вгадав: напрям циклу, тип вводу, який не вдалося вивести так
немає в цій збірці Такої функції в терміналі немає — скрипт не скомпілюється з помилкою «невідоме ім’я» так
не розібрано Рядок не вдалося розібрати, вона збережена коментарем так

Коли перевірите, шапку можна видалити — це звичайні коментарі.

Приклад

Невеликий індикатор на Pine Script: стовпчики розмаху бара, підсвічені, коли розмах удвічі більше середнього.

PINE
//@version=5
indicator("Range spike", overlay=false)
len = input.int(20, "Length")
avgRange(n) =>
    r = high - low
    ta.sma(r, n)
base = avgRange(len)
spike = high - low > base * 2
plot(high - low, style=plot.style_columns, color=spike ? color.orange : color.new(color.gray, 60))
plot(base, color=color.blue, trackprice=true)

Так його записує конвертер:

Loot
// Импортировано из скрипта на Pine Script (версия 5). Заметки конвертера:
//
// Строка 6: переписано: avgRange — неявный возврат последнего оператора записан как return
// Строка 9: пересчитано: transp → alpha — прозрачность 0…100 пересчитана в альфу 0…255
// Строка 10: аргумент снят: plot: trackprice — такого параметра в LootScript нет

indicator("Range spike", overlay = false)
len = input.int(20, "Length")
func avgRange(n) {
    r = high - low
    return ta.sma(r, n)
}
base = avgRange(len)
spike = high - low > base * 2
plot(high - low, color = spike ? color.orange : color.new(color.gray, 102), style = plot.style_columns)
plot(base, color = color.blue)

Функція отримала дужки і return, прозорість 60 стала альфою 102, а trackprice знято — такого параметра немає. Нотатка «аргумент знято» просить перевірити, чи потрібний цей параметр за змістом. Тут він лише малював лінію останнього значення, і скрипт працює без нього.

Як перевірити і допрацювати

  1. Прочитайте шапку. Почніть з рядків з видами «аргумент знято», «припущення», «немає в цій збірці» та «не розібрано».
  2. Подивіться вкладку «Проблеми» у консолі редактора. Скрипт з помилками на графік не додасться.
  3. Додайте на графік і порівняйте з тим, що показував оригінал, на кількох ділянках історії.
  4. Попросіть помічника. Відкрийте ШІ‑помічника і наберіть /fix — він скомпілює скрипт, прогонить його на свічках і виправить помилки. Можна додати уточнення: /fix розбери нотатки конвертера в шапці. /explain розповість, що робить скрипт.

Що не переноситься

  • Функції, яких немає в терміналі. Ім’я лишається в коді, нотатка «немає в цій збірці» і помилка компілятора вказують на те саме місце. Замініть виклик вручну або попросіть помічника підібрати аналог.
  • Багаторядкові рядки, імпорт чужих бібліотек, експорт функцій. Конвертер переносить те, що може записати, і позначає решту.
  • Більше трьох ліній. Панель графіка малює тільки перші три plot скрипта. Зайві ряди рознесіть по окремих скриптах.
  • Реальна торгівля. Оголошення strategy(…) переноситься, але стратегія LootScript торгує тільки в тестері стратегій — на симульованому рахунку.

Далі

https://docs.lootx.trade/uk/loot/pine-import

Справочник

11Помилки компіляції та виконання

Усі коди LS, які показує редактор і графік LootScript: текст повідомлення, причина та спосіб виправлення, часті помилки з прикладами, межі виконання й випадки, коли замість помилки виходить na.

Кожне повідомлення компілятора й виконувача LootScript починається з коду виду LS2008. Код не змінюється між версіями і не залежить від мови інтерфейсу, тому за ним зручно шукати: тут зібрані всі коди, які може показати термінал, з текстом повідомлення, причиною та способом виправлення.

Повідомлення виводяться російською, якщо інтерфейс терміналу російською, і англійською на будь-якій іншій мові. Спочатку — помилки, які трапляються найчастіше, потім помилки виконання і повна таблиця.

Де видно помилки

При компіляції. Редактор компілює скрипт при кожній паузі набору. Знайдене потрапляє у вкладку «Проблеми» у нижній частині редактора: код, текст і позиція виду «Рядок 6:6». Подвійний клік по рядку переводить курсор до місця помилки. У заголовку редактора відображається підсумок: «ок · 12 мс», «попереджень: 2» або «помилок: 1».

При виконанні. Скрипт без помилок компіляції може зупинитися на якомусь барі: закінчився бюджет операцій, індекс вийшов за межі масиву, невідомий інструмент. Тоді у вкладці «Вивід» з’явиться рядок «Скрипт зупинено: LS6004: …», а у вікні тестера стратегій — та сама причина. Інші скрипти, панелі й сам термінал продовжують працювати.

Діагностики бувають трьох рівнів:

Рівень Що означає Що з графіком
Помилка Скрипт не зібраний На графік не додається: «Скрипт з помилками на графік не кладёться — див. вкладку «Проблеми»». Якщо скрипт уже на графіках, там залишається попередня робоча версія
Попередження Скрипт зібраний, але результат може вводити в оману: наприклад, перемальовується на живому барі Скрипт працює
Зведення Скрипт зібраний, але якась його налаштування нічого не робить Скрипт працює

Як влаштовані коди

Коди Етап Про що
LS0001–LS0009 Читання тексту Символи, рядки, числа, кольори, директива #version
LS1000–LS1012 Розбір Дужки, блоки, порядок операторів, оголошення скрипта
LS2000–LS2030 Типи й імена Невідомі імена, типи, аргументи, na
LS3000–LS3033 Зміст програми ta.* у гілках, рекурсія, стратегії, бібліотеки, request.security
LS4000–LS4009 Межі компіляції Надто багато рядів, виводів, викликів
LS5000–LS5013 Перемальовування і чесність тесту Значення, які на історії виглядають інакше, ніж у живому режимі
LS6000–LS6036 Виконання Бюджети, індекси, колекції, рядки, об’єкти малювання
LS0999 Внутрішній збій Дефект компілятора — про нього потрібно повідомити

Часті помилки компіляції

LS1009 — немає оголошення скрипта

«Немає оголошення скрипта — почніть з indicator(“Назва”)». Першим оператором файлу має стояти indicator(...), strategy(...) або library(...). Та сама помилка з’являється, якщо оголошення є, але вище нього щось написано. Коментарі й директива #version 1 не заважають.

Loot
// Так не можна: оголошення не перше
len = input.int(14, "Довжина")
indicator("RSI")
Loot
indicator("RSI")
len = input.int(14, "Довжина")

Друге оголошення в тому ж файлі дає LS1008: у скрипта воно одне.

LS2002 — невідоме ім’я

«Невідоме ім’я «…» — перевірте написання або оголосіть його вище». Найчастіше це опечатка або функція без простору імен: всі індикаторні функції в ta, математика — в math, кольори — в color.

Loot
avg = sma(close, 20)
Loot
avg = ta.sma(close, 20)

Та сама помилка буде, якщо змінну читають раніше рядка, де її оголосили. Повний список імен — у довіднику функцій.

LS2008 — порівняння з na

«Порівняння з na завжди хибне — використовуйте na(x)». Будь‑яке порівняння з na, включно з == і !=, дає false, тому компілятор таку запис не пропустить.

Loot
x = ta.sma(close, 50)
plot(x == na ? close : x)
Loot
x = ta.sma(close, 50)
plot(na(x) ? close : x)

Коротше те саме пишеться через ??: plot(x ?? close).

LS2014 — значення змінюється від бару до бару там, де потрібна константа

««…» в «…» вимагає значення не слабшого за input, а передано series — візьміть input.*(…) або літерал». Довжина вікна ta.* має бути відома до першого бару. Довжина, яку вибирають за умовою на кожному барі, не підходить.

Loot
len = close > open ? 10 : 20
avg = ta.sma(close, len)

Порахуйте обидва варіанти і вибирайте результат, а не довжину:

Loot
fast = ta.sma(close, 10)
slow = ta.sma(close, 20)
avg  = close > open ? fast : slow

Якщо довжину має задавати користувач, візьміть її з input.int(...).

LS3004 — виклик ta.* залежить від змінної з гілки

«Аргумент «…» не можна обчислити поза гілкою — винесіть виклик ta.* на верхній рівень». Функції ta.* пам’ятають попередні бари, тому компілятор обчислює їх на кожному барі, навіть якщо виклик написаний всередині if. Якщо аргумент оголошено лише всередині гілки, на інших барах його просто нема.

Loot
var float avgBody = na
if close > open {
    body = close - open
    avgBody := ta.sma(body, 10)
}
Loot
body    = close - open
avgBody = ta.sma(body, 10)

LS2017, LS2007, LS1006 — рядки, умови й порівняння

У цих трьох помилок спільна причина: LootScript не приводить типи мовчки.

Код Повідомлення Як виправити
LS2017 «Рядок не можна додавати до числа (… + …) — використовуйте str.tostring(…)» "RSI " + str.tostring(r) замість "RSI " + r
LS2007 «Умова має бути bool, а тут …» if volume > 0 замість if volume — числа не мають істинності
LS1006 «Порівняння не ланцюжаться — напишіть a < b and b < c» low < close and close < high замість low < close < high

LS2018 і LS2019 — ім’я вже зайнято

««…» вже оголошено в цій області» (LS2018) — змінну оголосили вдруге через =. Щоб змінити значення, використовуйте :=.

Loot
level = high
level := low

««…» затемнює вбудоване ім’я — оберіть інше» (LS2019) — змінна, функція чи тип названі так само, як вбудований ряд чи функція: close, time, hour, volume. Перейменуйте: startHour замість hour. Імена просторів на кшталт color або position для змінних можна використовувати.

LS2004 і LS2005 — аргументи виклику

««…» очікує … аргумент(ів), а передано …» (LS2004) і «У «…» немає параметра «…»» (LS2005). Звірте виклик із сигнатурою в довіднику: імена параметрів пишуться точно так, як там вказано.

Loot
plot(close, colour = color.red)
Loot
plot(close, color = color.red)

LS3011 і LS5011 — стратегії

«strategy.* доступно лише в strategy(…)» (LS3011): заявки і стан позиції є тільки у скрипта, оголошеного через strategy(...). Замініть indicator("…") на strategy("…").

«Стратегія читає «…»: у біржового стакана і стрічки угод немає історії, бектест був би фікцією» (LS5011): стратегія перевіряється на історії, а у book.* і tape.* історії нема — на кожному минулому барі там na.

Loot
strategy("Перекіс стакана")
if book.imbalance(10) > 0.5 {
    strategy.entry("L", strategy.long)
}

Для історії стакана є простір depth: там, де стакан записано, воно дає значення на кожному барі.

Loot
strategy("Перекіс стакана")
if depth.imbalance(1.0) > 0.5 {
    strategy.entry("L", strategy.long)
}

LS5000–LS5006 — попередження про перемальовування

Ці попередження не заважають скрипту працювати. Вони кажуть, що лінія на історії виглядатиме інакше, ніж її бачили вживу:

  • LS5001 — на графік доходить значення, яке є лише на живому барі (barstate.isrealtime, barstate.isnew).
  • LS5000 — на графік доходить змінна varip: вона накопичує тики живого бара, яких в історії нема.
  • LS5006 — на графік доходять book.* або tape.*: на історії ряд пустий.
  • LS5003 — значення старшого таймфрейму з request.security без [1]: незакритий бар ще зміниться.
  • LS5002 — lookahead = true в request.security: на історії скрипт бачить майбутнє.
  • LS5005 — на графік доходить math.random або timenow: два прогони дадуть різні лінії.

Якщо так і задумано — наприклад, індикатор потрібен лише для живої торгівлі — попередження можна залишити.

LS3016 — налаштування прийнята і нічого не робить

Це зведення, а не помилка. Воно трапляється в скриптах, перенесених з інших платформ: параметр існує для сумісності, але в терміналі на нього нічого не впливає. Друга частина повідомлення пояснює чому.

Що написано Пояснення в повідомленні
maxBarsBack в оголошенні історія завантажується колонкою цілком
format, precision, scale в оголошенні шкалою значень і її форматом керує термінал
timeframe в оголошенні скрипт рахується на таймфреймі графіка, інший дає request.security
Товщина, стиль або інша налаштування виводу, задана виразом, а не константою (колір plot та відміток може змінюватися по барам) ця збірка читає таку налаштування лише як константу
color у четвертого і наступних plot панель малює тільки перші три ряди
location.absolute у plotshape або plotchar у відмітки немає ряду, до значення якого її можна притиснути
display, якого у ряду немає у цього ряду немає такої поверхні

Помилки виконання

Помилка виконання зупиняє скрипт на тому барі, де вона трапилася. Текст з’являється у вкладці «Вивід» у вигляді «Скрипт зупинено: LS6004: …».

LS6004 і LS6005 — скрипт працює занадто довго

«Скрипт вичерпав бюджет операцій на бар — спростіть цикл» (LS6004) і «Скрипт перевищив ліміт часу на проходження» (LS6005). На кожному барі є бюджет у 2 000 000 операцій. Час теж обмежено: весь прогін по історії — 2 секунди, один тік живого бара — 20 мс. Майже завжди причина — цикл, який не завершується або обходить забагато даних на кожному барі.

Loot
var int n = 0
i = 0
while i < 10 {
    n := n + 1
}
Loot
var int n = 0
i = 0
while i < 10 {
    n := n + 1
    i := i + 1
}

LS6002 і LS5004 — читання майбутнього

Індекс історії x[n] не може бути від’ємним: close[-1] означав би наступний бар. Якщо від’ємне число написано прямо в тексті, компілятор зупинить його відразу (LS5004). Якщо воно вийшло при обчисленні, скрипт зупиниться на барі з помилкою «Від’ємне зміщення історії — читати майбутнє не можна» (LS6002). Індекс, більший за число завантажених барів, помилкою не вважається — він дає na.

LS6001, LS6007, LS6019 — колекції й об’єкти

  • LS6001 «Індекс … поза межами» — array.get, array.set або matrix.get поза розміром. Перевіряйте array.size(a) перед зверненням.
  • LS6007 «Звернення до порожнього об’єкта (na)» — колекцію оголосили, але не створили: var array<float> a = na, а потім a.push(x). Створіть її через array.new<float>().
  • LS6019 «Об’єкт малювання вже видалено або витіснено по стелі — створіть його заново». Одночасно живе 500 об’єктів одного виду, найстаріший витісняється. Підніміть ліміт через maxLinesCount, maxLabelsCount або maxBoxesCount в оголошенні або пере використайте об’єкт через set_*.

LS6017 і LS6018 — інструмент і таймфрейм у request.security

«Символ «…» невідомий — перевірте формат «МАЙДАНЧИК:СИМВОЛ» або задайте ignore_invalid_symbol = true» (LS6017) і «Таймфрейм «…» не розбирається — очікується «5», «60», «4h», «1D», «1W»» (LS6018). З ignore_invalid_symbol = true невідомий інструмент дає na замість зупинки.

Межі виконання

Що обмежено Межа Код при перевищенні
Операцій на бар 2 000 000 LS6004
Час проходу по історії / тика живого бара 2 с / 20 мс LS6005
Елементів масиву 100 000 LS6003
Пар у словнику 50 000 LS6003
Елементів матриці 1 000 000 LS6003
Довжина вікна ta.* 100 000 барів LS6034
Довжина одного рядка 100 000 символів LS6014
Ячейок у таблиці 2000 LS6029
Слойів теплового поля 4 (від 0 до 3) LS6036
Об’єктів малювання одного виду 500 за замовчуванням старі витісняються
Різних пар «інструмент + таймфрейм» у request.security 8 —
Викликів request.security 32 LS4009 при компіляції

Коли помилки немає, але значення відсутнє

Багато ситуацій, які в інших мовах зламали б програму, в LootScript дають na — пропуск на графіку, а не зупинку:

  • арифметика з na дає na: close - x при порожньому x — теж порожньо;
  • x[n] глибше за початок історії — na;
  • цілочисельний поділ на нуль — na, а дробовий поділ на нуль скрипт не зупиняє;
  • book.*, tape.* і screener.* на історичних барах — na;
  • кластери, дельта, відкритий інтерес і історія біржового стакана — na на барах, де даних нема. Перевіряйте cluster.available, delta.available і суміжні прапорці;
  • ta.* на перших барах, поки вікно не заповнилося, — na.

na на графіку ніколи не малюється нулем: лінія переривається. Щоб підставити значення, використовуйте nz(x), x ?? запасне або fixnan(x).

Усі коди

LS0001–LS0009 і LS0999 — читання тексту

Код Повідомлення Що робити
LS0001 Неочікуваний символ «…» Приберіть символ, якого немає в мові
LS0002 Рядок не закрито — додайте закриваючу лапку до кінця рядка Закрийте лапку на тій же стрічці
LS0003 Блочний коментар не закрито — додайте */ Закрийте /* … */
LS0004 Невідома escape-послідовність «…» у рядку Допустимі \n, \r, \t, \0, \\, \", \' і \u{…}; одиночну \ подвоїте
LS0005 Невірний числовий літерал «…» Перевірте запис числа
LS0006 Число «…» не вміщується в тип Зменшіть число
LS0007 Невірний літерал кольору «…» — очікується #RRGGBB або #RRGGBBAA Шість або вісім шістнадцяткових цифр
LS0008 Роздільник розрядів «_» стоїть на початку, наприкінці або подвоєний Пишіть 1_000_000
LS0009 Невірна директива версії — очікується #version <число> першою рядком #version 1 у першому рядку
LS0999 Компілятор не впорався з цим файлом — це дефект збірки, повідомте про нього Повідомте в підтримку, додайте скрипт

LS1000–LS1012 — розбір

Код Повідомлення Що робити
LS1000 Неочікувано: … Перевірте рядок на зайві символи
LS1001 Очікувалося «…», а зустрілося … Найчастіше не закрито дужку
LS1002 Очікувалося вираження, а зустрілося … Після оператора або коми бракує значення
LS1004 Очікувалося ім’я, а зустрілося … Після var, func, . потрібно ім’я
LS1005 Очікувався блок в фігурних дужках, а зустрілося … Додайте { … }
LS1006 Порівняння не ланцюжаться — напишіть a < b and b < c Розбийте на два порівняння через and
LS1008 Друге оголошення скрипта — у скрипта може бути тільки одне Залиште одне оголошення
LS1009 Немає оголошення скрипта — почніть з indicator(“Назва”) Першим рядком — indicator, strategy або library
LS1010 Занадто глибока вкладеність (більше 64) — винесіть частину в функцію Розбийте вираз або блок
LS1012 Тіло if / for / while пишеться в фігурних дужках: if cond { … } Додайте фігурні дужки

LS2000–LS2030 — типи і імена

Код Повідомлення Що робити
LS2000 Невідповідність типів: очікувався …, а отримано … Передайте значення потрібного типу
LS2001 Немає перетворення … в … Перетворіть явно: str.tostring, math.round
LS2002 Невідоме ім’я «…» — перевірте написання або оголосіть його вище Виправте опечатку, додайте простір (ta.), оголосіть вище
LS2003 «…» — не функція, викликати не можна Приберіть дужки: це ряд або константа
LS2004 «…» очікує … аргумент(ів), а передано … Звірте число аргументів зі довідником
LS2005 У «…» немає параметра «…» Виправте ім’я параметра
LS2006 Аргумент «…» передано двічі Приберіть повтор
LS2007 Умова має бути bool, а тут … Порівняйте явно: x > 0, not na(x)
LS2008 Порівняння з na завжди хибне — використовуйте na(x) na(x) замість x == na
LS2014 «…» в «…» вимагає значення не слабшого за …, а передано … — візьміть input.*(…) або літерал Літерал, input.* або константа замість ряду
LS2015 «…» оголошено константою — присвоювати не можна; оголосіть через var Налаштування input.*, змінну циклу і параметр функції змінювати не можна — скопіюйте значення в свою змінну
LS2017 Рядок не можна додавати до числа (… + …) — використовуйте str.tostring(…) str.tostring або str.format
LS2018 «…» вже оголошено в цій області := для нового значення або інше ім’я
LS2019 «…» затемнює вбудоване ім’я — виберіть інше Перейменуйте
LS2020 Гілки дають різні типи: … і … Приведіть гілки до одного типу
LS2021 switch без гілки за замовчуванням «=> …» — додайте її Додайте => значення
LS2022 У «…» не виведено тип елемента — вкажіть його: … array.new<float>()
LS2028 У поля «…» типу «…» не вказано тип — напишіть його перед іменем: float … float price в оголошенні type
LS2029 export «…»: у експортованої функції мають бути вказані типи всіх параметрів і тип результату Вкажіть типи
LS2030 «…» в «…» читається до першого бару — потрібен літерал або іменована константа В оголошенні — лише постійні значення

LS3000–LS3033 — зміст програми

Код Повідомлення Що робити
LS3002 «…» викликає саму себе — рекурсія в LootScript заборонена Замініть рекурсію циклом
LS3003 Взаємна рекурсія заборонена: … Розірвіть коло викликів
LS3004 Аргумент «…» не можна обчислити поза гілкою — винесіть виклик ta.* на верхній рівень Обчисліть аргумент і виклик поза if
LS3006 «…» затемнює ім’я з зовнішньої області (попередження) Перейменуйте внутрішню змінну
LS3007 «…» поза циклом break і continue — тільки в циклі
LS3008 return поза функцією return — тільки в тілі функції
LS3009 export «…» можливий тільки в library(…) Приберіть export або зробіть файл бібліотекою
LS3010 «…» без жодного рівня (profit/loss/stop/limit/trail) — порожня операція (попередження) Задайте стоп, тейк або трейлінг
LS3011 strategy.* доступно тільки в strategy(…) Оголосіть скрипт через strategy(...)
LS3012 У бібліотеці не можна малювати і оголошувати входи: … Перенесіть вивід і налаштування в індикатор
LS3013 «…» всередині request.security не стане рядком налаштувань — оголосіть вхід вище і передайте його значення Оголосіть input.* вище і передайте змінну
LS3016 Налаштування «…» прийнята і нічого не робить: … (зведення) Можна залишити або видалити
LS3018 Бібліотека «…» не знайдена в папці бібліотек — ім’я береться з її library(“…”, N), а не з імені файлу Перевірте ім’я в оголошенні бібліотеки
LS3019 Бібліотеки «…» версії … немає; встановлені: … Вкажіть встановлену версію
LS3020 «…» всередині request.security: у біржового стакана і стрічки угод немає історії на чужій серії Приберіть book.*, tape.* з виразу
LS3025 Функція «…» оголошена, але не викликається — її тіло перевірено лише пробно (попередження) Викличіть функцію або видаліть
LS3026 «…» вимагає стоп, від якого рахувати розмір: loss/stop у вході або в strategy.exit Додайте стоп до входу або strategy.exit
LS3028 Ця збірка не підтримує: … Перепишіть без цієї конструкції
LS3029 Ветка switch для «…» повторюється — друга недосяжна Приберіть повтор
LS3030 «…» — змінна графіка, а вираз request.security рахується на іншій серії; передайте значення через input.* або порахуйте його в середині виразу Пообчислюйте всередині виразу
LS3031 Бібліотеки імпортують одна одну по колу: … Розірвіть коло імпортів
LS3032 У бібліотеці «…» допустимі тільки оголошення функцій і імпорти — тут … Приберіть інший код з бібліотеки
LS3033 Бібліотека «…» не компілюється (…) — відкрийте її в редакторі і виправте Виправте помилку в самій бібліотеці

LS4000–LS4009 — межі компіляції

Код Повідомлення Що робити
LS4000 Забагато рядів: … при ліміті 512 — приберіть зайві ta.* або пере використайте змінні Скоротіть число викликів ta.* і змінних з історією
LS4001 Програма надто велика (більше 4096 вбудувань) — спростіть функції Зменшіть число викликів користувацьких функцій
LS4002 Забагато plot — панель малює не більше трьох рядів Виводів — рядів plot, відміток plotshape і plotchar, фону bgcolor — не більше 64; малюються перші три plot
LS4009 Забагато викликів request.security: …, ліміт 32 Об’єднайте виклики

LS5000–LS5013 — перерисовка і тестер

Код Повідомлення Що робити
LS5000 Значення varip доходить до виводу — на історії воно буде іншим (перемальовування) (попередження) Використайте var, якщо потрібна однакова історія
LS5001 Значення лише живого бара доходить до виводу — на історії його нема (перемальовування) (попередження) Використайте barstate.isconfirmed
LS5002 lookahead = true читає майбутнє — на історії результат недосяжний у реальному часі (попередження) Приберіть lookahead = true
LS5003 Старший таймфрейм без зсуву — незакритий бар перемалюється; додайте [1] (попередження) request.security(…, close[1])
LS5004 Від’ємне зміщення зсуває вивід у минуле — на історії лінія знає майбутнє Приберіть від’ємний індекс x[-n]
LS5005 Недіетерміноване значення доходить до виводу — два прогони дадуть різний ряд (попередження) Не виводьте math.random і timenow на графік
LS5006 Дані є лише в реальному часі — на історії ряд пустий (попередження) Для історії біржового стакана використайте depth.*
LS5011 Стратегія читає «…»: у біржового стакана і стрічки угод немає історії, бектест був би фікцією Приберіть book.*, tape.* зі стратегії
LS5012 Стратегія заглядає вперед («…») — звіт позначено як недосяжний у реальному часі (попередження) Приберіть lookahead = true
LS5013 «…» увімкнено: заявки виконуються по закриттю бара, звіт позначено (зведення) Приберіть processOrdersOnClose, якщо потрібен реалістичний звіт

LS6000–LS6036 — виконання

Код Повідомлення Що робити
LS6001 Індекс … поза межами Перевірте розмір колекції перед зверненням
LS6002 Від’ємне зміщення історії — читати майбутнє не можна Індекс історії має бути ≥ 0
LS6003 Перевищено ліміт розміру колекції (…) — колекція створена в рядку … Обмежте ріст: видаляйте старі елементи
LS6004 Скрипт вичерпав бюджет операцій на бар — спростіть цикл Перевірте умову виходу з циклу
LS6005 Скрипт перевищив ліміт часу на проходження Зменшіть роботу на кожному барі
LS6007 Звернення до порожнього об’єкта (na) Створіть колекцію або об’єкт до звернення
LS6014 Рядок довший за ліміт у 100000 знаків — скоротіть її або збирайте по частинах Скоротіть рядок
LS6015 Невідомий часовий пояс «…» — потрібен ідентифікатор IANA, наприклад «Europe/Berlin» Пояс у форматі IANA
LS6017 Символ «…» невідомий — перевірте формат «МАЙДАНЧИК:СИМВОЛ» або задайте ignore_invalid_symbol = true Виправте символ
LS6018 Таймфрейм «…» не розбирається — очікується «5», «60», «4h», «1D», «1W» Виправте таймфрейм
LS6019 Об’єкт малювання вже видалено або витіснено по стелі — створіть його заново Перевіряйте об’єкт або підніміть ліміт
LS6020 str.format: плейсхолдеру {…} не передано аргумент Передайте аргумент для кожного {n}
LS6021 str.match: шаблон вичерпав бюджет кроків — спростіть його Спростіть регулярний вираз
LS6026 Вичерпано загальний бюджет колекцій скрипта (… ячеєк) — не влізла колекція з рядка … Скоротіть число або розмір колекцій
LS6027 Недопустимий аргумент «…» в … Наприклад, від’ємний розмір в array.new
LS6028 Вичерпано бюджет рядків скрипта (…) — пере використайте рядки замість нових на кожному барі Не збирайте нові рядки на кожному барі
LS6029 У таблиці більше 2000 ячеєк — це ліміт панелі Зменшіть таблицю
LS6030 Ячейка таблиці поза сіткою: … Номер стовпця і рядка — у межах розміру таблиці
LS6031 Вбудована функція «…» оголошена, але не реалізована — це дефект збірки, повідомте про нього Повідомте в підтримку
LS6032 Хендл не вказує на об’єкт потрібного виду — об’єкт звільнено або хендл з іншого прогона Не зберігайте посилання на видалені об’єкти
LS6033 Поле … поза оголошенням типу «…» — це дефект збірки, повідомте про нього Повідомте в підтримку
LS6034 Довжина вікна … більша за ліміт 100000 — таке вікно не поміститься в пам’ять Зменшіть довжину вікна
LS6035 Крок циклу дорівнює нулю — лічильник не зрушує, і кінець недосяжний by у циклі for не може бути нулем
LS6036 Слой тепла … поза 0…3 layer від 0 до 3
Коди, які ця версія не видає

Ці номери закріплені в мові, але поточна версія терміналу їх не показує: LS1003, LS1007, LS1011, LS2016, LS3000, LS3001, LS3005, LS4003, LS4004, LS5007, LS6000, LS6006, LS6008, LS6022, LS6023. Наприклад, оголошення не першою рядком зараз повідомляється як LS1009, а ділення на нуль не зупиняє скрипт з LS6000.

Далі

https://docs.lootx.trade/uk/loot/errors

Справочник

12Приклади скриптів

Вісім готових скриптів на LootScript: ковзні, RSI, VWAP зі смугами відхилень, кумулятивна дельта з розбіжностями, відкритий інтерес, ставка фінансування, дисбаланси кластерів і стратегія для тестера.

Вісім готових скриптів на LootScript: від ковзних і RSI до кумулятивної дельти, відкритого інтересу, ставки фінансування і кластерів. Кожен — робочий індикатор, який можна відразу додати на графік і підлаштувати під себе. Усі приклади збираються компілятором поточної версії без помилок і попереджень.

Як запустити приклад

  1. Натисніть ƒ на панелі графіка, у вікні Індикатори — Редактор….
  2. У редакторі натисніть Новий (Ctrl+N), замініть шаблон кодом прикладу і натисніть Зберегти.
  3. Натисніть Додати на графік (Ctrl+Enter). Налаштування з input.* з’являться у вікні налаштувань індикатора.

1. Три ковзні з вибором типу

Швидка, середня і повільна середні одного типу на вибір. Фон підсвічується, коли всі три вибудувалися за трендом.

Loot
indicator("Три скользящие", shortTitle = "MA×3", overlay = true)
maType = input.string("EMA", "Тип средней", options = ["EMA", "SMA", "WMA", "HMA"])
src    = input.source(close, "Источник")
len1   = input.int(20, "Быстрая", minval = 1)
len2   = input.int(50, "Средняя", minval = 1)
len3   = input.int(200, "Медленная", minval = 1)

func ma(s, len) => switch maType {
    "SMA" => ta.sma(s, len)
    "WMA" => ta.wma(s, len)
    "HMA" => ta.hma(s, len)
    => ta.ema(s, len)
}

m1 = ma(src, len1)
m2 = ma(src, len2)
m3 = ma(src, len3)

plot(m1, "Быстрая", color = m1 >= m1[1] ? color.teal : color.red, linewidth = 2)
plot(m2, "Средняя", color = color.orange)
plot(m3, "Медленная", color = color.gray, linewidth = 2)
bgcolor(m1 > m2 and m2 > m3 ? color.new(color.teal, 20) : m1 < m2 and m2 < m3 ? color.new(color.red, 20) : na)

Як влаштовано

  • input.string з options перетворюється на випадаючий список у налаштуваннях.
  • Функція ma вибирає середню через switch. Стан ta.* живе в кожному місці виклику, тому три виклики ma — три незалежні середні.
  • Колір швидкої лінії — вираз: зростає порівняно з попередньою свічкою (m1[1]) — бірюзова, падає — червона.
  • Панель малює до трьох ліній plot на скрипт — тому середніх три.

2. RSI з зонами і сповіщеннями

RSI із зафарбованою смугою між рівнями. Лінія й фон фарбуються, коли RSI у зоні перекупленості або перепроданості.

Loot
indicator("RSI с зонами", shortTitle = "RSI", overlay = false)
len = input.int(14, "Период", minval = 2)
src = input.source(close, "Источник")
ob  = input.float(70, "Перекупленность", minval = 50, maxval = 100)
os  = input.float(30, "Перепроданность", minval = 0, maxval = 50)

r = ta.rsi(src, len)

hOb = hline(ob, "Перекупленность", color = color.red)
hOs = hline(os, "Перепроданность", color = color.teal)
fill(hOb, hOs, color = color.new(color.purple, 20))
plot(r, "RSI", color = r > ob ? color.red : r < os ? color.teal : color.purple, linewidth = 2)
bgcolor(r > ob ? color.new(color.red, 35) : r < os ? color.new(color.teal, 35) : na)

alertcondition(ta.crossunder(r, ob), "RSI вышел из перекупленности", "RSI опустился ниже верхнего уровня")
alertcondition(ta.crossover(r, os), "RSI вышел из перепроданности", "RSI поднялся выше нижнего уровня")

Як влаштовано

  • hline повертає ручку рівня, а fill зафарбовує смугу між двома ручками.
  • Рівні — налаштування input.float, тому лінії й заливка рухаються разом із ними.
  • alertcondition оголошує два сповіщення. Самі по собі вони не дзвонять — як їх ввімкнути, описано на сторінці Алерти зі скриптів.
  • Альфа в color.new — від 0 (прозоро) до 255 (непрозоро).

3. VWAP дня зі смугами відхилення

Зважена по обсягу ціна з початку доби за UTC і смуга ±σ навколо неї.

Loot
indicator("VWAP дня с полосами", shortTitle = "VWAP", overlay = true)
src  = input.source(hlc3, "Цена")
mult = input.float(1.0, "Ширина полосы, σ", minval = 0.1, step = 0.1)

anchor = session.isfirstbar
vw = ta.vwap(src, anchor)

// Сумма объёма и сумма объёма на квадрат цены с начала дня — для разброса вокруг VWAP.
var float sumV  = 0.0
var float sumV2 = 0.0
if anchor {
    sumV  := 0.0
    sumV2 := 0.0
}
if not na(volume) and not na(src) {
    sumV  := sumV + volume
    sumV2 := sumV2 + volume * src * src
}
sigma = sumV > 0 and not na(vw) ? math.sqrt(math.max(sumV2 / sumV - vw * vw, 0)) : na

pUp = plot(vw + mult * sigma, "Верх", color = color.new(color.blue, 150))
plot(vw, "VWAP", color = color.blue, linewidth = 2)
pDn = plot(vw - mult * sigma, "Низ", color = color.new(color.blue, 150))
fill(pUp, pDn, color = color.new(color.blue, 25))

Як влаштовано

  • ta.vwap починає рахунок заново на барі, де якір істинний. Для криптовалют session.isfirstbar — перший бар після 00:00 UTC.
  • Змінні var переживають перехід між барами. Їх обнуляє той самий якір, тому смуга рахується за той самий період, що й VWAP.
  • Розкид — корінь із середньозваженого квадрата ціни мінус квадрат VWAP. math.max(…, 0) захищає від крихітного мінуса через округлення.
  • Має сенс на внутріденних таймфреймах. Хочете VWAP від останньої виплати ставки фінансування — поставте anchor = funding.settled.

4. Добова кумулятивна дельта з розбіжностями

Кумулятивна дельта, яка обнуляється щодня, і позначки на барах, де ціна оновила екстремум, а дельта — ні.

Loot
indicator("Дневная кумдельта с расхождениями", shortTitle = "CVD", overlay = false)
len = input.int(20, "Окно поиска максимумов", minval = 3)

var float cvd = 0.0
if session.isfirstbar {
    cvd := 0.0
}
if delta.available {
    cvd := cvd + delta.value
}
cvdLine = delta.available ? cvd : na

// Цена обновила максимум окна, а кумдельта — нет: покупатели не подтверждают рост.
bearish = high >= ta.highest(high, len) and cvdLine < ta.highest(cvdLine, len)
bullish = low <= ta.lowest(low, len) and cvdLine > ta.lowest(cvdLine, len)

plot(cvdLine, "Кумдельта", color = cvdLine >= 0 ? color.teal : color.red, linewidth = 2)
hline(0, "Ноль", color = color.gray)
plotshape(bearish, "Медвежье расхождение", style = shape.triangledown, location = location.top, color = color.red, size = size.tiny)
plotshape(bullish, "Бычье расхождение", style = shape.triangleup, location = location.bottom, color = color.teal, size = size.tiny)

Як влаштовано

  • delta.value — агресивні покупки мінус агресивні продажі за бар. Там, де покриття немає, delta.available хибне, і лінія переривається, а не малює нуль.
  • Накопичувач var обнуляється на початку доби. Потрібна кумдельта по всій завантаженій історії без скидання — візьміть готовий ряд delta.cum.
  • Розбіжність: ціна на максимумі вікна, а кумдельта нижча свого максимуму за те саме вікно. Для мінімумів — дзеркально.
  • location.top і location.bottom ставлять позначки на краях підвікна, а не біля ціни.

5. Сплески відкритого інтересу

Зміна відкритого інтересу від бару до бару у відсотках і помітки там, де вона вибивається з звичайного розкиду.

Loot
indicator("Изменение открытого интереса", shortTitle = "ΔOI %", overlay = false)
len = input.int(50, "Окно для всплесков", minval = 5)
k   = input.float(3.0, "Порог всплеска, σ", minval = 0.5, step = 0.5)

pct = oi.available and oi.close[1] > 0 ? 100 * (oi.close - oi.close[1]) / oi.close[1] : na
sd  = ta.stdev(pct, len)
spike = not na(sd) and math.abs(pct) > k * sd

plot(pct, "ΔOI, %", style = plot.style_columns, color = pct >= 0 ? color.teal : color.red)
hline(0, "Ноль", color = color.gray)
plotshape(spike, "Всплеск", style = shape.circle, location = location.top, color = color.orange, size = size.tiny)

Як влаштовано

  • oi.close — відкритий інтерес на закритті бара, oi.close[1] — на попередньому барі. Перевірка oi.available не дає порахувати зміну з пустоти.
  • Сплеск — бар, де зміна по модулю більша за k стандартних відхилень за вікно len.
  • Відкритий інтерес приходить поминутно. На таймфреймах менше хвилини сусідні бари повторюють одне значення, і зміна там нульова — це дані, а не помилка.

6. Ставка фінансування

Ставка фінансування безстрокового ф’ючерса у відсотках за період або перерахована на рік, з позначками виплат і підсвіткою високої ставки.

Loot
indicator("Ставка финансирования", shortTitle = "Funding", overlay = false)
mode = input.string("За период", "Показывать", options = ["За период", "Годовых"])
thr  = input.float(0.05, "Порог, %", minval = 0.0, step = 0.01)

perPeriod = funding.rate * 100
periodsPerYear = funding.interval_hours > 0 ? 24.0 / funding.interval_hours * 365 : na
value = mode == "Годовых" ? perPeriod * periodsPerYear : perPeriod
level = mode == "Годовых" ? thr * periodsPerYear : thr

plot(value, "Ставка, %", style = plot.style_columns, color = value >= 0 ? color.teal : color.red)
hline(0, "Ноль", color = color.gray)
plotshape(funding.settled, "Выплата", style = shape.circle, location = location.bottom, color = color.gray, size = size.tiny)
bgcolor(math.abs(value) > level ? color.new(color.orange, 30) : na)

Як влаштовано

  • funding.rate — доля, а не відсотки: 0.0001 — це 0,01 %. Тому ставку множать на 100.
  • Для річних значень ставка множиться на число виплат у році. 24.0 записано дробом навмисно: ділення двох цілих у LootScript відкидає залишок.
  • funding.settled істинно на барі, де пройшла виплата — там унизу ставиться точка.
  • Поріг задається за період і для річних перераховується тим самим множником.

7. Дисбаланси в кластерах

Позначки на графіку ціни там, де в кластерах бара стоїть «драбинка» дисбалансів або їх просто багато, плюс рівень максимального обсягу (POC) кожного бара.

Loot
indicator("Дисбалансы кластеров", shortTitle = "Imbalance", overlay = true)
minSteps = input.int(3, "Уровней подряд", minval = 2)
minCount = input.int(5, "Дисбалансов в баре", minval = 1)

levels = cluster.available ? cluster.levels : 0
buys  = 0
sells = 0
for i in 0 .. levels {
    side = cluster.imbalance(i)
    if side == 1 {
        buys := buys + 1
    } else if side == -1 {
        sells := sells + 1
    }
}

plot(cluster.poc, "POC", style = plot.style_circles, color = color.orange)
plotshape(cluster.stacked_buy_steps >= minSteps, "Лесенка покупок", style = shape.triangleup, location = location.belowbar, color = color.teal, size = size.small)
plotshape(cluster.stacked_sell_steps >= minSteps, "Лесенка продаж", style = shape.triangledown, location = location.abovebar, color = color.red, size = size.small)
plotshape(buys >= minCount, "Много дисбалансов покупок", style = shape.circle, location = location.belowbar, color = color.new(color.teal, 120), size = size.tiny)
plotshape(sells >= minCount, "Много дисбалансов продаж", style = shape.circle, location = location.abovebar, color = color.new(color.red, 120), size = size.tiny)

Як влаштовано

  • cluster.imbalance(i) повертає +1, −1 або 0 для цінового рівня i. Поріг дисбалансу береться з налаштувань кластерного графіка, тому скрипт бачить те саме, що й ви.
  • cluster.stacked_buy_steps — скільки рівнів підряд іде дисбаланс покупок. Цикл for i in 0 .. levels рахує всі дисбаланси бара, не тільки підрядні.
  • Скрипт сам підписується на кластери і працює на звичайному свічковому графіку. На біржі без покриття і на таймфреймах менше 30 секунд або більше доби кластерів немає — тоді levels дорівнює 0 і позначок не буде.

8. Стратегія: перетин EMA зі стопом за ATR

Вхід у лонг на перетині середніх, стоп і ціль — у частках ATR, вихід — по зворотному перетину.

Loot
strategy("EMA-кросс со стопом по ATR", overlay = true, initialCapital = 10000,
         defaultQtyType = strategy.qty.percent_of_equity, defaultQtyValue = 10,
         slippageTicks = 2)
fastLen = input.int(12, "Быстрая EMA", minval = 1)
slowLen = input.int(26, "Медленная EMA", minval = 2)
atrLen  = input.int(14, "Период ATR", minval = 1)
stopK   = input.float(1.5, "Стоп, в ATR", minval = 0.1, step = 0.1)
takeK   = input.float(3.0, "Цель, в ATR", minval = 0.1, step = 0.1)

fast = ta.ema(close, fastLen)
slow = ta.ema(close, slowLen)
atr  = ta.atr(atrLen)

// ATR запоминается в момент сигнала, чтобы стоп и цель не ползли вслед за волатильностью.
var float riskAtr = na
if ta.crossover(fast, slow) and strategy.position_size == 0 {
    riskAtr := atr
    strategy.entry("Long", strategy.long)
}
if ta.crossunder(fast, slow) {
    strategy.close("Long", comment = "Обратный кросс")
}
if strategy.position_size > 0 {
    entry = strategy.position_avg_price
    strategy.exit("Стоп/цель", from_entry = "Long", stop = entry - stopK * riskAtr, limit = entry + takeK * riskAtr)
}

plot(fast, "Быстрая", color = color.teal)
plot(slow, "Медленная", color = color.orange)

Як влаштовано

  • Параметри strategy(…) — літерали: капітал 10 000, розмір позиції 10 % капіталу, прослизання 2 тики. Комісія не вказана, тому тестер бере тариф за замовчуванням: 0,02 % за лімітне виконання і 0,05 % за ринкове і стоп. Свій тариф у процентах задає commissionValue.
  • Ринковий вхід виконується по відкриттю наступного бара, а не по закриттю сигнального: так тестер не заглядає в майбутнє.
  • strategy.exit ставить стоп і ціль від середньої ціни входу. Якщо за один бар зачепилися обидва, тестер за замовчуванням вважає, що спрацював стоп.
  • Результати — угоди, крива капіталу, просідання — у вікні Тестер стратегії… редактора. Детальніше — на сторінці Стратегії і тестер.

Далі

https://docs.lootx.trade/uk/loot/examples