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