limiterbuyproc.2

8.30.1

modulename: limiterbuyproc.2

Last change: 14-03-2026

---

Что делает модуль

limiterbuyproc.2 рассчитывает итоговый qty для входящих buy-сигналов на основе доли депозита и маршрутизирует команду дальше в tradeprofile.

Поддерживаются рынки:

• spot

• futures

Базовая формула выделенного бюджета:

available_deposit * risk * (stratdepo/100) * (whitelist_percent/100) * (limiterbuyproc/100)

После расчета qty модуль сохраняет исходные поля количества (openpro, closepro, depopro, quqty) и передает команду downstream без очистки.

Базовая конфигурация

см. Базовая конфигурация модуля

Конфигурация

/** [default]=false Игнорировать whitelist-проверку символа */
ignorewhitelist: boolean;

/** [default]=false Строгий режим (ошибки limiter-валидации завершают сигнал как failed) */
strict: boolean;

/** [default]='' Белый список пар с долями в формате COIN-PERCENT через запятую */
whitelist: string;

/** [default]=100 Процент депозита, выделенный под стратегию */
stratdepo: number;

/** [default]=1 Коэффициент риска [0..1] */
risk: number;

/** [default]=0 Виртуальный депозит для spot (если >0, используется вместо расчетного) */
virtualdepospot: number;

/** [default]=0 Виртуальный депозит для futures (если >0, используется вместо расчетного) */
virtualdepofru: number;

/** [default]='USDT' Котируемая валюта */
paircoin: string;

/** [default]='null' Следующий модуль в цепочке маршрутизации */
tradeprofile: string;

Веб-интерфейс

есть

Вкладка Главная:

• редактирование конфигурации (ignorewhitelist, strict, whitelist, stratdepo, risk, virtualdepospot, virtualdepofru, paircoin, tradeprofile);

• tradeprofile выбирается из выпадающего списка (null + активные модули текущего пользователя, кроме самого limiterbuyproc.2);

• блок Runtime Status показывает короткий диагностический чеклист:

  • whitelist validation (OK или N errors);

  • last result (none | pass | failed | passthrough);

  • reason (короткий reason-code последнего сигнала);

  • time (время последнего сигнала).

• внизу доступна детализация ошибок whitelist в textarea.

Вкладка CLI:

• отправка произвольной команды в модуль (sendAntaresSelfRequest);

• просмотр ответа;

• копирование команды и ответа в буфер обмена.

Команды backend для UI (cmd=*):

• cmd=getcfg — возвращает только this.cfg.data() (чистый конфиг);

• cmd=setcfg;base64=<BASE64URL(JSON)> — применяет полный payload настроек (AJV-schema, additionalProperties=false);

• cmd=status — возвращает runtime-данные интерфейса (tradeprofileOptions, whitelistValidationSummary, whitelistValidationErrors, lastSignal, config).

Особенности работы

• Математика модуля включается только при наличии параметра limiterbuyproc.

• strict=false:

  • при отсутствии limiterbuyproc, NaN/<=0 значении или символе вне whitelist команда пропускается дальше (pass-through).

• strict=true:

  • при тех же условиях модуль возвращает failed.

• Если символ не проходит filter.strip(...), возвращается failed.

• Если paircoin отсутствует в балансе, возвращается failed.

• Для futures с withcollateral в расчет может быть добавлена/подменена collateral-стоимость.

• Модуль выставляет итоговый qty, но не удаляет исходные поля источников количества; приоритет и коллизии обрабатываются на уровне коннектора.

Пример сигнала для расчета через модуль:

mktype=spot;symbol=XLMUSDT;side=buy;type=limit;price=0.13;limiter!;limiterbuyproc=2

Рекомендуемая цепочка маршрутизации:

poslimiter.3 -> limiterbuyproc.2 -> trade