Язык Loot
LootScript — власні індикатори й сповіщення в терміналі, перевірка стратегій на історії.
1Мова LootScript
Що таке LootScript: індикатори, стратегії та бібліотеки, які працюють прямо в терміналі на даних графіка. Які дані доступні, як увімкнути скрипти і чого вони не роблять.
LootScript — мова скриптів термінала LootX. На ній пишуть власні індикатори, стратегії для перевірки ідей на історії та бібліотеки загальних функцій. Скрипт — це текстовий файл, який виконується прямо в терміналі на даних того графіка, куди ви його додали: свічки, обсяг, дельта, кластери, відкритий інтерес, ставка фінансування.
Так виглядає цілий індикатор — дельта кожного бара стовпчиками під графіком:
indicator("Дельта бара", overlay = false)
d = delta.available ? delta.value : na
plot(d, "Дельта", style = plot.style_columns, color = d >= 0 ? color.teal : color.red)Відкрити редактор, написати індикатор і додати його на графік.
Синтаксис і типиЗмінні, na, історія барів, умови, цикли, функції.
Вхідні параметри, лінії, рівні, маркери, підписи та кольори.
Дані ринкуДельта, кластери, відкритий інтерес, ставка фінансування, біржовий стакан, інші таймфрейми.
Стратегії та тестерПравила входу і виходу, прогін на історії, звіт за угодами.
Довідник функційУсі вбудовані функції та константи мови.
Що можна написати
Перший рядок скрипта оголошує його вид, і від виду залежить, що скрипту дозволено.
| Вид | Перший рядок | Що робить |
|---|---|---|
| Індикатор | indicator("Название") |
Рахує значення за барами та малює їх: лінії, гістограми, рівні, маркери, фон, підписи. Малює поверх ціни або в окремій панелі під графіком. |
| Стратегія | strategy("Название") |
Те саме, що індикатор, плюс правила входу і виходу. Заявки стратегії віртуальні — їх виконує Тестер стратегії на історії та показує угоди, криву капіталу і показники. |
| Бібліотека | library("Название", 1) |
Зберігає функції, які підключають інші ваші скрипти. На графік не додається і нічого не малює. |
Крім своїх скриптів, можна перенести готові з формату Pine Script: термінал перекладе їх у LootScript під час імпорту. Як це працює і що перевірити після перекладу — на сторінці Імпорт із Pine Script.
Які дані доступні скрипту
- Свічки графіка:
open,high,low,close,volume, час бара та похідні на кшталтhl2. - Потік ордерів: дельта агресивних покупок і продажів, кластери за рівнями ціни, відкритий інтерес, ставка фінансування, записана історія біржового стакана, метрики скринера.
- Живий біржовий стакан і стрічка угод — лише на поточному, ще не закритому барі: їхня історія не записується.
- Інші таймфрейми та інструменти — через запит серії зі старшого таймфрейма або з іншої монети.
Якщо біржа не віддає якийсь показник або даних за бар немає, скрипт отримує не нуль, а спеціальне значення na — «немає значення». На графіку це розрив лінії, а не хибний нуль. Подробиці та покриття по біржах — на сторінці Дані ринку.
Де виконується скрипт
Скрипт працює всередині термінала на вашому комп’ютері. На сервер LootX він не надсилається і не виконується там.
- Ізоляція. Скрипт не має доступу до мережі, файлів, підключень бірж та API-ключів. Таких функцій у мові просто немає — ні випадково, ні навмисно скрипт не може нікуди передати ваші дані.
- Ліміти. Занадто довгий цикл або величезний масив зупиняє лише цей скрипт. Інші індикатори, панелі та сам термінал продовжують працювати, а причина зупинки видна в редакторі.
- Файли. Кожен скрипт — окремий файл із розширенням
.loot. У Windows вони лежать у папці%APPDATA%\TradingTerminal\scripts\, поза папкою встановлення, тому оновлення термінала їх не чіпають. Перенести скрипт на інший комп’ютер — означає скопіювати файл.
Як увімкнути скрипти
Скрипти — окремий модуль, який вмикається для вашого акаунта LootX. Щоб він запрацював, увійдіть в акаунт у терміналі.
Коли модуль увімкнено, у вікні індикаторів графіка (кнопка ƒ на панелі графіка) з’являються розділи Вибране, Мої скрипти, Вбудовані та Стратегії, а вгорі — кнопки Імпорт… та Редактор….
Коли модуль не ввімкнено, скрипти не показуються взагалі: вікно індикаторів містить лише вбудовані індикатори, редактора та імпорту немає. Замків і пропозицій купити при цьому теж немає — термінал виглядає так, ніби скриптів у ньому не існує. Щойно доступ з’явиться, вікно індикаторів перебудується саме, перезапускати термінал не потрібно.
Доступ надається на акаунт — у складі тарифу або окремо. Актуальні тарифи — на сторінці Підписки.
Чого скрипти не роблять
- Не ходить в інтернет і не читає файли. Усе, що знає скрипт, — дані графіка, на якому він стоїть.
- Не публікується і не продається. Каталогу скриптів немає: скрипт — ваш локальний файл, поділитися ним можна, лише передавши файл.
- Не виконує Pine Script напряму. Скрипти в цьому форматі спочатку перекладаються в LootScript під час імпорту; однакові цифри з іншими платформами не гарантуються.
Далі
https://docs.lootx.trade/uk/loot/overview
2Довідник функцій
Усі вбудовані функції, ряди та константи LootScript: ta, math, str, color, input, відмалювання, колекції, стратегії й дані ордерфлоу — з параметрами й значеннями за замовчуванням.
Тут перераховано все, що вбудовано в LootScript: оголошення скрипта, ряди бара, функції по просторах імен, константи та дані ордерфлоу. Список зібрано по таблиці вбудованих імен самого компілятора — того, чого немає на цій сторінці, немає й у мові, і виклик такого імені завершиться помилкою LS2002.
Довідник не вчить мови: як влаштовані типи, na, історія x[1] і повторний запуск бара — розказано в Синтаксис і типи, а відмалювання і налаштування — в Налаштування і відмалювання.
Як читати довідник
Кожна функція записана в один рядок: ім’я, параметри в тому порядку, в якому їх розбирає позиційний виклик, і тип результату.
ta.stdev(source, length, biased = true) → float- Параметр без
= …обов’язковий. Параметр з значенням необов’язковий: якщо його пропустити, підставиться вказане значення. = naу необов’язкового параметра означає «не задано»: функція поведеться так, як описано в рядку.- Імена параметрів можна писати в виклику явно:
ta.stdev(close, 20, biased = false). Імена — частина мови, їх не можна скорочувати. - Результат
[float, float, float]— кілька значень одразу. Їх розбирають у змінні:[mid, up, dn] = ta.bb(close, 20, 2). - Ім’я без дужок (
close,ta.obv,strategy.equity) — ряд або константа, його читають без виклику. - Результат
—означає, що функція нічого не повертає і пишеться окремим рядком.
Оголошення скрипта
Першим рядком скрипта стоїть рівно одне оголошення: indicator, strategy або library. Його аргументи читаються до першого бара, тому підходять лише літерали й константи.
| Оголошення | Що створює |
|---|---|
indicator(title, …) |
Індикатор на графіку |
strategy(title, …) |
Стратегію для тестера: ті самі можливості, що й у індикатора, плюс заявки strategy.* |
library(title, version) |
Бібліотеку функцій. Її підключають рядком import Ім'я/версія as псевдонім. У бібліотеці не можна малювати і оголошувати налаштування |
Параметри indicator
| Параметр | За замовчуванням | Що задає |
|---|---|---|
title |
— | Назва в списку індикаторів і в легенді |
shortTitle |
na |
Коротка назва для легенди |
overlay |
false |
true — відмалювати поверх свічок, false — в окремій області під графіком |
format, precision, scale |
na |
Приймаються за сумісністю: шкалу й формат чисел веде термінал |
maxBarsBack |
na |
Приймається й не діє: історія завжди завантажується повністю |
timeframe |
na |
Приймається й не діє: скрипт вважається на таймфреймі графіка, інший таймфрейм дає request.security |
maxLinesCount, maxLabelsCount, maxBoxesCount |
500 |
Скільки ліній, міток і прямокутників одного виду живуть одночасно. Понад ліміт видаляється найстаріший |
maxPolylinesCount |
500 |
Заброньовано: об’єктів polyline в мові поки немає |
Константи для format: format.inherit, format.price, format.volume, format.percent, format.mintick. Для scale: scale.right, scale.left, scale.none. Рядки format.* розуміє й str.tostring.
Параметри strategy
У strategy ті самі title, shortTitle, overlay і межі об’єктів відмалювання, що й у indicator, плюс параметри тестера:
| Параметр | За замовчуванням | Що задає |
|---|---|---|
initialCapital |
10000 |
Початковий капітал |
currency |
"USD" |
Приймається; на розрахунок не впливає |
defaultQtyType |
strategy.qty.fixed |
Як читати розмір заявки за замовчуванням: strategy.qty.fixed — штуки, strategy.qty.cash — сума, strategy.qty.percent_of_equity — відсоток капіталу, strategy.qty.risk_percent — відсоток ризику до стопа |
defaultQtyValue |
1 |
Розмір заявки за замовчуванням |
commissionType |
strategy.commission.percent |
Комісія в процентах, strategy.commission.cash_per_contract — за одиницю, strategy.commission.cash_per_order — за заявку |
commissionValue |
na |
Розмір комісії. na — ставки мейкера і тейкера інструмента |
slippageTicks |
0 |
Прослизання в кроках ціни |
pyramiding |
0 |
Скільки додаткових входів в той самий бік дозволено |
positionModel |
strategy.model.netting |
Одна загальна позиція або роздільні (strategy.model.hedging) |
calcOnEveryTick |
false |
Рахувати заявки на кожному тіку живого бара, а не тільки на закритті |
calcOnOrderFills |
false |
Приймається; ця версія його не використовує |
processOrdersOnClose |
false |
Виконувати заявки за ціною закриття того ж бара. Звіт помітиться як недосяжний вживу |
marginLong, marginShort |
0 |
Початкова маржа лонга і шорта в процентах від позиції. 0 — без симуляції маржі і ліквідацій |
leverage |
1 |
Плече |
applyFunding |
true |
Ураховувати ставку фінансування безстрокових ф’ючерсів у результаті |
fillModel |
strategy.fill.conservative |
Шлях ціни всередині бара. Обережна модель рахує, що ціна спочатку йшла в гірший бік: якщо стоп і тейк обидва всередині бара, виконається стоп. strategy.fill.optimistic — навпаки |
Бар і інструмент
Ряди бара
| Ім’я | Тип | Що містить |
|---|---|---|
open, high, low, close, volume |
float |
Ціни і об’єм бара |
hl2, hlc3, ohlc4, hlcc4 |
float |
Середні ціни бара: (H+L)/2, (H+L+C)/3, (O+H+L+C)/4, (H+L+2C)/4 |
time, time_close |
int |
Час відкриття і закриття бара, мілісекунди UTC |
bar_index |
int |
Номер бара від початку завантаженої історії, з нуля |
last_bar_index |
int |
Номер останнього завантаженого бара |
timenow |
int |
Поточний час термінала, мілісекунди UTC |
Стан бара: barstate
| Ім’я | Істинно, коли |
|---|---|
barstate.isfirst |
Перший бар завантаженої історії |
barstate.islast |
Останній завантажений бар |
barstate.ishistory |
Бар з історії, а не формуючийся |
barstate.isrealtime |
Бар формується в реальному часі |
barstate.isnew |
Перший прохід по новому бару |
barstate.isconfirmed |
Бар закрився — значення більше не зміниться |
isrealtime, isnew і значення, що залежать від них, відрізняються на історії й вживу — компілятор попередить, якщо вони дійдуть до графіка.
Інструмент: sym
| Ім’я | Тип | Що містить |
|---|---|---|
sym.ticker |
string |
Майданчик і символ у тому вигляді, який приймає request.security |
sym.exchange |
string |
Код майданчика |
sym.base, sym.quote |
string |
Базовий і котируемий актив: BTC і USDT у BTCUSDT. na, якщо котирування не вдалося виділити |
sym.tick_size |
float |
Крок ціни |
sym.qty_step, sym.min_qty |
float |
Крок і мінімум кількості |
sym.maker_fee, sym.taker_fee |
float |
Комісії мейкера і тейкера частками: 0.0002 — це 0,02 % |
Таймфрейм: tf
| Ім’я | Тип | Що містить |
|---|---|---|
tf.period |
string |
Таймфрейм графіка текстом: "5", "60", "1D" |
tf.ms, tf.seconds |
int |
Довжина бара в мілісекундах і секундах |
tf.isintraday, tf.isdaily |
bool |
Бар коротший за добу; бар — рівно доба |
tf.in_ms(period) |
int |
Довжина довільного таймфрейму в мілісекундах; na, якщо рядок не розібрана |
tf.in_seconds(period = na) |
int |
Те саме в секундах; без аргумента — таймфрейм графіка |
Час і календар
Усі календарні функції за замовчуванням рахують в UTC, а не в часовому поясі комп’ютера: так індикатор виглядає однаково у всіх.
| Функція | Повертає | Що робить |
|---|---|---|
year, month, dayofmonth, weekofyear (timestamp = time, timezone = "UTC") |
int |
Рік, місяць, число, номер тижня за ISO |
dayofweek(timestamp = time, timezone = "UTC") |
int |
День тижня: неділя — 1, субота — 7 |
hour, minute, second (timestamp = time, timezone = "UTC") |
int |
Година, хвилина, секунда |
time_of_day(timestamp = time, timezone = "UTC") |
int |
Мілісекунди від опівночі в заданому поясі |
timestamp(year, month, day, hour = 0, minute = 0, second = 0, timezone = "UTC") |
int |
Мітка часу з дати |
time_in_range(session, timezone = "UTC") |
bool |
Бар потрапляє в інтервал виду "0930-1600" |
session.ismarket, session.isfirstbar, session.islastbar |
bool |
Бар всередині сесії, перший і останній бар сесії. У цілодобових ринків сесія — доба UTC |
Константи днів збігаються з тим, що повертає dayofweek: dayofweek.sunday (1), dayofweek.monday, dayofweek.tuesday, dayofweek.wednesday, dayofweek.thursday, dayofweek.friday, dayofweek.saturday (7). Часовий пояс задається ідентифікатором IANA, наприклад "Europe/Moscow".
ta — технічний аналіз
Функції ta.* пам’ятають свій стан між барами, тому компілятор обчислює їх на кожному барі, навіть якщо виклик стоїть всередині if. Перші бари, поки вікно не заповнилося, функції повертають na.
Ковзні середні
| Функція | Повертає | Що робить |
|---|---|---|
ta.sma(source, length) |
float |
Просте середнє за length барів |
ta.ema(source, length) |
float |
Експоненціальне середнє: вага нового значення 2/(length+1) |
ta.rma(source, length) |
float |
Згладжування Вайлдера, вага 1/length. На ньому побудовані RSI і ATR; це не те саме, що ta.ema тієї ж довжини |
ta.wma(source, length) |
float |
Лінійно зважене: свіжі бари важать більше |
ta.vwma(source, length) |
float |
Середнє, зважене по об’єму |
ta.hma(source, length) |
float |
Середнє Халла: менше запізнюється на розворотах |
ta.swma(source) |
float |
Симетрично зважене середнє по чотирьох барах |
ta.alma(source, length, offset = 0.85, sigma = 6) |
float |
Середнє з гаусівським вікном; offset зсуває пік у свіжіші бари, sigma задає ширину |
ta.linreg(source, length, offset = 0) |
float |
Точка на лінії регресії по останніх length значеннях |
Осцилятори
| Функція | Повертає | Що робить |
|---|---|---|
ta.rsi(source, length) |
float |
Індекс відносної сили, 0…100 |
ta.stoch(source, high, low, length) |
float |
Де source знаходиться всередині діапазону high–low за length барів, 0…100 |
ta.cci(source, length) |
float |
Відхилення від середнього, нормоване середнім абсолютним відхиленням |
ta.mfi(source, length) |
float |
Індекс грошового потоку: RSI з урахуванням об’єму |
ta.cmo(source, length) |
float |
Осцилятор Чанде, −100…100 |
ta.roc(source, length) |
float |
Зміна в процентах до значення length барів тому |
ta.mom(source, length) |
float |
Різниця зі значенням length барів тому |
ta.tsi(source, shortLength, longLength) |
float |
Індекс істинної сили: двічі згладжений імпульс до двічі згладженого модуля імпульсу |
ta.wpr(length) |
float |
Williams %R, −100…0 |
ta.bop(length = 1) |
float |
Баланс сил: яку частину діапазону бара зайняло тіло, зі згладжуванням |
ta.cog(source, length) |
float |
Центр тяжіння вікна |
Волатильність і канали
| Функція | Повертає | Що робить |
|---|---|---|
ta.tr(handle_na = true) |
float |
Істинний діапазон бара |
ta.atr(length) |
float |
Середній істинний діапазон |
ta.natr(length) |
float |
ATR у відсотках від ціни закриття |
ta.stdev(source, length, biased = true) |
float |
Стандартне відхилення. biased = false — вибіркове, з дільником length−1 |
ta.variance(source, length, biased = true) |
float |
Дисперсія, з тим самим вибором дільника |
ta.dev(source, length) |
float |
Середнє абсолютне відхилення від середнього |
ta.bb(source, length, mult) |
[float, float, float] |
Смуги Боллінджера: середня, верхня, нижня |
ta.bbw(source, length, mult) |
float |
Ширина смуг Боллінджера відносно середньої |
ta.kc(source, length, mult, useTrueRange = true) |
[float, float, float] |
Канал Кельтнера: середня, верхня, нижня |
ta.kcw(source, length, mult, useTrueRange = true) |
float |
Ширина каналу Кельтнера відносно середньої |
ta.range(length) |
float |
Висота останніх length барів: максимум high мінус мінімум low |
Тренд
| Функція | Повертає | Що робить |
|---|---|---|
ta.macd(source, fastLength, slowLength, signalLength) |
[float, float, float] |
MACD: лінія, сигнальна лінія, гістограма |
ta.dmi(diLength, adxLength) |
[float, float, float] |
Індекс спрямованого руху: +DI, −DI, ADX |
ta.adx(diLength, adxLength) |
float |
Тільки ADX |
ta.supertrend(factor, atrLength) |
[float, int] |
Лінія супертренда і напрям: 1 — тренд угору, −1 — вниз |
ta.sar(start = 0.02, increment = 0.02, maximum = 0.2) |
float |
Параболік SAR |
ta.vortex(length) |
[float, float] |
Індикатор вирка: VI+ і VI− |
ta.aroon(length) |
[float, float] |
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 на іншому таймфреймі або інструменті і повертає результат на барах графіка |
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) створює скрипт із шаблону — ковзну середню з одним налаштуванням:
indicator("Без названия", overlay = true)
length = input.int(20, "Length", minval = 1)
plot(ta.ema(close, length), "EMA", color = color.orange)Замініть текст на найкоротший робочий індикатор — просту середню за 20 барів:
indicator("Мой первый индикатор", overlay = true)
plot(ta.sma(close, 20), "Средняя 20", color = color.orange)Що тут написано:
indicator(...)— оголошення, обов’язковий перший рядок будь-якого скрипта. Назва потрапить у список Мої скрипти та в легенду графіка.overlay = trueмалює поверх свічок; зoverlay = falseіндикатор отримає окрему панель під графіком.ta.sma(close, 20)— середнє цін закриття за останні 20 барів.plot(...)— малює лінію: одне значення на кожен бар. Другий аргумент — ім’я лінії в налаштуваннях,color— колір.
Скрипт виконується для кожного бара по черзі, від найстарішого до поточного. Першим 19 барам бракує історії для середньої, тому лінія починається не з лівого краю — це нормально. Скільки барів іде на такий «прогрів», редактор пише в рядку стану внизу.
Під час набору редактор пропонує імена функцій і констант, після відкриття дужки показує параметри функції, а при наведенні на ім’я — його опис. Список підказок можна викликати вручну сполученням Ctrl+Space.
Збережіть і додайте на графік
- Зберегти (Ctrl+S) записує скрипт у папку скриптів. Поки є незбережені правки, перед іменем файлу в заголовку вікна стоїть крапка
•. - Додати на графік (Ctrl+Enter) перевіряє скрипт, зберігає його та кладе на панель графіка. У панелі редактора з’явиться напис: «Мой первый индикатор» додано на графік.
Готово: лінія на графіку, ім’я індикатора — у легенді. Індикатор збережеться в розкладці й повернеться після перезапуску термінала.
Як редактор показує помилки
Скрипт перевіряється сам — за мить після того, як ви перестали друкувати. Результат видно в шапці редактора: компіляція…, потім ок · 12 мс або, якщо щось не так, помилок: 1 чи попереджень: 1.
Спробуйте помилитися: напишіть ta.smaa замість ta.sma. Місце помилки підкреслиться хвилястою лінією, лічильник у шапці покаже помилок: 1, а на вкладці Проблеми з’явиться рядок із кодом помилки, поясненням і позицією:
LS2002 Неизвестное имя «ta.smaa» — проверьте написание или объявите его выше Стр 3:6Подвійне клацання по рядку переносить курсор до місця помилки. У кожної помилки є постійний код виду LS####, а текст одразу підказує, як її виправити. Розбір частих помилок — на сторінці Помилки компіляції та виконання.
Скрипт із помилками на графік не потрапить: Додати на графік відповість «Скрипт із помилками на графік не кладеться — див. «Проблеми»» і переведе курсор до першої помилки. У вікні індикаторів такий скрипт позначається червоною міткою з числом помилок замість мітки Скрипт.
Бувають і помилки під час виконання — наприклад, цикл, який не вкладається у відведений час. Тоді скрипт зупиняється, а причина видна на вкладці Вивід: «Скрипт зупинено: …». Інші індикатори й термінал продовжують працювати.
Правки скрипта, який уже на графіку
Поки ви редагуєте, графік продовжує показувати ту версію, яку ви додали. Щойно в редакторі з’явиться справна версія, відмінна від тієї на графіку, відбуваються дві речі:
- у панелі редактора з’являється кнопка Оновити індикатор;
- у легенді індикатора на графіку з’являється значок оновлення.
Будь-який із них зберігає скрипт і замінює його на всіх графіках, де він стоїть. Додати на графік для скрипта, який уже десь додано, робить те саме — оновлює всі копії, а не кладе другу. Скільки панелей отримають нову версію, показує мітка на графіках: N у шапці редактора.
Де лежать файли
У Windows скрипти зберігаються в папці %APPDATA%\TradingTerminal\scripts\, по одному файлу .loot на скрипт. Це звичайний текст — його можна відкрити будь-яким редактором, скопіювати, покласти в резервну копію. Папка розташована поза папкою встановлення, тому оновлення термінала її не чіпають.
Ім’я файлу утворюється з назви під час першого збереження: пробіли замінюються підкресленням, кирилиця зберігається. «Мой первый индикатор» стане файлом Мой_первый_индикатор.loot.
Коли папка створюється вперше, до неї кладуться шість стартових скриптів — Дві ковзні, RSI із зонами, Імпульс обсягу, Кумулятивна дельта, Інтерес проти ціни та Ставка фінансування річних. Вони лежать у розділі Мої скрипти; їх зручно відкрити й розібрати.
Другий приклад: канал із налаштуваннями
Зробимо скрипт кориснішим: канал із середньої та двох меж на відстані кількох стандартних відхилень. Період, ширину й джерело ціни винесемо в налаштування, а верхню та нижню межі підсвічуватимемо червоним, коли ціна за них виходить.
indicator("Канал вокруг средней", overlay = true)
length = input.int(20, "Период", minval = 2)
mult = input.float(2.0, "Ширина в сигмах", minval = 0.1, step = 0.1)
src = input.source(close, "Источник")
basis = ta.sma(src, length)
dev = mult * ta.stdev(src, length)
upper = basis + dev
lower = basis - dev
plot(basis, "Середина", color = color.gray)
plot(upper, "Верх", color = close > upper ? color.red : color.teal)
plot(lower, "Низ", color = close < lower ? color.red : color.teal)Що нового:
- Кожен виклик
input.*стає рядком у вікні налаштувань індикатора, у тому порядку, в якому він написаний.minvalне дасть ввести період менше двох, аstep = 0.1означає, що поле ширини показує один знак після коми. input.sourceперетворюється на випадаючий список рядів:close,open,hl2,volumeта інші.- Колір меж — вираз, тому він обчислюється на кожному барі окремо.
Додайте скрипт на графік і двічі клацніть по його рядку в легенді (або натисніть у ній значок налаштувань). На вкладці Вхідні дані — три ваші налаштування: поміняйте період і лінії перерахуються одразу. Значення запам’ятовуються для цього індикатора на цьому графіку; кнопка За замовчуванням поверне ті, що написані в коді. На вкладці Стиль — колір середньої та товщина кожної лінії, на вкладці Видимість — прапорці, щоб сховати будь-яку з трьох ліній. Кольору меж у налаштуваннях немає: його обирає сам скрипт на кожному барі.
Далі
https://docs.lootx.trade/uk/loot/first-script
4Синтаксис і типи
Як влаштований LootScript: виконання по барах, оголошення скрипта, п’ять форм присвоєння, типи й кваліфікатори, na, історія x[n], оператори, умови, switch, цикли, функції й власні типи.
Ця сторінка — короткий опис мови: як виконується скрипт, як оголошувати змінні, які є типи, що таке na, як читати минулі бари, як писати умови, цикли й функції. Всі приклади — повні робочі скрипти: їх можна вставити в редактор і додати на графік.
Як виконується скрипт
Усе, що написане на верхньому рівні файлу, виконується один раз на кожен бар — від найстарішого завантаженого до поточного, рядок за рядком. Тому змінна в LootScript зберігає не одне число, а значення на кожному барі, і до минулих значень можна звертатися.
indicator("Тело свечи")
body = close - open // считается заново на каждом баре
plot(body, "Тело", style = plot.style_columns)На поточному, ще не закритому барі скрипт перераховується з кожним новим тіком, починаючи зі стану, яке було на закритті попереднього бара. Закриті бари при цьому не перераховуються.
Оголошення
Перша інструкція скрипта — рівно одне оголошення: indicator(...), strategy(...) або library(...). Вище нього можуть стояти тільки коментарі і необов’язковий рядок версії #version 1. Без оголошення скрипт не скомпілюється з помилкою «Немає оголошення скрипта — почніть з indicator(“Назва”)».
#version 1
// Комментарии и строка версии могут стоять выше объявления.
indicator("Размах бара", shortTitle = "Размах", overlay = false)
plot(high - low, "Размах", style = plot.style_histogram)Головні параметри індикатора: title — назва в списку скриптів, shortTitle — коротке ім’я для легенди, overlay — малювати поверх ціни (true) або в окремій панелі (false, за замовчуванням). Параметри стратегії описані на сторінці Стратегии и тестер.
Змінні і присвоєння
| Форма | Що робить |
|---|---|
x = выражение |
Оголошує змінну. На кожному барі вона обчислюється заново. |
x := выражение |
Присвоює нове значення вже оголошеній змінній. Тип має співпадати. |
var x = выражение |
Оголошує змінну один раз, на першому барі. Значення переходить на наступні бари. |
varip x = выражение |
Як var, але значення зберігається й між тіками поточного бара. |
[a, b, c] = функция(...) |
Розкладає кілька результатів функції по змінних. |
Для зміни вже оголошеної змінної є й короткі форми: +=, -=, *=, /=, %=. Тип можна вказати явно: float level = 0. Імена вбудованих рядів і просторів (close, volume, ta та інших) зайняті — назвати так свою змінну не можна.
Головна відмінність від звичних мов — звичайна змінна не накопичує значення між барами. Для лічильників і сум потрібен var:
indicator("Счётчик зелёных свечей")
var greens = 0 // объявляется один раз и переживает переход к следующему бару
if close > open {
greens += 1
}
today = 0 // а эта переменная равна 0 на каждом новом баре
today := today + 1 // поэтому здесь всегда 1
plot(greens, "Зелёных с начала истории")varip потрібен рідко — наприклад, щоб рахувати тіки всередині бара. На історії тиків немає, тому таке значення на минулих барах буде іншим, ніж було вживу. Якщо значення varip потрапляє на графік, редактор попередить про перерисовку.
Типи
| Тип | Що зберігає | Приклад |
|---|---|---|
int |
ціле число | 14, 1_000_000, 0xFF |
float |
дробове число | 2.5, .5, 1e-9 |
bool |
істина або неправда | true, false |
string |
текст | "BTC", 'BTC' |
color |
колір з прозорістю | #FF9800, #FF980080, color.teal |
Є й складні типи: масиви array<float>, словники map<string, float>, матриці matrix<float>, а також ваші власні типи й перерахування (див. нижче) і графічні об’єкти line, box, label, table.
Правила, через які найчастіше спотикаються:
- Тип фіксується при оголошенні. Після
x = 1присвоїтиx := 2.5не можна:x— ціле. Пишітьx = 1.0абоfloat x = 1. - Ціле перетворюється в дробове само, назад — тільки явно:
math.round,math.floor,math.ceil,math.trunc. - Ділення цілих — ціле:
7 / 2рівно3. Потрібна дробь — зробіть одне з чисел дробовим:7.0 / 2. - Піднесення до степеня
^завжди дає дробове число:2 ^ 3рівно8.0. - Рядок не можна додати до числа.
"Цена: " + closeне скомпілюється — пишіть"Цена: " + str.tostring(close). - Умова — тільки
bool.if volume { … }— помилка; пишітьif volume > 0 { … }.
Кваліфікатори: наскільки значення постійне
Окрім типу в кожного значення є кваліфікатор — наскільки воно постійне під час роботи скрипта. Від слабкого до сильного:
| Кваліфікатор | Коли відоме значення | Приклад |
|---|---|---|
const |
вже під час компіляції | 14, "EMA" |
input |
після зчитування налаштувань, далі не змінюється | input.int(14, "Период") |
simple |
при запуску, далі не змінюється | крок ціни інструмента |
series |
може змінюватися на кожному барі | close, bar_index |
На практиці це важливо в одному місці: періоди функцій ta.* повинні бути постійними — літералом або налаштуванням. Інакше функціям довелося б перебудовувати свій стан на кожному барі.
indicator("Период из настроек")
len = input.int(14, "Период", minval = 2)
plot(ta.rsi(close, len), "RSI")
// ta.rsi(close, bar_index) не скомпилируется:
// «length» в «ta.rsi» требует значение не слабее input, а передано seriesna — відсутнє значення
na означає «значення відсутнє»: не вистачає історії для розрахунку, біржа не віддає показник, у даних дірка. na є в будь-якому типі.
- Арифметика з
naдаєna:na + 1— цеna. - Будь-яке порівняння з
naхибне, томуif x > 0приx = naне виконається. - Перевіряйте відсутність тільки через
na(x). Записx == naкомпілятор відхилить з помилкою «Сравнение с na всегда ложно — используйте na(x)». nz(x)підставляє 0 замістьna,nz(x, v)— значенняv. Те саме коротше:x ?? v.naна графіку — розрив лінії, а не нуль.
indicator("Средняя без пустого начала", overlay = true)
avg = ta.sma(close, 50) // на первых 49 барах — na
line1 = na(avg) ? close : avg // проверка через na(x)
line2 = avg ?? close // то же короче
plot(line2, "Средняя или цена", color = color.orange)Історія: x[n]
x[n] — значення x на барі, який був n барів тому; x[0] — поточне. Працює з будь-яким рядом, у тому числі з вашими змінними.
indicator("Наклон средней")
ma = ta.ema(close, 20)
slope = ma - ma[1] // изменение за один бар
plot(slope, "Наклон", style = plot.style_histogram,
color = slope >= 0 ? color.teal : color.red)- Якщо
nбільше числа барів до початку історії, результат —na, а не помилка. nможе змінюватися від бара до бара:close[len]при змінномуlenдопустимо.- Негативний індекс — помилка: заглядати в майбутні бари не можна.
- Налаштовувати глибину історії не потрібно: скрипту доступна вся історія, завантажена на графік.
Оператори
Від найвищого пріоритету до найнижчого:
| Пріоритет | Оператори |
|---|---|
| 1 | x[n], вызов f(…), доступ через точку a.b |
| 2 | ^ — степень, вычисляется справа налево |
| 3 | унарні -, +, not |
| 4 | *, /, % |
| 5 | +, - |
| 6 | <, >, <=, >= |
| 7 | ==, != |
| 8 | and |
| 9 | or |
| 10 | ?? — заміна na |
| 11 | ? : — умовний вираз |
- Порівняння не ланцюжаться: замість
a < b < cпишітьa < b and b < c. andіorне обчислюють праву частину, якщо відповідь уже ясна по лівій.- Степінь вище унарного мінуса:
-2 ^ 2рівне-4. Потрібно4— пишіть(-2) ^ 2. - Дробові числа порівнюйте з допуском:
math.approx(a, b), бо0.1 + 0.2 == 0.3хибне.
Умови
Блоки завжди в фігурних дужках. if буває інструкцією і виразом; для простого вибору з двох є ? :.
indicator("Направление бара")
dir = 0
if close > open {
dir := 1
} else if close < open {
dir := -1
}
// if как выражение: обе ветки обязательны
bodySize = if close >= open { close - open } else { open - close }
// условный оператор для простых случаев
barColor = dir > 0 ? color.teal : color.red
plot(bodySize, "Тело", style = plot.style_columns, color = barColor)switch
switch вибирає першу підходящу гілку. Форма з об’єктом порівнює його зі значеннями гілок, форма без об’єкта перевіряє умови по черзі. Гілка => без умови — гілка за замовчуванням. Провалювання в наступну гілку немає. Коли switch повертає значення, гілка за замовчуванням обов’язкова.
indicator("Средняя на выбор", overlay = true)
kind = input.string("EMA", "Тип средней", options = ["EMA", "SMA", "WMA"])
ma = switch kind {
"EMA" => ta.ema(close, 20)
"SMA" => ta.sma(close, 20)
=> ta.wma(close, 20)
}
zone = switch {
close > ma * 1.02 => 1
close < ma * 0.98 => -1
=> 0
}
plot(ma, "Средняя", color = zone == 1 ? color.teal : zone == -1 ? color.red : color.gray)Цикли
for i in a .. b перебирає числа від a включно до b не включно. Крок задається словом by, у тому числі від’ємний. Змінна циклу існує тільки всередині циклу і не змінюється в тілі.
indicator("Зелёные свечи за N баров")
n = input.int(10, "Сколько баров", minval = 1, maxval = 200)
greens = 0
for i in 0 .. n { // i = 0, 1, …, n − 1
if close[i] > open[i] {
greens += 1
}
}
plot(greens, "Зелёных", style = plot.style_columns)indicator("Виды циклов")
total = 0
for i in 0 .. 10 by 2 { // 0, 2, 4, 6, 8
total += i
}
for i in 10 .. 0 by -1 { // 10, 9, …, 1
if i % 3 == 0 {
continue // сразу к следующему шагу
}
total += i
}
var closes = array.new<float>(0)
closes.push(close)
if closes.size() > 20 {
closes.shift()
}
sum = 0.0
for v in closes { // по элементам массива; for [i, v] in … — с индексом
sum += v
}
k = 0
while k < 100 {
k += 7
if k > 50 {
break // выход из цикла
}
}
plot(sum / closes.size(), "Средняя из массива")Бескінечний цикл термінал не зависне: у скрипта є бюджет операцій на бар і ліміт часу. Перевищивши їх, скрипт зупиниться з повідомленням «Скрипт исчерпал бюджет операций на бар — упростите цикл» або «Скрипт превысил лимит времени на проход».
Функції
Функція оголошується словом func. Коротка форма — вираз після =>, довга — тіло в дужках з return. Типи параметрів можна не вказувати — вони виводяться з викликів, а у параметрів можуть бути значення за замовчуванням. Аргументи передаються по порядку або по імені.
indicator("Z-оценка объёма")
func barRange(h, l) => h - l
func zscore(series float src, input int len) => float {
m = ta.sma(src, len)
s = ta.stdev(src, len)
return s == 0 ? na : (src - m) / s
}
func scaled(x, k = 2.0) => x * k
z = zscore(volume, 50)
plot(z, "Z объёма", style = plot.style_columns, color = z > 2 ? color.orange : color.gray)
plot(scaled(barRange(high, low), k = 0.5), "Полразмаха")- Рекурсії немає. Функція не може викликати саму себе, ні прямо, ні через іншу функцію. Повторення пишеться циклом.
- Стан — у кожного виклику свій. Якщо всередині функції є
ta.*абоvar, два виклики однієї функції ведуть незалежні розрахунки:
indicator("Два вызова одной функции", overlay = true)
func smooth(src, len) => ta.ema(src, len)
fast = smooth(close, 10) // своя средняя
slow = smooth(close, 30) // другая, независимая средняя
plot(fast, "Быстрая", color = color.teal)
plot(slow, "Медленная", color = color.orange)Функції, потрібні в кількох скриптах, виносять у бібліотеку: скрипт з оголошенням library("Имя", 1), перед функціями — слово export, в іншому скрипті — import Имя/1 as имя. Бібліотека береться з вашої папки скриптів.
Кілька результатів
Деякі функції повертають одразу кілька рядів: ta.bb, ta.macd, ta.kc, ta.dmi, ta.supertrend та інші. Їх результат розкладається по змінних у квадратних дужках; число імен має збігатися з числом результатів.
indicator("Полосы Боллинджера", overlay = true)
[basis, upper, lower] = ta.bb(close, 20, 2.0)
plot(basis, "Середина", color = color.gray)
plot(upper, "Верх", color = color.teal)
plot(lower, "Низ", color = color.teal)Власні типи та перерахування
type збирає кілька полів в одну структуру. Об’єкт створюється через Имя.new(...), поля читаються і змінюються через крапку.
indicator("Последний локальный максимум", overlay = true)
type Swing {
int barIndex
float price
}
var Swing last = Swing.new(barIndex = 0, price = high)
ph = ta.pivothigh(high, 5, 5)
if not na(ph) {
last.barIndex := bar_index - 5
last.price := ph
}
plot(last.price, "Максимум", style = plot.style_stepline, color = color.orange)enum — закритий список варіантів із підписами. Зручніше рядками: опечатка в імені варіанта — помилка компіляції, а не тихо неспрацювавша умова. Разом з input.enum перерахування перетворюється в випадаючий список у налаштуваннях — див. Настройки и отрисовка.
indicator("Режим рынка")
enum Regime {
trend = "Тренд"
flat = "Флэт"
}
regime = math.abs(close - close[20]) > ta.atr(14) * 3 ? Regime.trend : Regime.flat
plot(regime == Regime.trend ? 1 : 0, "Тренд", style = plot.style_stepline)Функції ta.* всередині умов
Функції на кшталт ta.ema, ta.rsi або ta.atr пам’ятають свій стан з минулого бара. Якби такий виклик виконувався тільки на частині барів — всередині if або однієї гілки ? : — його розрахунок пропускав би бари й тихо давав некоректні числа.
LootScript цього не допускає: компілятор сам виносить кожен виклик ta.* з умови і виконує його на кожному барі, а умова лише вибирає, використовувати чи результат. Тож такий код рахує RSI правильно:
indicator("RSI только на зелёных барах")
r = close > open ? ta.rsi(close, 14) : na
plot(r, "RSI", style = plot.style_circles)Винести виклик не можна, лише якщо його аргумент сам народжується всередині гілки. Тоді компілятор не вгадає й повідомить: «Аргумент «len» нельзя вычислить вне ветки — вынесите вызов ta.* на верхний уровень». Рішення — порахувати аргумент до умови:
indicator("Аргумент до условия")
// Так нельзя — len объявлена внутри ветки:
// if close > open {
// len = 10
// e = ta.ema(close, len)
// }
len = 10
e = ta.ema(close, len)
plot(close > open ? e : na, "EMA на зелёных барах", style = plot.style_circles)Коментарі та перенесення рядків
//— коментар до кінця рядка,/* … */— блочний, блоки можна вкладати один в одного.- Інструкція закінчується з кінцем рядка, крапка з комою не потрібна.
- Довгий вираз продовжується на наступному рядку, якщо рядок обірвано всередині дужок, закінчується оператором або наступний рядок починається з оператора,
?або:.
indicator("Перенос строк")
typical = high
+ low
+ close
signal = close > open
? typical / 3
: na
plot(signal, "Типичная цена на зелёных барах", style = plot.style_circles)Далі
https://docs.lootx.trade/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 |
Текстове поле |
Приклад нижче збирає в одному скрипті п’ять видів налаштувань:
indicator("Средняя на выбор", overlay = true)
enum Basis {
sma = "Простая"
ema = "Экспоненциальная"
wma = "Взвешенная"
}
basis = input.enum(Basis.ema, "Тип средней")
length = input.int(50, "Период", minval = 1, maxval = 500)
src = input.source(close, "Источник")
lineColor = input.color(color.orange, "Цвет линии")
showBg = input.bool(false, "Подсвечивать фон")
avg = switch basis {
Basis.sma => ta.sma(src, length)
Basis.ema => ta.ema(src, length)
=> ta.wma(src, length)
}
plot(avg, "Средняя", color = lineColor, linewidth = 2)
bgcolor(showBg and close > avg ? color.new(color.teal, 40) : na, title = "Фон")У вікні налаштувань вийде спадний список «Тип средней» із пунктами «Простая», «Экспоненциальная» і «Взвешенная». Нижче будуть поле періоду, список джерел, вибір кольору та прапорець. Як оголошувати переліки, розказано в розділі Свої типи та переліки.
Параметри чисел і рядків
minvalіmaxvalзадають межі: поле не прийме період менший заminvalабо більший заmaxval.stepуinput.floatзадає, скільки знаків після коми показує поле: приstep = 0.1видно один знак. Стрілок біля поля немає, значення вводиться з клавіатури.optionsуinput.stringіinput.timeframeперетворює поле на спадний список. Значення за замовчуванням мусить бути одним із пунктів, інакше компілятор видасть помилку.tooltip,groupтаinlineкомпілятор приймає, але на вигляд вікна налаштувань вони поки не впливають.
indicator("Цена для расчёта")
mode = input.string("Закрытие", "Считать по", options = ["Закрытие", "Середина свечи"])
price = mode == "Закрытие" ? close : hl2
plot(ta.rsi(price, 14), "RSI", color = color.purple)У input.source за замовчуванням може бути й ряд ринкових даних, наприклад delta.cum. Такий ряд стане першим пунктом списку, перед ціновими рядами. Якщо ж за замовчуванням стоїть вираз на зразок (high + low) / 2, рядка у вікні налаштувань не буде: вибирати нема з чого.
Окремих налаштувань для часу, торгової сесії та ціни, яку вибирають клацанням на графіку, у мові поки немає.
Де зберігаються вибрані значення
Значення запам’ятовуються для кожного індикатора на кожному графіку окремо: дві копії одного скрипта на різних панелях можуть стояти з різними періодами. Кнопка За замовчуванням у вікні налаштувань повертає значення, написані в коді.
Значення прив’язане до імені змінної, в яку записано виклик input.*. Підпис рядка можна змінювати вільно, вибране значення збережеться. Рядки можна й переставляти. А якщо перейменувати змінну (length на period), налаштування повернеться до значення з коду.
Вікно налаштувань відкривається подвійним клацанням по рядку індикатора в легенді графіка або значком налаштувань у цьому рядку. Крім вкладки Вхідні дані в ньому є Стиль і Видимість — про них нижче.
Лінії: plot
plot малює ряд, по одному значенню на кожен бар. Обов’язковий лише перший аргумент — сам ряд. Решта параметрів задаються за іменем:
title— ім’я лінії в легенді та у вікні налаштувань;color— колір, постійний або обчислюваний на кожному барі;linewidth— товщина;style— спосіб відображення, див. таблицю;offset— зсув на задану кількість барів: додатний праворуч, від’ємний ліворуч;show_last— малювати лише останні N барів;join = true— з’єднати лінією точки стилівcirclesіcross;editable = false— прибрати лінію з вікна налаштувань;display = display.none— сховати лінію при додаванні; увімкнути її можна на вкладці Видимість.
| Стиль | Як виглядає |
|---|---|
plot.style_line |
Ламана лінія, стиль за замовчуванням |
plot.style_linebr |
Те саме, що line |
plot.style_stepline |
Сходинки |
plot.style_stepline_diamond |
Сходинки з ромбами |
plot.style_histogram |
Тонкі стовпчики від нуля завтовшки в лінію |
plot.style_columns |
Стовпчики від нуля завширшки у свічку |
plot.style_area |
Область, зафарбована до нуля |
plot.style_areabr |
Те саме, що area |
plot.style_circles |
Точки |
plot.style_cross |
Хрестики |
Лінія завжди переривається там, де в ряду немає значення (na), і не перестрибує пропуск прямим відрізком. Тому пари line/linebr та area/areabr малюються однаково.
indicator("Стили линий")
d = close - open
plot(d, "Тело свечи", style = plot.style_histogram, color = d >= 0 ? color.teal : color.red)
plot(ta.sma(d, 10), "Средняя 10", style = plot.style_stepline, color = color.orange, linewidth = 2)
plot(ta.sma(d, 30), "Средняя 30", style = plot.style_circles, color = color.gray)Колір по барах
Колір може бути виразом: тоді він обчислюється на кожному барі заново. Колір na означає, що на цьому барі лінії немає:
indicator("Средняя только над ценой", overlay = true)
m = ta.sma(close, 50)
plot(m, "Средняя", color = close > m ? color.teal : na)Що лінія отримує у вікні налаштувань
- На вкладці Стиль налаштовується товщина кожної лінії. Рядок кольору з’являється лише в лінії з постійним кольором: якщо колір вибирає скрипт на кожному барі, міняти у вікні нічого.
- На вкладці Видимість у кожної лінії є прапорець показу. Він з’являється, якщо ліній більше однієї або якщо лінію сховано через
display. - Лінія з
editable = falseне отримує рядків на жодній вкладці.
Рівні та заливки
hline малює горизонтальну лінію на постійній ціні — наприклад, межі зон RSI. Ціна має бути числом або налаштуванням input.*: ряд, що змінюється від бара до бара, сюди не підходить. Для такої лінії потрібен plot. Стиль лінії задають hline.style_solid, hline.style_dashed та hline.style_dotted.
fill зафарбовує область між двома межами. Щоб отримати межу, результат hline або plot записують у змінну:
indicator("RSI с зонами")
length = input.int(14, "Период", minval = 1)
r = ta.rsi(close, length)
top = hline(70, "Перекупленность", color = color.gray, linestyle = hline.style_dashed)
bottom = hline(30, "Перепроданность", color = color.gray, linestyle = hline.style_dashed)
fill(top, bottom, color = color.new(color.purple, 30), title = "Зона")
plot(r, "RSI", color = r > 70 ? color.red : r < 30 ? color.teal : color.purple)Обидві межі мають бути одного роду: два рівні hline або дві лінії plot. Заливку між лінією та рівнем компілятор не прийме.
Колір заливки між двома лініями може змінюватися від бара до бара. Так виходить «хмара» з двох середніх:
indicator("Облако", overlay = true)
fast = ta.ema(close, 9)
slow = ta.ema(close, 21)
pf = plot(fast, "Быстрая", color = color.teal)
ps = plot(slow, "Медленная", color = color.orange)
fill(pf, ps, color = fast > slow ? color.new(color.teal, 50) : color.new(color.red, 50), title = "Облако")Є й градієнтна заливка. Задайте top_value і bottom_value, щоб указати висоти, де колір дорівнює top_color та bottom_color; між ними колір плавно переходить. Ці висоти мають бути постійними числами. Якщо потрібна заливка до постійного рівня, зробіть його лінією, plot(50). Але пам’ятайте, що це одна з трьох ліній, які малюються.
indicator("RSI с градиентом")
r = ta.rsi(close, 14)
pr = plot(r, "RSI", color = color.purple)
pm = plot(50, "Середина", color = color.gray)
fill(pr, pm, top_value = 80, bottom_value = 50,
top_color = color.new(color.teal, 160), bottom_color = color.new(color.teal, 0))Фон і колір свічок
bgcolor зафарбовує фон під баром, barcolor перефарбовує саму свічку. Обидва приймають колір, обчислюваний на кожному барі; на барах із кольором na нічого не змінюється.
indicator("Подсветка объёма", overlay = true)
avgVol = ta.sma(volume, 20)
spike = volume > avgVol * 2
bgcolor(spike ? color.new(color.orange, 40) : na, title = "Всплеск объёма")
barcolor(close > open ? color.teal : color.red, title = "Цвет свечей")Маркери: plotshape і plotchar
plotshape ставить значок на тих барах, де умова істинна. plotchar робить те саме з будь-яким символом.
indicator("Пересечения", overlay = true)
fast = ta.ema(close, 9)
slow = ta.ema(close, 21)
plotshape(ta.crossover(fast, slow), "Вверх", style = shape.triangleup,
location = location.belowbar, color = color.teal, size = size.small)
plotshape(ta.crossunder(fast, slow), "Вниз", style = shape.triangledown,
location = location.abovebar, color = color.red, size = size.small)
plotchar(volume > ta.sma(volume, 20) * 3, "Объём", char = "●", location = location.top, color = color.orange)- Форма,
shape.*:triangleup,triangledown,arrowup,arrowdown,circle,square,diamond,cross,xcross,flag,labelup,labeldown. - Місце,
location.*:abovebar— над свічкою,belowbar— під свічкою,topіbottom— біля верхнього та нижнього краю панелі. В окремій панелі під графіком «над свічкою» і «під свічкою» теж означають верхній і нижній край: у такої панелі своя шкала, і ціни свічок на ній не відкладені. - Розмір,
size.*:auto,tiny,small,normal,large,huge. textдодає до значка короткий підпис. Коли графік сильно віддалений і свічки вузькі, підписи ховаються, а значки залишаються.
Графічні об’єкти
Крім рядів, скрипт може малювати окремі об’єкти: підписи label.new, відрізки line.new, прямокутники box.new і таблиці table.new. Кожен виклик *.new повертає об’єкт. Його можна пересунути функціями set_* (label.set_xy, line.set_x2, box.set_top і так далі), прочитати через get_*, скопіювати через copy або видалити через delete.
По горизонталі об’єкт за замовчуванням прив’язаний до номера бара, bar_index. З параметром xloc = xloc.bar_time координата задається часом бара. Відрізку та прямокутнику параметр extend (extend.right, extend.left, extend.both) продовжує край до межі графіка.
Об’єкт залишається на графіку, поки його не видалять. Скрипт виконується на кожному барі, тому label.new без умови створить по підпису на кожен бар. Щоб тримати один об’єкт і рухати його, зберігайте його у змінній var, а старий видаляйте:
indicator("Последний пивот", overlay = true, maxLabelsCount = 50)
ph = ta.pivothigh(high, 10, 10)
var line level = na
if not na(ph) {
label.new(bar_index - 10, ph, str.tostring(ph), style = label.style_label_down,
color = color.orange, textcolor = color.white, size = size.small)
line.delete(level)
level := line.new(bar_index - 10, ph, bar_index, ph, extend = extend.right,
color = color.orange, style = line.style_dashed)
}Скрипт підписує кожен знайдений максимум і тягне пунктир від останнього з них праворуч. Попередній пунктир він при цьому видаляє.
Живих об’єктів кожного виду одночасно буває не більше 500. Коли з’являється п’ятсот перший, найстаріший зникає. Параметри maxLinesCount, maxLabelsCount і maxBoxesCount в indicator() зменшують цю межу. Значення більше за 500 урізається до 500.
Таблиці
Таблиця прив’язана не до барів, а до кута чи краю панелі та не рухається під час прокручування графіка. Місце задає position.*: top_left, top_center, top_right, middle_left, middle_center, middle_right, bottom_left, bottom_center, bottom_right. Комірки заповнює table.cell. Зручно робити це лише на останньому барі, щоб не переписувати таблицю на всій історії:
indicator("Сводка", overlay = true)
var t = table.new(position.top_right, 2, 2, bgcolor = color.new(color.black, 160))
if barstate.islast {
table.cell(t, 0, 0, "RSI", text_color = color.white)
table.cell(t, 1, 0, str.tostring(math.round(ta.rsi(close, 14), 1)), text_color = color.white)
table.cell(t, 0, 1, "ATR", text_color = color.white)
table.cell(t, 1, 1, str.tostring(math.round(ta.atr(14), 2)), text_color = color.white)
}У таблиці не більше 200 стовпців і 200 рядків. Таблиця, в якій понад 2000 комірок, не створюється.
Кольори
Іменовані кольори: color.red, color.green, color.blue, color.teal, color.orange, color.purple, color.yellow, color.white, color.black, color.gray, color.silver, color.maroon, color.navy, color.olive, color.lime, color.aqua, color.fuchsia.
Колір можна записати й кодом: #FF8800 — непрозорий, #FF880040 — із прозорістю. Остання пара цифр задає непрозорість: 00 — повністю прозорий, FF — суцільний.
color.rgb(r, g, b)збирає колір зі складників від 0 до 255. Четвертий аргумент — непрозорість, за замовчуванням 255.color.from_gradient(value, bottomValue, topValue, bottomColor, topColor)повертає колір між двома крайніми за положеннямvalueу діапазоні. Зручно розфарбовувати осцилятор від холодного до гарячого.naзамість кольору означає «не малювати».
indicator("RSI в цвете")
r = ta.rsi(close, 14)
heat = color.from_gradient(r, 30, 70, color.rgb(0, 150, 136), color.rgb(244, 67, 54))
plot(r, "RSI", color = heat, linewidth = 2)
bgcolor(r > 70 ? color.new(color.red, 30) : r < 30 ? color.new(color.teal, 30) : na, title = "Зоны")Далі
https://docs.lootx.trade/uk/loot/inputs-drawing
6Ринкові дані: кластери, дельта, OI, біржовий стакан
Що скрипт на LootScript читає крім свічок: кластери, дельта, відкритий інтерес, ставка фінансування, записана і жива історія біржового стакана, стрічка угод, скринер, інший таймфрейм і інструмент.
Окрім свічок, скрипт на LootScript читає дані потоку ордерів: кластери, дельту, відкритий інтерес, ставку фінансування, записану історію біржового стакана, живий біржовий стакан і стрічку угод, метрики скринера. Нічого вмикати не потрібно: щойно скрипт звертається, наприклад, до cluster.poc, термінал сам підписується на кластери інструмента і таймфрейма графіка — навіть якщо графік показує звичайні свічки. Коли скрипт знімають із графіка, підписка звільняється.
На цій сторінці — що є в кожному просторі імен, звідки беруться дані, на яких майданчиках вони доступні і як узяти значення іншого таймфрейма або іншого інструмента.
Головне правило: немає даних — це na, а не 0
Будь‑яке значення з цієї сторінки може виявитися na. Так відбувається, якщо майданчик не покритий сервером, таймфрейм не підтримується, історія ще завантажується або бар старший за доступну історію. Нуль означав би «торгів не було», а це інший факт: накопичена сума з підставленими нулями виглядає правдоподібно й водночас невірна.
У кожного простору є прапорець наявності — cluster.available, delta.available, oi.available тощо. Перевіряйте його або функцією na(x). Порівняння з na через == компілятор не пропустить.
indicator("Накопленная дельта без подмены нулём", overlay = false)
var float cvd = 0.0
if delta.available {
cvd := cvd + delta.value
}
plot(delta.available ? cvd : na, "CVD", color = color.teal)Чому даних немає, підказує легенда графіка поруч із назвою скрипта: «майданчик не покритий», «таймфрейм не підтримується», «дані завантажуються…», «немає відкритого стакана», «скринер недоступний».
Звідки що береться
| Простір | Що це | Історія на графіку |
|---|---|---|
cluster.* |
Кластери (футпринт) бара: об’єм по цінах | Є, з сервера кластерів |
delta.* |
Дельта агресивних покупок і продажів | Є |
oi.* |
Відкритий інтерес | Є |
funding.* |
Ставка фінансування і її розрахунки | Є |
depth.* |
Біржовий стакан, записаний сервером, по барах | Є, обмеженої глибини |
book.* |
Живий біржовий стакан | Лише останній бар |
tape.* |
Жива стрічка угод | Лише останній бар |
screener.* |
Метрики скринера по інструменту | Лише останній бар |
Кластери: cluster.*
Об’єм кожного цінового рівня всередині бару з розподілом на агресивні покупки і продажі — ті самі дані, що малює кластерний графік. Рівні нумеруються знизу вгору, від 0 до cluster.levels - 1.
| Ім’я | Що повертає |
|---|---|
cluster.available |
Чи є кластери на цьому барі |
cluster.levels |
Число цінових рівнів у барі |
cluster.price(i) |
Ціна рівня i |
cluster.bid(i) |
Агресивні покупки на рівні i |
cluster.ask(i) |
Агресивні продажі на рівні i |
cluster.total |
Весь об’єм бару |
cluster.delta |
Покупки мінус продажі по всіх рівнях |
cluster.poc, cluster.poc_index |
Ціна і номер рівня з найбільшим об’ємом |
cluster.max_cell |
Об’єм найважчої клітинки бару |
cluster.imbalance(i) |
Перекіс рівня: +1 покупки, -1 продажі, 0 немає |
cluster.stacked_buy, cluster.stacked_sell |
Ціна, з якої починається найдовша серія рівнів із перекосом |
cluster.stacked_buy_steps, cluster.stacked_sell_steps |
Довжина цієї серії в рівнях |
cluster.value_area(pct) |
Нижня й верхня межі зони вартості; pct — частка об’єму, 0.7 = 70 % |
cluster.grid_step |
Крок цінової сітки бару |
Зверніть увагу на назви: cluster.bid(i) — це покупки, які «зняли» аск, а не заявки на покупку в біржовому стакані.
Кластери є на таймфреймах від 30 секунд до одного дня.
indicator("POC и зона стоимости", overlay = true)
[vaLow, vaHigh] = cluster.value_area(0.7)
plot(cluster.poc, "POC", color = color.orange, style = plot.style_circles)
plot(vaHigh, "Верх зоны", color = color.gray, style = plot.style_linebr)
plot(vaLow, "Низ зоны", color = color.gray, style = plot.style_linebr)Дельта: delta.*
Різниця між агресивними покупками і продажами за бар. Об’єми — в монетах (базовій валюті).
| Ім’я | Що повертає |
|---|---|
delta.value |
Дельта бару: покупки мінус продажі |
delta.buy, delta.sell |
Ці дві частини окремо |
delta.cum |
Накопичена дельта від початку завантаженої історії |
delta.min, delta.max |
Мінімум і максимум бігаючої дельти всередині бару |
delta.open, delta.high, delta.low, delta.close |
Дельта бару у вигляді свічки |
delta.trades |
Число угод у барі |
delta.usd |
Дельта в валюті котирування, за сумами самих угод |
delta.available |
Чи є дельта на цьому барі |
delta.min і delta.max з кластерів не порахувати — це шлях дельти всередині бару, його рахує сервер. За ними видно, що покупці вели бар, а закрили його продавці. delta.usd точніша, ніж delta.value * close: на різкому барі ціна угод сильно відрізняється від ціни закриття.
delta.cum починається з нуля на першому завантаженому барі, тому її рівень залежить від глибини завантаженої історії. Порівнюйте зміни, а не абсолютні значення.
Дельта є на таймфреймах від 30 секунд.
indicator("Дельта и разворот внутри бара", overlay = false)
d = delta.value
reversed = delta.available and d < 0 and delta.max > -d
plot(d, "Дельта", style = plot.style_columns, color = d >= 0 ? color.teal : color.red)
plotshape(reversed, "Разворот", style = shape.xcross, location = location.top, color = color.orange, size = size.tiny)Відкритий інтерес: oi.*
| Ім’я | Що повертає |
|---|---|
oi.open, oi.high, oi.low, oi.close |
Відкритий інтерес за бар у одиницях, які публікує майданчик |
oi.coins |
Відкритий інтерес в монетах |
oi.usd |
Відкритий інтерес у валюті котирування |
oi.change |
Зміна oi.close до попереднього бару |
oi.available |
Чи є дані на цьому барі |
Одиниці oi.open…oi.close у майданчиків різні, тому для порівняння майданчиків беріть oi.coins або oi.usd. Відкритий інтерес надходить з хвилинною сіткою: на секундних таймфреймах всі значення — na.
indicator("Цена и открытый интерес", overlay = false)
dp = ta.change(close)
build = oi.available and dp > 0 and oi.change > 0
plot(oi.change, "Изменение OI", style = plot.style_columns, color = build ? color.teal : color.gray)Ставка фінансування: funding.*
| Ім’я | Що повертає |
|---|---|
funding.rate |
Прогноз ставки на найближчий розрахунок |
funding.interval_hours |
Годин між розрахунками |
funding.settled |
true на барі, де пройшов розрахунок |
funding.settled_rate |
Ставка, реально списана на цьому барі; якщо розрахунків у барі кілька — їх сума |
funding.cum |
Сума списаних ставок за завантажену історію |
funding.available |
Чи є ставка фінансування у інструмента |
Ставка — частка, а не відсотки: 0.0001 — це 0,01 %. Графік показує відсотки, мова нічого не перераховує. Для перевірки гіпотез на історії беріть funding.settled_rate: funding.rate — це прогноз, він змінюється до самого розрахунку. У спота ставки фінансування немає, на секундних таймфреймах значення — na.
indicator("Фандинг за расчёт, %", overlay = false)
plot(funding.rate * 100, "Прогноз ставки", style = plot.style_area, color = funding.rate >= 0 ? color.teal : color.red)
plotshape(funding.settled, "Расчёт", style = shape.circle, location = location.bottom, color = color.orange, size = size.tiny)Історія біржового стакана: depth.*
Біржовий стакан у тому вигляді, в якому його записав сервер, — ті самі дані, що малює теплова карта, — розкладений по барах. На відміну від живого book.*, ці значення є на кожному записаному барі. Ціни згруповані в корзини, об’єм корзини — найбільший за бар, у монетах.
| Ім’я | Що повертає |
|---|---|
depth.available |
Чи записаний стакан для цього бару |
depth.levels |
Число непорожніх корзин у барі |
depth.price(i) |
Нижня межа корзини i, за зростанням |
depth.qty(i) |
Найбільший об’єм, що стояв у корзині за бар |
depth.side(i) |
+1 біди, -1 аски, 0 корзина була по обох боках |
depth.at(price) |
Об’єм у корзині, куди потрапляє ціна |
depth.grid_step |
Розмір корзини в одиницях ціни |
depth.best_bid, depth.best_ask |
Найкращі ціни на кінець бару |
depth.max_cell |
Об’єм найважчої корзини |
depth.bid_sum(pct), depth.ask_sum(pct) |
Об’єм сторони в межах pct % від середини |
depth.imbalance(pct) |
Перекіс у тій же смузі: від -1 до +1 |
depth.max_bid(pct), depth.max_ask(pct) |
Ціна й об’єм найважчої корзини сторони в смузі |
Обмеження:
- Дані є там же, де серверна теплова карта, і на таймфреймах від секунди.
- Сервер зберігає смугу приблизно ±4 % від ціни. Поза нею
depth.atповертаєna, всередині смуги порожня корзина —0. - Глибина історії обмежена: найстаріші бари довгої історії дають
na. - Значення формуючогося бару змінюються, доки надходять дані.
indicator("Перекос записанного стакана", overlay = false)
band = input.float(1.0, "Полоса, % от цены", minval = 0.1, maxval = 4.0, step = 0.1)
imb = depth.imbalance(band)
plot(imb, "Перекос", style = plot.style_columns, color = imb >= 0 ? color.teal : color.red)Щоб намалювати записаний біржовий стакан під свічками, достатньо одного рядка heatmap.depth() в скрипті з overlay = true. Кольори й пороги поля — на сторінці Налаштування і відображення.
indicator("Записанный стакан теплом", overlay = true)
heatmap.config(palette = heatmap.inferno, low = 25)
heatmap.depth()Живий біржовий стакан і стрічка угод: book.* і tape.*
Живий біржовий стакан і стрічку ніхто не записує, тому значення є тільки на останньому барі, а в історії — завжди na. Для них потрібна відкрита панель біржового стакана того ж інструмента: інакше book.available і tape.available хибні, а в легенді — «немає відкритого стакана». У режимі реплея ці дані недоступні.
| Ім’я | Що повертає |
|---|---|
book.bid(i), book.ask(i) |
Ціна рівня i; 0 — найкраща ціна |
book.bid_qty(i), book.ask_qty(i) |
Об’єм на рівні, в монетах |
book.spread |
Найкращий аск мінус найкращий бид |
book.mid |
Середина між найкращими цінами |
book.imbalance(n) |
Перекіс об’єму по n верхнім рівням кожної сторони: від -1 до +1 |
book.available |
Чи є знімок стакана |
tape.last_price, tape.last_qty |
Ціна й об’єм останньої угоди |
tape.last_side |
+1 покупець‑агресор, -1 продавець, 0 — угод ще не було |
tape.count(ms) |
Число угод за останні ms мілісекунд |
tape.buy_volume(ms), tape.sell_volume(ms) |
Об’єм агресивних покупок і продажів за вікно |
tape.max_print(ms) |
Найбільша угода за вікно |
tape.available |
Підключена чи стрічка |
Вікно стрічки і глибину book.imbalance задають числом у коді або налаштуванням input.int. Вікно відлічується від часу останньої угоди на майданчику, а не від годинника комп’ютера. Скрипту доступний лише хвіст стрічки — близько двох тисяч останніх угод, тому на активному ринку довге вікно покаже не весь інтервал.
Коли таке значення потрапляє в plot, редактор попереджає: «Дані є тільки в реальному часі — в історії ряд порожній». Це очікувано: ліворуч від останнього бару ряд порожній. Стратегії ці дані читати не можуть — див. Стратегії і тестер.
indicator("Перекос стакана", overlay = false)
levels = input.int(20, "Уровней с каждой стороны", minval = 1, maxval = 200)
imb = book.available ? book.imbalance(levels) : na
plot(imb, "Перекос", style = plot.style_area, color = imb >= 0 ? color.teal : color.red)
hline(0, "Ноль", color = color.gray)Скринер: screener.*
Метрики скринера для інструмента графіка — ті самі числа, що в його колонках. Історії в них немає: значення є тільки на останньому барі. Вікно задається рядком, і не в кожної метрики є кожне вікно.
| Функція | Що показує | Вікна |
|---|---|---|
screener.change(w) |
Зміна ціни | "1m" "5m" "15m" "1h" "24h" |
screener.vol(w) |
Оборот | "1m" "5m" "15m" "1h" "24h" |
screener.avg_vol(w) |
Середній оборот | "1m" "5m" "15m" "1h" |
screener.rvol(w) |
Відносний об’єм | "1h" "24h" |
screener.natr(w) |
NATR | "1m" "5m" |
screener.oi_delta(w) |
Зміна відкритого інтересу | "1m" "5m" "1h" "24h" |
screener.btc_corr(w) |
Кореляція з BTC | "1m" "5m" |
screener.available |
Чи покритий інструмент скринером | — |
Вікно, якого немає в таблиці, дає na. Метрика, яка не входить у вашу підписку на скринер, — теж na. Редактор помічає вивід цих значень тим самим попередженням, що й у стакана: в історії ряд порожній.
indicator("Скринер: RVOL и NATR", overlay = false)
plot(screener.rvol("1h"), "RVOL 1h", color = color.orange)
plot(screener.natr("5m"), "NATR 5m", color = color.teal)Покриття майданчиків
| Майданчик | Кластери і дельта | Відкритий інтерес і ставка фінансування |
|---|---|---|
| Binance, Bybit, OKX, Bitget, Gate.io, MEXC, KuCoin, BingX, AsterDEX | Спот і ф’ючерси | Ф’ючерси |
| Hyperliquid | Ф’ючерси; спот — ні | Ф’ючерси |
| Binance Alpha | Ні: майданчик не публікує сторону агресора | Ні |
| Upbit | Ні | Ні |
| Дані | Таймфрейми |
|---|---|
| Кластери | Від 30 секунд до 1 дня |
| Дельта | Від 30 секунд |
| Відкритий інтерес, ставка фінансування | Від 1 хвилини |
| Історія біржового стакана | Від 1 секунди, там же, де серверна теплова карта |
| Живий біржовий стакан, стрічка угод | Будь‑які, за умови відкритої панелі біржового стакана |
| Скринер | Будь‑які, для інструментів, які бачить скринер |
Покриття визначає сервер даних, і воно може змінюватися. Надійніше за все опиратися на прапорець .available і підпис у легенді.
Інший таймфрейм і інший інструмент
request.security рахує вираз на іншій серії — старшому таймфреймі або іншій монеті — і зіставляє результат з барами графіка.
request.security(symbol, timeframe, expression, gaps = false, lookahead = false, ignore_invalid_symbol = false)- symbol — у форматі «МАЙДАНЧИК:ТИКЕР», як у TradingView:
"BINANCE:BTCUSDT.P", де.P— безстроковий ф’ючерс. Інструмент графіка —sym.ticker. - timeframe — рядок виду
"5","60","4h","1D","1W". Таймфрейм графіка —tf.period. - expression — число або кілька чисел у квадратних дужках:
[high, low].
Без зазірнення вперед. За замовчуванням бар графіка бачить значення останній закритий бар старшого таймфрейма. Тому годинна EMA на п’ятихвилинках — це сходинка, яка зсувається лише на закритті години. Так результат на історії співпадає з тим, що ви б побачили наживо.
gaps = true— значення лише на першому барі графіка, де з’явився новий старший бар, даліna.ignore_invalid_symbol = true— невідомий символ даєna. Без цього скрипт зупиняється з помилкою «Символ … невідомий».
Всередині виразу доступні свічки іншої серії й розрахунки по них. Передати туди змінну графіка не можна — лише значення налаштувань input.*. Біржовий стакан, стрічка й скринер всередині запиту не компілюються, а кластери, дельта, відкритий інтерес і ставка фінансування іншої серії дають na. У скрипта може бути до 8 різних пар «інструмент + таймфрейм» і до 32 викликів request.security.
indicator("EMA старшего таймфрейма", overlay = true)
len = input.int(20, "Длина EMA", minval = 2, maxval = 500)
tfHigh = input.timeframe("60", "Старший таймфрейм")
emaHigh = request.security(sym.ticker, tfHigh, ta.ema(close, len))
plot(emaHigh, "EMA", color = color.orange, style = plot.style_stepline)indicator("Спред к другой бирже", overlay = false)
other = input.symbol("BYBIT:BTCUSDT.P", "Сравнить с")
px = request.security(other, tf.period, close, ignore_invalid_symbol = true)
plot(close - px, "Разница", color = color.orange)Далі
https://docs.lootx.trade/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, тейк-профіт — удвічі далі.
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(): сповіщення з коду
alert(message, freq = alert.freq_once_per_bar_close)message — рядок. Числа в нього вставляють через str.tostring: "Цена " + str.tostring(close). Текст приходить у сповіщення як є, термінал його не перекладає і не править.
Частота задається константою:
| Частота | Коли спрацьовує |
|---|---|
alert.freq_once_per_bar_close |
За замовчуванням. Один раз, коли бар закрився: при першому оновленні наступного бару, за значеннями закритого |
alert.freq_once_per_bar |
У перший момент, коли виклик відбувся на цьому барі — навіть якщо бар ще формується. Далі мовчить до наступного бару |
alert.freq_all |
На кожному перерахунку живого бару, де виклик спрацював |
Частота рахується для кожного виклику alert() окремо: два виклики в одному скрипті не заглушують один одного. За один перерахунок скрипт відправляє не більше 16 сповіщень, решта відкидаються.
Приклад: сповіщення про сплеск дельти, щойно він з’явився на формуючомуся барі.
indicator("Всплеск дельты", overlay = false)
mult = input.float(3.0, "Во сколько раз больше обычного", minval = 1.5, step = 0.5)
base = ta.sma(math.abs(delta.value), 50)
spike = delta.available and math.abs(delta.value) > base * mult
plot(delta.value, "Дельта", style = plot.style_columns, color = delta.value >= 0 ? color.teal : color.red)
if spike {
alert("Всплеск дельты: " + str.tostring(delta.value, "#.##"), freq = alert.freq_once_per_bar)
}Там, де дельти немає, delta.available хибне й сповіщення не спрацьовує — детальніше про правило na в розділі Дані ринку.
alertcondition(): умова, яку вмикаєте ви
alertcondition(condition, title, message)condition — логічний вираз, title — назва умови, message — текст сповіщення. title і message — рядки прямо в коді, зібрати їх із чисел не можна. Без message у сповіщення піде title.
Умова дзвонить лише на закритті бару, не частіше разу за бар і тільки якщо вона увімкнена. За замовчуванням усі умови вимкнені.
Додайте скрипт на графік
В редакторі скриптів натисніть Додати на графік.
Відкрийте вкладку «Вивід»
У консолі під кодом виберіть вкладку Вивід. Там показані значення рядів на останньому барі і список «Умови алертів (alertcondition) — увімкніть потрібні».
Увімкніть умови
Позначте галочками умови, за якими хочете отримувати сповіщення. Якщо скрипт стоїть на кількох графіках, у кожного свій список.
Історія мовчить
Сповіщення дзвонять тільки на живих оновленнях. Перший розрахунок після завантаження графіка, після зміни інструмента і після підвантаження більш старшої історії вважається історією: на минулих барах ні alert(), ні alertcondition() не спрацьовують. Тому, додавши скрипт на графік, ви не отримаєте купу сповіщень за минуле.
Перевірити умову на історії можна візуально: намалюйте її міткою plotshape — вона покаже кожний бар, де сповіщення б спрацювало.
Куди приходить сповіщення
Кожне спрацювання:
- Записується в стрічку «Оповіщення» з джерелом «Скриптовий алерт». У записі — текст повідомлення, ім’я скрипта і, для
alertcondition(), назва умови. Стрічка відкривається окремим вікном або панеллю робочого простору; фільтр Джерела залишає в ній лише скриптові алерти. - Програє звук. Його вибирають в Налаштування → Сповіщення, блок «Звуки», рядок «Скриптовий алерт»: список звуків і перемикач, який вимикає звук.
- Показує плашку «Ім’я скрипта: текст».
- Підсвічує вкладку робочого простору, де стоїть графік зі скриптом.
Інші сповіщення терміналу описані на сторінці Алерти і рівні.
Журнал: log.*
Для налагодження умов є журнал. log.info, log.warning і log.error пишуть рядок у вкладку Журнал консолі редактора — туди ж, де Проблеми і Вивід.
- Журнал, як і сповіщення, пишеться тільки на живих оновленнях — на історії мовчить.
- На один бар — не більше 16 рядків, решта відкидаються.
- Консоль зберігає останні 256 рядків. Більш старі витісняються, їх кількість показано як «витіснено рядків». Кнопка Очистити очищує журнал.
indicator("Проверка условия", overlay = true)
len = input.int(20, "Канал, баров", minval = 2, maxval = 500)
upper = ta.highest(high, len)[1]
plot(upper, "Верх канала", color = color.teal)
if barstate.islast {
log.info("Закрытие " + str.tostring(close) + ", верх канала " + str.tostring(upper))
}Приклад: пробій каналу
Скрипт малює верхню межу каналу, відзначає пробої трикутником і повідомляє про них двома способами: alert() дзвонить завжди, а умова «Пробой вверх» — тільки якщо ви її увімкнули.
indicator("Пробой канала с алертом", overlay = true)
len = input.int(20, "Канал, баров", minval = 2, maxval = 500)
upper = ta.highest(high, len)[1]
breakUp = ta.crossover(close, upper)
plot(upper, "Верх канала", color = color.teal)
plotshape(breakUp, "Пробой", style = shape.triangleup, location = location.belowbar, color = color.teal, size = size.small)
if breakUp {
alert("Пробой вверх, цена " + str.tostring(close), alert.freq_once_per_bar_close)
}
alertcondition(breakUp, "Пробой вверх", "Цена закрылась выше канала")Межа береться зі зсувом [1] — по попередніх барах, інакше поточний максимум завжди був би всередині каналу. Частота freq_once_per_bar_close означає, що сповіщення прийде після закриття бару над каналом, а трикутник на графіку залишиться саме там, де сповіщення пролунало. У реальному скрипті зазвичай лишають один із двох способів — тут обидва для порівняння.
Далі
https://docs.lootx.trade/uk/loot/alerts
9ШІ‑помічник у редакторі
Чат із моделлю ШІ в редакторі LootScript: пише й править скрипти, перевіряє їх на свічках, відповідає на питання про ринок. Які провайдери доступні, де ввести ключ і що передається з комп’ютера.
У редакторі LootScript є чат із моделлю ШІ. Опишіть словами, який індикатор потрібен — помічник напише код просто в редакторі, скомпілює його, прогоне на реальних свічках і розкаже, що вийшло. Він також править готові скрипти, пояснює чужий код і відповідає на питання про ринок за даними терміналу.
Модель ви обираєте самі: хмарну — зі своїм ключем API, або локальну — на своєму комп’ютері. Запити йдуть від терміналу безпосередньо до обраного провайдера, без серверів LootX.
Як відкрити помічника
- Натисніть ƒ на панелі графіка — відкриється вікно Індикатори.
- Натисніть Редактор… поруч зі рядком пошуку або відкрийте свій скрипт.
- У верхній панелі редактора, поруч із Додати на графік, натисніть Помічник.
Чат з’явиться праворуч від коду. Ширину можна змінювати, перетягуючи роздільник. Хрестик у шапці чату (Сховати чат) прибирає його, не видаляючи розмову; повторне натискання Помічник повертає.
Підключення моделі
Відкрийте картку підключення
При першому запиті картка відкриється автоматично. Пізніше її викликає шестерня Ключ і підключення у шапці чату.
Оберіть провайдера
Список — у таблиці нижче. За замовчуванням обрано Claude.
Вставте ключ API
Під полем є посилання Отримати ключ на … — воно веде в кабінет провайдера. Збережений ключ у полі не показується: залиште його порожнім, щоб не змінювати, або натисніть Видалити ключ.
Перевірте модель і збережіть
Поле Модель заповнене моделлю за замовчуванням, у підказках — ще кілька. Ім’я можна вписати будь‑яке, яке знає провайдер. Натисніть Зберегти.
| Провайдер | Що потрібно |
|---|---|
| Claude | Ключ API Anthropic. Підписка Claude не підходить — Anthropic забороняє стороннім програмам працювати по ній. |
| Gemini | Ключ API Google. Підписка Gemini не підходить з тієї ж причини. |
| OpenAI, DeepSeek, Grok, Mistral, Qwen, Kimi, GLM, Groq | Ключ API провайдера. |
| OpenRouter | Ключ OpenRouter: через нього доступні моделі різних компаній. |
| Ollama, LM Studio | Ключ не потрібен: модель працює на вашому комп’ютері. Запустіть сервер, завантажте модель і впишіть її назву. |
| Сумісний з OpenAI | Будь‑який сервер з API у форматі OpenAI Chat Completions: шлюз, vLLM, корпоративний проксі. Укажіть адресу (зазвичай закінчується на /v1), модель і ключ, якщо сервер його вимагає. |
Хмарні запити оплачуються за тарифом вашого облікового запису у провайдера, окремо від LootX. Після кожної відповіді в чаті видно, скільки токенів витрачено на вхід і на вихід.
Локальній моделі потрібна підтримка виклику інструментів (tool calling). Без неї помічник не зможе писати в редактор і перевіряти код.
Проксі і власна адреса
Якщо сервіс провайдера недоступний з вашої мережі безпосередньо, вкажіть проксі в полі Проксі — http://host:port або socks5://логін:пароль@host:port. Проксі спільний для всіх провайдерів. Поле Адреса API (для власного шлюзу) потрібно тільки якщо ви заходите до провайдера через власний шлюз.
Що вміє помічник
- Пише новий скрипт за описом і відразу кладе код у редактор.
- Править готовий — точково, не переписуючи файл повністю.
- Перевіряє себе. Компілює код і запускає його на реальних свічках — за замовчуванням на інструменті і таймфреймі графіка, до 5000 останніх барів, за запитом на будь‑якому іншому. Перевіряє результати в кожному ряді і наявність помилок виконання.
- Додає скрипт на графік, коли ви про це просите.
- Відповідає про ринок. Бере свічки будь‑якого інструмента з терміналу, метрики скрінера (волатильність, обсяг, відкритий інтерес, ставка фінансування, спред) і ранжирує ринок: «Які ф’ючерси зараз найволатильніші?».
- Звіряється зі довідником мови, дивиться вбудовані індикатори і скрипти з вашої бібліотеки.
Кожен крок видно в стрічці угод рядком: «Компілюю», «Запускаю на свічках», «Правлю код». Якщо модель показує хід міркувань, він згорнутий у блок Хід думок. Відповідь можна перервати кнопкою Зупинити.
Усе, що помічник пише в редактор, відміняється звичайним Ctrl+Z. Якщо код у відповіді прийшов блоком, у його шапці є кнопки. У цілого скрипта це У редактор — замінити код у редакторі, у фрагмента — Вставити у позицію курсора. Копіювати є в обох.
Швидкі команди
Наберіть / у полі вводу — з’явиться підказка. Ті самі команди є кнопками в порожньому чаті. Текст після команди — ваше уточнення: /fix дивись на обсяг.
| Команда | Що робить |
|---|---|
/fix |
Знаходить і виправляє помилки: компілює, запускає на свічках, лагодить помилки і ряди, де одні na. Зберігає вашу ідею й стиль, наприкінці перераховує правки. |
/explain |
Пояснює простими словами, що робить скрипт, на що впливає кожне налаштування, що він малює і як читати сигнали. Код не змінює. |
/optimize |
Прискорює скрипт, не змінюючи результат: замінює самописні цикли вбудованими функціями, прибирає зайву роботу і перевіряє прогоном, що значення не змінилися. |
Інше слово після косої відправляється моделі як звичайне питання.
Картинки і знімки графіка
До питання можна додати картинку: скріпкою під полем вводу, вставкою з буфера (Ctrl+V) або перетягнувши файл у чат. Кнопка з графіком поруч зі скріпкою додає знімок тієї панелі, куди додається скрипт. В одному питанні — до шести картинок. Перед відправкою великі зображення зменшуються.
Не всі моделі бачать картинки. Якщо обрана модель не бачить, чат попередить до відправлення. Якщо термінал не знає, чи бачить модель картинки, і провайдер відхилить питання, картинки повернуться в поле вводу.
Історія розмов
Розмова прив’язана до скрипту. Відкриєте інший скрипт — у чаті відобразиться його розмова. Закриєте редактор або перезапустите термінал — розмова залишиться на місці.
- У нового, ще не збереженого скрипта розмова на диск не пишеться. Вона збереже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: стовпчики розмаху бара, підсвічені, коли розмах удвічі більше середнього.
//@version=5
indicator("Range spike", overlay=false)
len = input.int(20, "Length")
avgRange(n) =>
r = high - low
ta.sma(r, n)
base = avgRange(len)
spike = high - low > base * 2
plot(high - low, style=plot.style_columns, color=spike ? color.orange : color.new(color.gray, 60))
plot(base, color=color.blue, trackprice=true)Так його записує конвертер:
// Импортировано из скрипта на Pine Script (версия 5). Заметки конвертера:
//
// Строка 6: переписано: avgRange — неявный возврат последнего оператора записан как return
// Строка 9: пересчитано: transp → alpha — прозрачность 0…100 пересчитана в альфу 0…255
// Строка 10: аргумент снят: plot: trackprice — такого параметра в LootScript нет
indicator("Range spike", overlay = false)
len = input.int(20, "Length")
func avgRange(n) {
r = high - low
return ta.sma(r, n)
}
base = avgRange(len)
spike = high - low > base * 2
plot(high - low, color = spike ? color.orange : color.new(color.gray, 102), style = plot.style_columns)
plot(base, color = color.blue)Функція отримала дужки і return, прозорість 60 стала альфою 102, а trackprice знято — такого параметра немає. Нотатка «аргумент знято» просить перевірити, чи потрібний цей параметр за змістом. Тут він лише малював лінію останнього значення, і скрипт працює без нього.
Як перевірити і допрацювати
- Прочитайте шапку. Почніть з рядків з видами «аргумент знято», «припущення», «немає в цій збірці» та «не розібрано».
- Подивіться вкладку «Проблеми» у консолі редактора. Скрипт з помилками на графік не додасться.
- Додайте на графік і порівняйте з тим, що показував оригінал, на кількох ділянках історії.
- Попросіть помічника. Відкрийте ШІ‑помічника і наберіть
/fix— він скомпілює скрипт, прогонить його на свічках і виправить помилки. Можна додати уточнення:/fix розбери нотатки конвертера в шапці./explainрозповість, що робить скрипт.
Що не переноситься
- Функції, яких немає в терміналі. Ім’я лишається в коді, нотатка «немає в цій збірці» і помилка компілятора вказують на те саме місце. Замініть виклик вручну або попросіть помічника підібрати аналог.
- Багаторядкові рядки, імпорт чужих бібліотек, експорт функцій. Конвертер переносить те, що може записати, і позначає решту.
- Більше трьох ліній. Панель графіка малює тільки перші три
plotскрипта. Зайві ряди рознесіть по окремих скриптах. - Реальна торгівля. Оголошення
strategy(…)переноситься, але стратегія LootScript торгує тільки в тестері стратегій — на симульованому рахунку.
Далі
https://docs.lootx.trade/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 не заважають.
// Так не можна: оголошення не перше
len = input.int(14, "Довжина")
indicator("RSI")indicator("RSI")
len = input.int(14, "Довжина")Друге оголошення в тому ж файлі дає LS1008: у скрипта воно одне.
LS2002 — невідоме ім’я
«Невідоме ім’я «…» — перевірте написання або оголосіть його вище». Найчастіше це опечатка або функція без простору імен: всі індикаторні функції в ta, математика — в math, кольори — в color.
avg = sma(close, 20)avg = ta.sma(close, 20)Та сама помилка буде, якщо змінну читають раніше рядка, де її оголосили. Повний список імен — у довіднику функцій.
LS2008 — порівняння з na
«Порівняння з na завжди хибне — використовуйте na(x)». Будь‑яке порівняння з na, включно з == і !=, дає false, тому компілятор таку запис не пропустить.
x = ta.sma(close, 50)
plot(x == na ? close : x)x = ta.sma(close, 50)
plot(na(x) ? close : x)Коротше те саме пишеться через ??: plot(x ?? close).
LS2014 — значення змінюється від бару до бару там, де потрібна константа
««…» в «…» вимагає значення не слабшого за input, а передано series — візьміть input.*(…) або літерал». Довжина вікна ta.* має бути відома до першого бару. Довжина, яку вибирають за умовою на кожному барі, не підходить.
len = close > open ? 10 : 20
avg = ta.sma(close, len)Порахуйте обидва варіанти і вибирайте результат, а не довжину:
fast = ta.sma(close, 10)
slow = ta.sma(close, 20)
avg = close > open ? fast : slowЯкщо довжину має задавати користувач, візьміть її з input.int(...).
LS3004 — виклик ta.* залежить від змінної з гілки
«Аргумент «…» не можна обчислити поза гілкою — винесіть виклик ta.* на верхній рівень». Функції ta.* пам’ятають попередні бари, тому компілятор обчислює їх на кожному барі, навіть якщо виклик написаний всередині if. Якщо аргумент оголошено лише всередині гілки, на інших барах його просто нема.
var float avgBody = na
if close > open {
body = close - open
avgBody := ta.sma(body, 10)
}body = close - open
avgBody = ta.sma(body, 10)LS2017, LS2007, LS1006 — рядки, умови й порівняння
У цих трьох помилок спільна причина: LootScript не приводить типи мовчки.
| Код | Повідомлення | Як виправити |
|---|---|---|
| LS2017 | «Рядок не можна додавати до числа (… + …) — використовуйте str.tostring(…)» | "RSI " + str.tostring(r) замість "RSI " + r |
| LS2007 | «Умова має бути bool, а тут …» | if volume > 0 замість if volume — числа не мають істинності |
| LS1006 | «Порівняння не ланцюжаться — напишіть a < b and b < c» | low < close and close < high замість low < close < high |
LS2018 і LS2019 — ім’я вже зайнято
««…» вже оголошено в цій області» (LS2018) — змінну оголосили вдруге через =. Щоб змінити значення, використовуйте :=.
level = high
level := low««…» затемнює вбудоване ім’я — оберіть інше» (LS2019) — змінна, функція чи тип названі так само, як вбудований ряд чи функція: close, time, hour, volume. Перейменуйте: startHour замість hour. Імена просторів на кшталт color або position для змінних можна використовувати.
LS2004 і LS2005 — аргументи виклику
««…» очікує … аргумент(ів), а передано …» (LS2004) і «У «…» немає параметра «…»» (LS2005). Звірте виклик із сигнатурою в довіднику: імена параметрів пишуться точно так, як там вказано.
plot(close, colour = color.red)plot(close, color = color.red)LS3011 і LS5011 — стратегії
«strategy.* доступно лише в strategy(…)» (LS3011): заявки і стан позиції є тільки у скрипта, оголошеного через strategy(...). Замініть indicator("…") на strategy("…").
«Стратегія читає «…»: у біржового стакана і стрічки угод немає історії, бектест був би фікцією» (LS5011): стратегія перевіряється на історії, а у book.* і tape.* історії нема — на кожному минулому барі там na.
strategy("Перекіс стакана")
if book.imbalance(10) > 0.5 {
strategy.entry("L", strategy.long)
}Для історії стакана є простір depth: там, де стакан записано, воно дає значення на кожному барі.
strategy("Перекіс стакана")
if depth.imbalance(1.0) > 0.5 {
strategy.entry("L", strategy.long)
}LS5000–LS5006 — попередження про перемальовування
Ці попередження не заважають скрипту працювати. Вони кажуть, що лінія на історії виглядатиме інакше, ніж її бачили вживу:
- LS5001 — на графік доходить значення, яке є лише на живому барі (
barstate.isrealtime,barstate.isnew). - LS5000 — на графік доходить змінна
varip: вона накопичує тики живого бара, яких в історії нема. - LS5006 — на графік доходять
book.*абоtape.*: на історії ряд пустий. - LS5003 — значення старшого таймфрейму з
request.securityбез[1]: незакритий бар ще зміниться. - LS5002 —
lookahead = trueвrequest.security: на історії скрипт бачить майбутнє. - LS5005 — на графік доходить
math.randomабоtimenow: два прогони дадуть різні лінії.
Якщо так і задумано — наприклад, індикатор потрібен лише для живої торгівлі — попередження можна залишити.
LS3016 — налаштування прийнята і нічого не робить
Це зведення, а не помилка. Воно трапляється в скриптах, перенесених з інших платформ: параметр існує для сумісності, але в терміналі на нього нічого не впливає. Друга частина повідомлення пояснює чому.
| Що написано | Пояснення в повідомленні |
|---|---|
maxBarsBack в оголошенні |
історія завантажується колонкою цілком |
format, precision, scale в оголошенні |
шкалою значень і її форматом керує термінал |
timeframe в оголошенні |
скрипт рахується на таймфреймі графіка, інший дає request.security |
Товщина, стиль або інша налаштування виводу, задана виразом, а не константою (колір plot та відміток може змінюватися по барам) |
ця збірка читає таку налаштування лише як константу |
color у четвертого і наступних plot |
панель малює тільки перші три ряди |
location.absolute у plotshape або plotchar |
у відмітки немає ряду, до значення якого її можна притиснути |
display, якого у ряду немає |
у цього ряду немає такої поверхні |
Помилки виконання
Помилка виконання зупиняє скрипт на тому барі, де вона трапилася. Текст з’являється у вкладці «Вивід» у вигляді «Скрипт зупинено: LS6004: …».
LS6004 і LS6005 — скрипт працює занадто довго
«Скрипт вичерпав бюджет операцій на бар — спростіть цикл» (LS6004) і «Скрипт перевищив ліміт часу на проходження» (LS6005). На кожному барі є бюджет у 2 000 000 операцій. Час теж обмежено: весь прогін по історії — 2 секунди, один тік живого бара — 20 мс. Майже завжди причина — цикл, який не завершується або обходить забагато даних на кожному барі.
var int n = 0
i = 0
while i < 10 {
n := n + 1
}var int n = 0
i = 0
while i < 10 {
n := n + 1
i := i + 1
}LS6002 і LS5004 — читання майбутнього
Індекс історії x[n] не може бути від’ємним: close[-1] означав би наступний бар. Якщо від’ємне число написано прямо в тексті, компілятор зупинить його відразу (LS5004). Якщо воно вийшло при обчисленні, скрипт зупиниться на барі з помилкою «Від’ємне зміщення історії — читати майбутнє не можна» (LS6002). Індекс, більший за число завантажених барів, помилкою не вважається — він дає na.
LS6001, LS6007, LS6019 — колекції й об’єкти
- LS6001 «Індекс … поза межами» —
array.get,array.setабоmatrix.getпоза розміром. Перевіряйтеarray.size(a)перед зверненням. - LS6007 «Звернення до порожнього об’єкта (na)» — колекцію оголосили, але не створили:
var array<float> a = na, а потімa.push(x). Створіть її черезarray.new<float>(). - LS6019 «Об’єкт малювання вже видалено або витіснено по стелі — створіть його заново». Одночасно живе 500 об’єктів одного виду, найстаріший витісняється. Підніміть ліміт через
maxLinesCount,maxLabelsCountабоmaxBoxesCountв оголошенні або пере використайте об’єкт черезset_*.
LS6017 і LS6018 — інструмент і таймфрейм у request.security
«Символ «…» невідомий — перевірте формат «МАЙДАНЧИК:СИМВОЛ» або задайте ignore_invalid_symbol = true» (LS6017) і «Таймфрейм «…» не розбирається — очікується «5», «60», «4h», «1D», «1W»» (LS6018). З ignore_invalid_symbol = true невідомий інструмент дає na замість зупинки.
Межі виконання
| Що обмежено | Межа | Код при перевищенні |
|---|---|---|
| Операцій на бар | 2 000 000 | LS6004 |
| Час проходу по історії / тика живого бара | 2 с / 20 мс | LS6005 |
| Елементів масиву | 100 000 | LS6003 |
| Пар у словнику | 50 000 | LS6003 |
| Елементів матриці | 1 000 000 | LS6003 |
Довжина вікна ta.* |
100 000 барів | LS6034 |
| Довжина одного рядка | 100 000 символів | LS6014 |
| Ячейок у таблиці | 2000 | LS6029 |
| Слойів теплового поля | 4 (від 0 до 3) | LS6036 |
| Об’єктів малювання одного виду | 500 за замовчуванням | старі витісняються |
Різних пар «інструмент + таймфрейм» у request.security |
8 | — |
Викликів request.security |
32 | LS4009 при компіляції |
Коли помилки немає, але значення відсутнє
Багато ситуацій, які в інших мовах зламали б програму, в LootScript дають na — пропуск на графіку, а не зупинку:
- арифметика з
naдаєna:close - xпри порожньомуx— теж порожньо; x[n]глибше за початок історії —na;- цілочисельний поділ на нуль —
na, а дробовий поділ на нуль скрипт не зупиняє; book.*,tape.*іscreener.*на історичних барах —na;- кластери, дельта, відкритий інтерес і історія біржового стакана —
naна барах, де даних нема. Перевіряйтеcluster.available,delta.availableі суміжні прапорці; ta.*на перших барах, поки вікно не заповнилося, —na.
na на графіку ніколи не малюється нулем: лінія переривається. Щоб підставити значення, використовуйте nz(x), x ?? запасне або fixnan(x).
Усі коди
LS0001–LS0009 і LS0999 — читання тексту
| Код | Повідомлення | Що робити |
|---|---|---|
| LS0001 | Неочікуваний символ «…» | Приберіть символ, якого немає в мові |
| LS0002 | Рядок не закрито — додайте закриваючу лапку до кінця рядка | Закрийте лапку на тій же стрічці |
| LS0003 | Блочний коментар не закрито — додайте */ | Закрийте /* … */ |
| LS0004 | Невідома escape-послідовність «…» у рядку | Допустимі \n, \r, \t, \0, \\, \", \' і \u{…}; одиночну \ подвоїте |
| LS0005 | Невірний числовий літерал «…» | Перевірте запис числа |
| LS0006 | Число «…» не вміщується в тип | Зменшіть число |
| LS0007 | Невірний літерал кольору «…» — очікується #RRGGBB або #RRGGBBAA | Шість або вісім шістнадцяткових цифр |
| LS0008 | Роздільник розрядів «_» стоїть на початку, наприкінці або подвоєний | Пишіть 1_000_000 |
| LS0009 | Невірна директива версії — очікується #version <число> першою рядком | #version 1 у першому рядку |
| LS0999 | Компілятор не впорався з цим файлом — це дефект збірки, повідомте про нього | Повідомте в підтримку, додайте скрипт |
LS1000–LS1012 — розбір
| Код | Повідомлення | Що робити |
|---|---|---|
| LS1000 | Неочікувано: … | Перевірте рядок на зайві символи |
| LS1001 | Очікувалося «…», а зустрілося … | Найчастіше не закрито дужку |
| LS1002 | Очікувалося вираження, а зустрілося … | Після оператора або коми бракує значення |
| LS1004 | Очікувалося ім’я, а зустрілося … | Після var, func, . потрібно ім’я |
| LS1005 | Очікувався блок в фігурних дужках, а зустрілося … | Додайте { … } |
| LS1006 | Порівняння не ланцюжаться — напишіть a < b and b < c | Розбийте на два порівняння через and |
| LS1008 | Друге оголошення скрипта — у скрипта може бути тільки одне | Залиште одне оголошення |
| LS1009 | Немає оголошення скрипта — почніть з indicator(“Назва”) | Першим рядком — indicator, strategy або library |
| LS1010 | Занадто глибока вкладеність (більше 64) — винесіть частину в функцію | Розбийте вираз або блок |
| LS1012 | Тіло if / for / while пишеться в фігурних дужках: if cond { … } | Додайте фігурні дужки |
LS2000–LS2030 — типи і імена
| Код | Повідомлення | Що робити |
|---|---|---|
| LS2000 | Невідповідність типів: очікувався …, а отримано … | Передайте значення потрібного типу |
| LS2001 | Немає перетворення … в … | Перетворіть явно: str.tostring, math.round |
| LS2002 | Невідоме ім’я «…» — перевірте написання або оголосіть його вище | Виправте опечатку, додайте простір (ta.), оголосіть вище |
| LS2003 | «…» — не функція, викликати не можна | Приберіть дужки: це ряд або константа |
| LS2004 | «…» очікує … аргумент(ів), а передано … | Звірте число аргументів зі довідником |
| LS2005 | У «…» немає параметра «…» | Виправте ім’я параметра |
| LS2006 | Аргумент «…» передано двічі | Приберіть повтор |
| LS2007 | Умова має бути bool, а тут … | Порівняйте явно: x > 0, not na(x) |
| LS2008 | Порівняння з na завжди хибне — використовуйте na(x) | na(x) замість x == na |
| LS2014 | «…» в «…» вимагає значення не слабшого за …, а передано … — візьміть input.*(…) або літерал | Літерал, input.* або константа замість ряду |
| LS2015 | «…» оголошено константою — присвоювати не можна; оголосіть через var | Налаштування input.*, змінну циклу і параметр функції змінювати не можна — скопіюйте значення в свою змінну |
| LS2017 | Рядок не можна додавати до числа (… + …) — використовуйте str.tostring(…) | str.tostring або str.format |
| LS2018 | «…» вже оголошено в цій області | := для нового значення або інше ім’я |
| LS2019 | «…» затемнює вбудоване ім’я — виберіть інше | Перейменуйте |
| LS2020 | Гілки дають різні типи: … і … | Приведіть гілки до одного типу |
| LS2021 | switch без гілки за замовчуванням «=> …» — додайте її | Додайте => значення |
| LS2022 | У «…» не виведено тип елемента — вкажіть його: … | array.new<float>() |
| LS2028 | У поля «…» типу «…» не вказано тип — напишіть його перед іменем: float … | float price в оголошенні type |
| LS2029 | export «…»: у експортованої функції мають бути вказані типи всіх параметрів і тип результату | Вкажіть типи |
| LS2030 | «…» в «…» читається до першого бару — потрібен літерал або іменована константа | В оголошенні — лише постійні значення |
LS3000–LS3033 — зміст програми
| Код | Повідомлення | Що робити |
|---|---|---|
| LS3002 | «…» викликає саму себе — рекурсія в LootScript заборонена | Замініть рекурсію циклом |
| LS3003 | Взаємна рекурсія заборонена: … | Розірвіть коло викликів |
| LS3004 | Аргумент «…» не можна обчислити поза гілкою — винесіть виклик ta.* на верхній рівень | Обчисліть аргумент і виклик поза if |
| LS3006 | «…» затемнює ім’я з зовнішньої області (попередження) | Перейменуйте внутрішню змінну |
| LS3007 | «…» поза циклом | break і continue — тільки в циклі |
| LS3008 | return поза функцією | return — тільки в тілі функції |
| LS3009 | export «…» можливий тільки в library(…) | Приберіть export або зробіть файл бібліотекою |
| LS3010 | «…» без жодного рівня (profit/loss/stop/limit/trail) — порожня операція (попередження) | Задайте стоп, тейк або трейлінг |
| LS3011 | strategy.* доступно тільки в strategy(…) | Оголосіть скрипт через strategy(...) |
| LS3012 | У бібліотеці не можна малювати і оголошувати входи: … | Перенесіть вивід і налаштування в індикатор |
| LS3013 | «…» всередині request.security не стане рядком налаштувань — оголосіть вхід вище і передайте його значення | Оголосіть input.* вище і передайте змінну |
| LS3016 | Налаштування «…» прийнята і нічого не робить: … (зведення) | Можна залишити або видалити |
| LS3018 | Бібліотека «…» не знайдена в папці бібліотек — ім’я береться з її library(“…”, N), а не з імені файлу | Перевірте ім’я в оголошенні бібліотеки |
| LS3019 | Бібліотеки «…» версії … немає; встановлені: … | Вкажіть встановлену версію |
| LS3020 | «…» всередині request.security: у біржового стакана і стрічки угод немає історії на чужій серії | Приберіть book.*, tape.* з виразу |
| LS3025 | Функція «…» оголошена, але не викликається — її тіло перевірено лише пробно (попередження) | Викличіть функцію або видаліть |
| LS3026 | «…» вимагає стоп, від якого рахувати розмір: loss/stop у вході або в strategy.exit |
Додайте стоп до входу або strategy.exit |
| LS3028 | Ця збірка не підтримує: … | Перепишіть без цієї конструкції |
| LS3029 | Ветка switch для «…» повторюється — друга недосяжна | Приберіть повтор |
| LS3030 | «…» — змінна графіка, а вираз request.security рахується на іншій серії; передайте значення через input.* або порахуйте його в середині виразу |
Пообчислюйте всередині виразу |
| LS3031 | Бібліотеки імпортують одна одну по колу: … | Розірвіть коло імпортів |
| LS3032 | У бібліотеці «…» допустимі тільки оголошення функцій і імпорти — тут … | Приберіть інший код з бібліотеки |
| LS3033 | Бібліотека «…» не компілюється (…) — відкрийте її в редакторі і виправте | Виправте помилку в самій бібліотеці |
LS4000–LS4009 — межі компіляції
| Код | Повідомлення | Що робити |
|---|---|---|
| LS4000 | Забагато рядів: … при ліміті 512 — приберіть зайві ta.* або пере використайте змінні |
Скоротіть число викликів ta.* і змінних з історією |
| LS4001 | Програма надто велика (більше 4096 вбудувань) — спростіть функції | Зменшіть число викликів користувацьких функцій |
| LS4002 | Забагато plot — панель малює не більше трьох рядів |
Виводів — рядів plot, відміток plotshape і plotchar, фону bgcolor — не більше 64; малюються перші три plot |
| LS4009 | Забагато викликів request.security: …, ліміт 32 |
Об’єднайте виклики |
LS5000–LS5013 — перерисовка і тестер
| Код | Повідомлення | Що робити |
|---|---|---|
| LS5000 | Значення varip доходить до виводу — на історії воно буде іншим (перемальовування) (попередження) |
Використайте var, якщо потрібна однакова історія |
| LS5001 | Значення лише живого бара доходить до виводу — на історії його нема (перемальовування) (попередження) | Використайте barstate.isconfirmed |
| LS5002 | lookahead = true читає майбутнє — на історії результат недосяжний у реальному часі (попередження) |
Приберіть lookahead = true |
| LS5003 | Старший таймфрейм без зсуву — незакритий бар перемалюється; додайте [1] (попередження) |
request.security(…, close[1]) |
| LS5004 | Від’ємне зміщення зсуває вивід у минуле — на історії лінія знає майбутнє | Приберіть від’ємний індекс x[-n] |
| LS5005 | Недіетерміноване значення доходить до виводу — два прогони дадуть різний ряд (попередження) | Не виводьте math.random і timenow на графік |
| LS5006 | Дані є лише в реальному часі — на історії ряд пустий (попередження) | Для історії біржового стакана використайте depth.* |
| LS5011 | Стратегія читає «…»: у біржового стакана і стрічки угод немає історії, бектест був би фікцією | Приберіть book.*, tape.* зі стратегії |
| LS5012 | Стратегія заглядає вперед («…») — звіт позначено як недосяжний у реальному часі (попередження) | Приберіть lookahead = true |
| LS5013 | «…» увімкнено: заявки виконуються по закриттю бара, звіт позначено (зведення) | Приберіть processOrdersOnClose, якщо потрібен реалістичний звіт |
LS6000–LS6036 — виконання
| Код | Повідомлення | Що робити |
|---|---|---|
| LS6001 | Індекс … поза межами | Перевірте розмір колекції перед зверненням |
| LS6002 | Від’ємне зміщення історії — читати майбутнє не можна | Індекс історії має бути ≥ 0 |
| LS6003 | Перевищено ліміт розміру колекції (…) — колекція створена в рядку … | Обмежте ріст: видаляйте старі елементи |
| LS6004 | Скрипт вичерпав бюджет операцій на бар — спростіть цикл | Перевірте умову виходу з циклу |
| LS6005 | Скрипт перевищив ліміт часу на проходження | Зменшіть роботу на кожному барі |
| LS6007 | Звернення до порожнього об’єкта (na) | Створіть колекцію або об’єкт до звернення |
| LS6014 | Рядок довший за ліміт у 100000 знаків — скоротіть її або збирайте по частинах | Скоротіть рядок |
| LS6015 | Невідомий часовий пояс «…» — потрібен ідентифікатор IANA, наприклад «Europe/Berlin» | Пояс у форматі IANA |
| LS6017 | Символ «…» невідомий — перевірте формат «МАЙДАНЧИК:СИМВОЛ» або задайте ignore_invalid_symbol = true | Виправте символ |
| LS6018 | Таймфрейм «…» не розбирається — очікується «5», «60», «4h», «1D», «1W» | Виправте таймфрейм |
| LS6019 | Об’єкт малювання вже видалено або витіснено по стелі — створіть його заново | Перевіряйте об’єкт або підніміть ліміт |
| LS6020 | str.format: плейсхолдеру {…} не передано аргумент | Передайте аргумент для кожного {n} |
| LS6021 | str.match: шаблон вичерпав бюджет кроків — спростіть його | Спростіть регулярний вираз |
| LS6026 | Вичерпано загальний бюджет колекцій скрипта (… ячеєк) — не влізла колекція з рядка … | Скоротіть число або розмір колекцій |
| LS6027 | Недопустимий аргумент «…» в … | Наприклад, від’ємний розмір в array.new |
| LS6028 | Вичерпано бюджет рядків скрипта (…) — пере використайте рядки замість нових на кожному барі | Не збирайте нові рядки на кожному барі |
| LS6029 | У таблиці більше 2000 ячеєк — це ліміт панелі | Зменшіть таблицю |
| LS6030 | Ячейка таблиці поза сіткою: … | Номер стовпця і рядка — у межах розміру таблиці |
| LS6031 | Вбудована функція «…» оголошена, але не реалізована — це дефект збірки, повідомте про нього | Повідомте в підтримку |
| LS6032 | Хендл не вказує на об’єкт потрібного виду — об’єкт звільнено або хендл з іншого прогона | Не зберігайте посилання на видалені об’єкти |
| LS6033 | Поле … поза оголошенням типу «…» — це дефект збірки, повідомте про нього | Повідомте в підтримку |
| LS6034 | Довжина вікна … більша за ліміт 100000 — таке вікно не поміститься в пам’ять | Зменшіть довжину вікна |
| LS6035 | Крок циклу дорівнює нулю — лічильник не зрушує, і кінець недосяжний | by у циклі for не може бути нулем |
| LS6036 | Слой тепла … поза 0…3 | layer від 0 до 3 |
Коди, які ця версія не видає
Ці номери закріплені в мові, але поточна версія терміналу їх не показує: LS1003, LS1007, LS1011, LS2016, LS3000, LS3001, LS3005, LS4003, LS4004, LS5007, LS6000, LS6006, LS6008, LS6022, LS6023. Наприклад, оголошення не першою рядком зараз повідомляється як LS1009, а ділення на нуль не зупиняє скрипт з LS6000.
Далі
https://docs.lootx.trade/uk/loot/errors
12Приклади скриптів
Вісім готових скриптів на LootScript: ковзні, RSI, VWAP зі смугами відхилень, кумулятивна дельта з розбіжностями, відкритий інтерес, ставка фінансування, дисбаланси кластерів і стратегія для тестера.
Вісім готових скриптів на LootScript: від ковзних і RSI до кумулятивної дельти, відкритого інтересу, ставки фінансування і кластерів. Кожен — робочий індикатор, який можна відразу додати на графік і підлаштувати під себе. Усі приклади збираються компілятором поточної версії без помилок і попереджень.
Як запустити приклад
- Натисніть ƒ на панелі графіка, у вікні Індикатори — Редактор….
- У редакторі натисніть Новий (Ctrl+N), замініть шаблон кодом прикладу і натисніть Зберегти.
- Натисніть Додати на графік (Ctrl+Enter). Налаштування з
input.*з’являться у вікні налаштувань індикатора.
1. Три ковзні з вибором типу
Швидка, середня і повільна середні одного типу на вибір. Фон підсвічується, коли всі три вибудувалися за трендом.
indicator("Три скользящие", shortTitle = "MA×3", overlay = true)
maType = input.string("EMA", "Тип средней", options = ["EMA", "SMA", "WMA", "HMA"])
src = input.source(close, "Источник")
len1 = input.int(20, "Быстрая", minval = 1)
len2 = input.int(50, "Средняя", minval = 1)
len3 = input.int(200, "Медленная", minval = 1)
func ma(s, len) => switch maType {
"SMA" => ta.sma(s, len)
"WMA" => ta.wma(s, len)
"HMA" => ta.hma(s, len)
=> ta.ema(s, len)
}
m1 = ma(src, len1)
m2 = ma(src, len2)
m3 = ma(src, len3)
plot(m1, "Быстрая", color = m1 >= m1[1] ? color.teal : color.red, linewidth = 2)
plot(m2, "Средняя", color = color.orange)
plot(m3, "Медленная", color = color.gray, linewidth = 2)
bgcolor(m1 > m2 and m2 > m3 ? color.new(color.teal, 20) : m1 < m2 and m2 < m3 ? color.new(color.red, 20) : na)Як влаштовано
input.stringзoptionsперетворюється на випадаючий список у налаштуваннях.- Функція
maвибирає середню черезswitch. Станta.*живе в кожному місці виклику, тому три викликиma— три незалежні середні. - Колір швидкої лінії — вираз: зростає порівняно з попередньою свічкою (
m1[1]) — бірюзова, падає — червона. - Панель малює до трьох ліній
plotна скрипт — тому середніх три.
2. RSI з зонами і сповіщеннями
RSI із зафарбованою смугою між рівнями. Лінія й фон фарбуються, коли RSI у зоні перекупленості або перепроданості.
indicator("RSI с зонами", shortTitle = "RSI", overlay = false)
len = input.int(14, "Период", minval = 2)
src = input.source(close, "Источник")
ob = input.float(70, "Перекупленность", minval = 50, maxval = 100)
os = input.float(30, "Перепроданность", minval = 0, maxval = 50)
r = ta.rsi(src, len)
hOb = hline(ob, "Перекупленность", color = color.red)
hOs = hline(os, "Перепроданность", color = color.teal)
fill(hOb, hOs, color = color.new(color.purple, 20))
plot(r, "RSI", color = r > ob ? color.red : r < os ? color.teal : color.purple, linewidth = 2)
bgcolor(r > ob ? color.new(color.red, 35) : r < os ? color.new(color.teal, 35) : na)
alertcondition(ta.crossunder(r, ob), "RSI вышел из перекупленности", "RSI опустился ниже верхнего уровня")
alertcondition(ta.crossover(r, os), "RSI вышел из перепроданности", "RSI поднялся выше нижнего уровня")Як влаштовано
hlineповертає ручку рівня, аfillзафарбовує смугу між двома ручками.- Рівні — налаштування
input.float, тому лінії й заливка рухаються разом із ними. alertconditionоголошує два сповіщення. Самі по собі вони не дзвонять — як їх ввімкнути, описано на сторінці Алерти зі скриптів.- Альфа в
color.new— від 0 (прозоро) до 255 (непрозоро).
3. VWAP дня зі смугами відхилення
Зважена по обсягу ціна з початку доби за UTC і смуга ±σ навколо неї.
indicator("VWAP дня с полосами", shortTitle = "VWAP", overlay = true)
src = input.source(hlc3, "Цена")
mult = input.float(1.0, "Ширина полосы, σ", minval = 0.1, step = 0.1)
anchor = session.isfirstbar
vw = ta.vwap(src, anchor)
// Сумма объёма и сумма объёма на квадрат цены с начала дня — для разброса вокруг VWAP.
var float sumV = 0.0
var float sumV2 = 0.0
if anchor {
sumV := 0.0
sumV2 := 0.0
}
if not na(volume) and not na(src) {
sumV := sumV + volume
sumV2 := sumV2 + volume * src * src
}
sigma = sumV > 0 and not na(vw) ? math.sqrt(math.max(sumV2 / sumV - vw * vw, 0)) : na
pUp = plot(vw + mult * sigma, "Верх", color = color.new(color.blue, 150))
plot(vw, "VWAP", color = color.blue, linewidth = 2)
pDn = plot(vw - mult * sigma, "Низ", color = color.new(color.blue, 150))
fill(pUp, pDn, color = color.new(color.blue, 25))Як влаштовано
ta.vwapпочинає рахунок заново на барі, де якір істинний. Для криптовалютsession.isfirstbar— перший бар після 00:00 UTC.- Змінні
varпереживають перехід між барами. Їх обнуляє той самий якір, тому смуга рахується за той самий період, що й VWAP. - Розкид — корінь із середньозваженого квадрата ціни мінус квадрат VWAP.
math.max(…, 0)захищає від крихітного мінуса через округлення. - Має сенс на внутріденних таймфреймах. Хочете VWAP від останньої виплати ставки фінансування — поставте
anchor = funding.settled.
4. Добова кумулятивна дельта з розбіжностями
Кумулятивна дельта, яка обнуляється щодня, і позначки на барах, де ціна оновила екстремум, а дельта — ні.
indicator("Дневная кумдельта с расхождениями", shortTitle = "CVD", overlay = false)
len = input.int(20, "Окно поиска максимумов", minval = 3)
var float cvd = 0.0
if session.isfirstbar {
cvd := 0.0
}
if delta.available {
cvd := cvd + delta.value
}
cvdLine = delta.available ? cvd : na
// Цена обновила максимум окна, а кумдельта — нет: покупатели не подтверждают рост.
bearish = high >= ta.highest(high, len) and cvdLine < ta.highest(cvdLine, len)
bullish = low <= ta.lowest(low, len) and cvdLine > ta.lowest(cvdLine, len)
plot(cvdLine, "Кумдельта", color = cvdLine >= 0 ? color.teal : color.red, linewidth = 2)
hline(0, "Ноль", color = color.gray)
plotshape(bearish, "Медвежье расхождение", style = shape.triangledown, location = location.top, color = color.red, size = size.tiny)
plotshape(bullish, "Бычье расхождение", style = shape.triangleup, location = location.bottom, color = color.teal, size = size.tiny)Як влаштовано
delta.value— агресивні покупки мінус агресивні продажі за бар. Там, де покриття немає,delta.availableхибне, і лінія переривається, а не малює нуль.- Накопичувач
varобнуляється на початку доби. Потрібна кумдельта по всій завантаженій історії без скидання — візьміть готовий рядdelta.cum. - Розбіжність: ціна на максимумі вікна, а кумдельта нижча свого максимуму за те саме вікно. Для мінімумів — дзеркально.
location.topіlocation.bottomставлять позначки на краях підвікна, а не біля ціни.
5. Сплески відкритого інтересу
Зміна відкритого інтересу від бару до бару у відсотках і помітки там, де вона вибивається з звичайного розкиду.
indicator("Изменение открытого интереса", shortTitle = "ΔOI %", overlay = false)
len = input.int(50, "Окно для всплесков", minval = 5)
k = input.float(3.0, "Порог всплеска, σ", minval = 0.5, step = 0.5)
pct = oi.available and oi.close[1] > 0 ? 100 * (oi.close - oi.close[1]) / oi.close[1] : na
sd = ta.stdev(pct, len)
spike = not na(sd) and math.abs(pct) > k * sd
plot(pct, "ΔOI, %", style = plot.style_columns, color = pct >= 0 ? color.teal : color.red)
hline(0, "Ноль", color = color.gray)
plotshape(spike, "Всплеск", style = shape.circle, location = location.top, color = color.orange, size = size.tiny)Як влаштовано
oi.close— відкритий інтерес на закритті бара,oi.close[1]— на попередньому барі. Перевіркаoi.availableне дає порахувати зміну з пустоти.- Сплеск — бар, де зміна по модулю більша за
kстандартних відхилень за вікноlen. - Відкритий інтерес приходить поминутно. На таймфреймах менше хвилини сусідні бари повторюють одне значення, і зміна там нульова — це дані, а не помилка.
6. Ставка фінансування
Ставка фінансування безстрокового ф’ючерса у відсотках за період або перерахована на рік, з позначками виплат і підсвіткою високої ставки.
indicator("Ставка финансирования", shortTitle = "Funding", overlay = false)
mode = input.string("За период", "Показывать", options = ["За период", "Годовых"])
thr = input.float(0.05, "Порог, %", minval = 0.0, step = 0.01)
perPeriod = funding.rate * 100
periodsPerYear = funding.interval_hours > 0 ? 24.0 / funding.interval_hours * 365 : na
value = mode == "Годовых" ? perPeriod * periodsPerYear : perPeriod
level = mode == "Годовых" ? thr * periodsPerYear : thr
plot(value, "Ставка, %", style = plot.style_columns, color = value >= 0 ? color.teal : color.red)
hline(0, "Ноль", color = color.gray)
plotshape(funding.settled, "Выплата", style = shape.circle, location = location.bottom, color = color.gray, size = size.tiny)
bgcolor(math.abs(value) > level ? color.new(color.orange, 30) : na)Як влаштовано
funding.rate— доля, а не відсотки: 0.0001 — це 0,01 %. Тому ставку множать на 100.- Для річних значень ставка множиться на число виплат у році.
24.0записано дробом навмисно: ділення двох цілих у LootScript відкидає залишок. funding.settledістинно на барі, де пройшла виплата — там унизу ставиться точка.- Поріг задається за період і для річних перераховується тим самим множником.
7. Дисбаланси в кластерах
Позначки на графіку ціни там, де в кластерах бара стоїть «драбинка» дисбалансів або їх просто багато, плюс рівень максимального обсягу (POC) кожного бара.
indicator("Дисбалансы кластеров", shortTitle = "Imbalance", overlay = true)
minSteps = input.int(3, "Уровней подряд", minval = 2)
minCount = input.int(5, "Дисбалансов в баре", minval = 1)
levels = cluster.available ? cluster.levels : 0
buys = 0
sells = 0
for i in 0 .. levels {
side = cluster.imbalance(i)
if side == 1 {
buys := buys + 1
} else if side == -1 {
sells := sells + 1
}
}
plot(cluster.poc, "POC", style = plot.style_circles, color = color.orange)
plotshape(cluster.stacked_buy_steps >= minSteps, "Лесенка покупок", style = shape.triangleup, location = location.belowbar, color = color.teal, size = size.small)
plotshape(cluster.stacked_sell_steps >= minSteps, "Лесенка продаж", style = shape.triangledown, location = location.abovebar, color = color.red, size = size.small)
plotshape(buys >= minCount, "Много дисбалансов покупок", style = shape.circle, location = location.belowbar, color = color.new(color.teal, 120), size = size.tiny)
plotshape(sells >= minCount, "Много дисбалансов продаж", style = shape.circle, location = location.abovebar, color = color.new(color.red, 120), size = size.tiny)Як влаштовано
cluster.imbalance(i)повертає +1, −1 або 0 для цінового рівняi. Поріг дисбалансу береться з налаштувань кластерного графіка, тому скрипт бачить те саме, що й ви.cluster.stacked_buy_steps— скільки рівнів підряд іде дисбаланс покупок. Циклfor i in 0 .. levelsрахує всі дисбаланси бара, не тільки підрядні.- Скрипт сам підписується на кластери і працює на звичайному свічковому графіку. На біржі без покриття і на таймфреймах менше 30 секунд або більше доби кластерів немає — тоді
levelsдорівнює 0 і позначок не буде.
8. Стратегія: перетин EMA зі стопом за ATR
Вхід у лонг на перетині середніх, стоп і ціль — у частках ATR, вихід — по зворотному перетину.
strategy("EMA-кросс со стопом по ATR", overlay = true, initialCapital = 10000,
defaultQtyType = strategy.qty.percent_of_equity, defaultQtyValue = 10,
slippageTicks = 2)
fastLen = input.int(12, "Быстрая EMA", minval = 1)
slowLen = input.int(26, "Медленная EMA", minval = 2)
atrLen = input.int(14, "Период ATR", minval = 1)
stopK = input.float(1.5, "Стоп, в ATR", minval = 0.1, step = 0.1)
takeK = input.float(3.0, "Цель, в ATR", minval = 0.1, step = 0.1)
fast = ta.ema(close, fastLen)
slow = ta.ema(close, slowLen)
atr = ta.atr(atrLen)
// ATR запоминается в момент сигнала, чтобы стоп и цель не ползли вслед за волатильностью.
var float riskAtr = na
if ta.crossover(fast, slow) and strategy.position_size == 0 {
riskAtr := atr
strategy.entry("Long", strategy.long)
}
if ta.crossunder(fast, slow) {
strategy.close("Long", comment = "Обратный кросс")
}
if strategy.position_size > 0 {
entry = strategy.position_avg_price
strategy.exit("Стоп/цель", from_entry = "Long", stop = entry - stopK * riskAtr, limit = entry + takeK * riskAtr)
}
plot(fast, "Быстрая", color = color.teal)
plot(slow, "Медленная", color = color.orange)Як влаштовано
- Параметри
strategy(…)— літерали: капітал 10 000, розмір позиції 10 % капіталу, прослизання 2 тики. Комісія не вказана, тому тестер бере тариф за замовчуванням: 0,02 % за лімітне виконання і 0,05 % за ринкове і стоп. Свій тариф у процентах задаєcommissionValue. - Ринковий вхід виконується по відкриттю наступного бара, а не по закриттю сигнального: так тестер не заглядає в майбутнє.
strategy.exitставить стоп і ціль від середньої ціни входу. Якщо за один бар зачепилися обидва, тестер за замовчуванням вважає, що спрацював стоп.- Результати — угоди, крива капіталу, просідання — у вікні Тестер стратегії… редактора. Детальніше — на сторінці Стратегії і тестер.
Далі
https://docs.lootx.trade/uk/loot/examples