Мова 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