Язык 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/ru/loot/overview