Справка Alphafamilia Algo

Для администратора системы

Коротко

  • Раздел «Профиль» → «Администрирование» есть только у администратора системы.
  • Здесь: режим регистрации, заявки, добавить и заблокировать пользователя, разрешённые пары.
  • Чужих стратегий, сумм и истории администратор в приложении не видит.

Администратор системы — пользователь, который ещё и управляет доступом людей. У него есть раздел «Администрирование»: «Профиль» → «Администрирование». У других пользователей этого раздела нет.

«Профиль» → «Администрирование» открывает меню из двух страниц. «Управление пользователями» — режим регистрации, заявки, а у пользователей — имя, Telegram ID, статус, сколько у человека стратегий и открыт ли его сейф ключей; стратегий, сумм и истории других пользователей там нет. «Настройка торговых пар» — «Что можно торговать»: какие пары разрешены новым стратегиям на каждом рынке. Вернуться из страницы в меню — «← Администрирование».

Администрирование: режим регистрации, заявки и список пользователей

Режим регистрации

Вверху страницы «Управление пользователями» — переключатель «Регистрация» (со знаком «?»):

  • «Только администратор» (так было всегда и так стоит сразу после обновления) — новых людей добавляете вы по Telegram ID. Заявки не принимаются.
  • «Открытая с подтверждением» — человек открывает приложение в Telegram (или входит в браузере кнопкой «Войти»), видит «Заявка отправлена», а вам приходит сообщение «🔴 Заявка на регистрацию» с кнопками «✅ Подтвердить» и «❌ Отклонить».

Перед тем как включить «Открытую с подтверждением», приложение спрашивает: «Открыть регистрацию? Любой, кто найдёт бота в Telegram, сможет подать заявку — они будут приходить вам на подтверждение. Подтверждённый пользователь сам добавляет ключи и стратегии.» Если отказаться, переключатель вернётся на «Только администратор». Возврат к «Только администратор» без вопроса: он ничего не открывает.

Пока заявка ждёт решения или отклонена, человеку ничего не открыто: войти он не может.

Если заявок слишком много, переключите на «Только администратор»: новые заявки перестанут приниматься. Те, что уже ждут, остаются в списке — их можно решить.

Заявки

Заявки — в блоке «Заявки» (со знаком «?» о кнопках «Заблокировать · Подтвердить · Отклонить»): имя из Telegram, Telegram ID, когда отправлена, статус «ждёт решения» или «отклонена». Кнопка «Отклонить» — с красной рамкой.

  1. Нажмите «Подтвердить» (или «Отклонить») у заявки — или кнопку в сообщении Telegram: она откроет этот раздел с нужной заявкой.
  2. Подтвердите решение.
  3. После «Подтвердить» человек становится пользователем и получает в Telegram «ℹ️ Доступ открыт». Ответ приложения: «Доступ открыт. Человек получит сообщение в Telegram.».
  4. После «Отклонить» человек войти не может; заявка остаётся в списке как «отклонена» — позже её можно подтвердить. Повторную заявку он отправить не может, сообщение об отказе ему не приходит.

Если вы добавите человека с заявкой через «Добавить пользователя», заявка считается подтверждённой. Возможная ошибка: «Такой заявки нет — возможно, она уже решена.».

Заблокированный пользователь заявку не отправит: для него ничего не меняется.

Добавить пользователя

  1. Попросите человека узнать свой Telegram ID у бота @userinfobot.
  2. Откройте «Профиль» → «Администрирование» → «Управление пользователями».
  3. В блоке «Добавить пользователя» введите «ID Telegram» (число) и «Имя» для списка.
  4. Нажмите «Добавить».
  5. Дождитесь ответа «Добавлен. Теперь он может войти.».
  6. Сообщите человеку, что он может войти, и дайте ссылку на эту справку.

Дальше человек сам добавляет свои подключения и стратегии. Возможные ошибки: «ID Telegram — это число.», «Такой пользователь уже есть.».

Заблокировать пользователя

  1. Найдите человека в списке.
  2. Нажмите «Заблокировать» (кнопка с красной рамкой) и подтвердите.

Что происходит:

  • его стратегии останавливаются и снимают свои заявки; активы на бирже не продаются;
  • затем его сейф закрывается;
  • войти он больше не может, открытые сеансы закрываются сразу;
  • ключи остаются в зашифрованном сейфе, история — в базе; ничего не удаляется.

Если в этот момент его сейф закрыт, снять заявки нельзя. Приложение предупредит: «Заблокирован. Его сейф ключей был закрыт — заявки стратегий остались на бирже.».

Пользователей не удаляют, только блокируют. Администратора системы заблокировать нельзя.

Разблокировать пользователя

  1. Найдите человека в списке (статус «заблокирован»).
  2. Нажмите «Разблокировать» и подтвердите.

Всё возвращается как было: человек входит, открывает свой сейф и сам запускает стратегии.

Что можно торговать

Страница «Профиль» → «Администрирование» → «Настройка торговых пар». Для каждого рынка — «Binance спот», «Binance фьючерсы USD-M», «Binance фьючерсы COIN-M» (по умолчанию — BTC и USD, то есть BTCUSD_PERP), «BingX спот», «BingX фьючерсы USDT-M», «Bybit спот», «Bybit фьючерсы USDT», «Coinbase спот», «Т Инвестиции» — два списка: «Активы (чем торгуем)» (BTC, ETH; на Т Инвестициях — тикеры SBER, GAZP) и «Валюты прибыли» (USDT, USDC; у Coinbase — EUR, USDC; на Т Инвестициях — RUB). У заголовка раздела — знак «?».

Каждый тикер списка — чип с крестиком «×»: нажмите «×», чтобы убрать тикер. Чтобы добавить, впишите тикер в поле в конце списка («Тикер и Enter») и нажмите Enter, запятую или пробел. Можно вставить сразу несколько через запятую, пробел или «;». Строчные буквы становятся заглавными сами. Затем нажмите «Сохранить» у рынка. Пока изменения не сохранены, под рынком написано «Изменения не сохранены.».

  • Пользователи при создании стратегии выбирают пару только из этих списков и только из тех пар, которыми биржа сейчас торгует. Так, при активах BTC, ETH и валютах USDT, USDC на споте предлагаются BTCUSDT, BTCUSDC, ETHUSDT, ETHUSDC — если они есть на Binance.
  • Пустой список (активов или валют) — на этом рынке нельзя создать стратегию. Если вы убрали последний тикер, приложение сразу предупреждает: «Пустой список закроет этот рынок для новых стратегий, когда вы сохраните.» После сохранения под рынком написано «Список пуст — на этом рынке нельзя создать стратегию.», а в форме новой стратегии пользователь видит то же объяснение.
  • Списки касаются только новых стратегий. Работающие стратегии продолжают торговать своей парой, даже если её убрали из списка.
  • Тикер — латинские заглавные буквы и цифры, от 1 до 20 знаков; в списке не больше 200 тикеров. Неверный тикер остаётся в поле, и рядом сказано, что не так: «Неверный тикер: … (латинские буквы и цифры).», «… уже есть в списке.» или «Слишком длинный список (больше 200).». Пока он не исправлен, список не сохраняется. Сервер проверяет списки по тем же правилам.
  • При обновлении до 2.0.21 списки заполнены парами ваших стратегий (кроме архива).

Устройство системы

У администратора системы в «Профиле», рядом со «Справкой», есть ещё ссылка «Устройство системы» — техническое описание: как устроен сервис, как он защищён, решения разработчика, установка сервера и регламент. Другие пользователи этой ссылки не видят, а сервер не отдаёт им ни одной страницы описания — даже по прямому адресу.

Нажмите «Устройство системы» — описание откроется в браузере (в Telegram — во встроенном браузере Telegram). Ссылка одноразовая и действует минуту; браузер получает доступ на время вашего входа в приложение. После «Выйти» в приложении описание закрывается; откройте его снова из «Профиля».

Настройки сервера

Настройки службы лежат в файле /etc/vnext2/settings.toml на сервере. Обычно их менять не нужно: значения по умолчанию рассчитаны на повседневную работу, а обновления файл не меняют. Ниже — строки, которые администратор системы может менять; остальное (база, файл ключей, интерфейс, подключения) задаётся при установке сервера, см. техническое описание.

Как изменить настройку:

  1. В файле, в разделе [service] (или [diagnostics], смотря где настройка), впишите или исправьте строку. Неверное значение или опечатка в названии — служба не запустится и скажет, какая строка неверна.
  2. Выполните systemctl restart vnext2: настройки читаются только при запуске службы.
  3. Откройте сейф и запустите стратегии, как после перезапуска (Перезапуск и обновление сервера).

Раздел [service] (первое значение — по умолчанию):

Настройка Значения Что делает
step_seconds число от 1 до 60 (3) Как часто стратегия делает шаг, в секундах
market_prices "compare", "stream" Откуда стратегии Binance берут цену. compare: цена REST, как раньше, а цена потока только сравнивается с ней (расхождение больше 0,1 % — строка в журнале сервера). stream: свежая цена потока (не старше 5 секунд), иначе REST
fills_from "stream", "rest" Откуда стратегии берут исполнения заявок. stream: из потока событий счёта, с периодической сверкой с историей биржи. rest: только из истории биржи, как в 2.1.2 — на случай беды с потоком; запросов к бирже в несколько раз больше. rest выключает факты потоков всех бирж (Binance, BingX, Bybit), каким бы ни было значение их собственных настроек
trust_exchange_count "mainnet", "all", "off" Верить ли счётчику использованных запросов, который сообщает сама биржа Binance. mainnet: только на реальном адресе — на тестовой сети счётчик показывает 120–160 % лимита при малой нагрузке и без толку останавливал бы чтения; all: везде; off: нигде, считает только сервер. Ответы биржи «слишком часто» и блокировка адреса учитываются при любом значении
bingx_fills_from "compare", "stream" Фьючерсы BingX. compare: сделки учитываются по истории биржи, а сделки из потока только сравниваются с ней — расхождения пишутся в журнал сервера. stream: сделка из потока сразу считается фактом (ТП ставится быстрее), история читается для сверки раз в 5 минут и по поводу. Включать после недели без расхождений. Спот BingX поток не использует
bingx_market_prices "compare", "stream" Откуда стратегии BingX (спот и фьючерсы) берут лучшую цену и mark-цену фьючерсов. compare: цена REST, как раньше, а цена из открытого потока рынка BingX только сравнивается с ней и считается в метриках. stream: свежая цена потока (не старше 5 секунд), иначе REST. Переключать после недели в compare по отчёту scripts/stream_report.py
bybit_futures_fills_from, bybit_spot_fills_from "compare", "stream" То же для фьючерсов и для спота Bybit, каждый рынок отдельно. Для спота stream включают только после живой проверки комиссии в MNT
bybit_stream_samples число от 0 до 200 (0) Сколько первых строк каждого вида потока Bybit записать в журнал для проверки. Включается только по просьбе разработчика
bybit_market_prices "compare", "stream" Откуда стратегии Bybit берут цену (спринт 40). compare: цена REST, как раньше, а цена из открытого потока рынка Bybit только сравнивается с ней и считается в замерах. stream: свежая цена потока (не старше 5 секунд), иначе REST. Демо-счёт берёт те же цены, что живой. Включать после недели сравнения — по отчёту scripts/stream_report.py

Раздел [diagnostics] (по умолчанию выключен):

Настройка Значения Что делает
bingx_stream_log false, true Записывать в файл bingx-stream-raw.jsonl (в папке состояния службы) первые события каждого вида из потока BingX, с их полями. Включается только по просьбе разработчика. Ключей, ключа потока (listenKey) и подписей в файле нет
bingx_stream_log_events число от 1 до 1000 (20) Сколько событий каждого вида записать
bingx_stream_log_kb число от 1 до 10240 (512) Наибольший размер файла в килобайтах: дальше запись прекращается

Что делают стратегии в каждом режиме потока, описано для Binance в Аварии и сбои, для BingX — в BingX, для Bybit — в Bybit.

Обслуживание сервера

  • Обновление ставится на сервере одной командой vnext2-update. Перед обновлением администраторы системы получают «🛠 Обновление Alphafamilia Algo» (решение владельца 19.11: пользователям — только сообщения, где нужно что-то сделать). После обновления стратегии пользователей, чей сейф был открыт, продолжают сами — им ничего не приходит, администратору — «✅ Служба запущена, стратегии работают» с числом продолживших стратегий всех пользователей; пользователям с закрытым сейфом — «🔴 Служба запущена», они открывают свой сейф и запускают свои стратегии. Сообщения о падении службы и о невыполненных заданиях сервера — тоже только администраторам. Обновление идёт само по себе, окно Терминала только показывает его ход: если окно закрыть или связь оборвётся, обновление дойдёт до конца, а итог придёт в Telegram.
  • Если обновление не удалось, приходит «🔴 Обновление до … не удалось» с пояснением. Подробно — Перезапуск и обновление сервера.
  • Падение службы. Сервер сам перезапускает службу и сообщает об этом всем, у кого есть стратегии. Стратегии пользователей, чей сейф был открыт, продолжают сами.
  • Хранитель (vnext2-keeper) — маленькая служба, благодаря которой стратегии продолжают после перезапуска программы. Её не перезапускают: перезапуск стирает её память, и после следующего перезапуска программы каждому понадобится пароль сейфа. Проверить: systemctl is-active vnext2-keeper.
  • Копии базы: полная копия — каждую ночь, хранится 30 дней; копия базы — ещё и каждый час, хранится 48 часов: при потере сервера теряется не больше часа записей. Проверка восстановления из копии — каждую неделю. Если что-то не получилось, приходит сообщение «🟠 Alphafamilia Algo: …». Стратегии при этом торгуют как прежде; сообщите разработчику.
  • Обновления системы сервера (Ubuntu) сами не ставятся (ночные обновления перезапускали службу, и сейфы закрывались). Администратор ставит их вручную, когда стратегиям удобно: apt update && apt upgrade. Службу это не перезапускает — сейфы остаются открытыми; если система попросит перезагрузку и сервер перезагружен, служба запустится сама, а сейф каждый открывает заново.

Утренняя сводка администратора

Каждое утро в 09:00 по времени Мадрида все, у кого есть стратегии, получают «ℹ️ Сводка Alphafamilia Algo» (что в ней у каждого — см. Сообщения в Telegram). У каждого в сводке есть строка «Сверка с биржей»: каждую ночь (после 05:00 по Мадриду) система сама сверяет результаты циклов, закрытых за сутки, с данными биржи — по каждому подключению со стратегиями, пока сейф его владельца открыт. Сверка только читает историю биржи: заявок не ставит, в работу стратегий не вмешивается. На Bybit, если в истории биржи за сутки нет сделок, которые стратегия получила от биржи в момент исполнения, сверка переспрашивает биржу о них по номеру заявки и пишет в отчёте, нашлись ли они: найденные — цикл сходится, не найденные нигде — расхождение. Если биржа на вопрос не ответила или заявок больше 40 за ночь и до какой-то очередь не дошла, такой цикл — «не сверено», а не расхождение: про эти сделки биржу не спросили. Ответы биржи сверка запоминает, и следующей ночью спрашивает только о том, о чём не спросила, — пока каждый такой цикл не будет сверен. Так же, если историю сделок биржи не удалось прочитать: цикл — «не сверено», и следующей ночью сверка берёт тот же период (не дальше трёх суток назад), а вам приходит «🟠 Сверка с биржей не выполнена». Обычная строка — «Сверка с биржей: циклов N, расхождений нет». «⚠️ расхождений N из M циклов» — результат стратегии не сошёлся с биржей: об этом сразу приходит и отдельное сообщение; сообщите разработчику. «Рядом ручная позиция: N» — фьючерсная стратегия работала рядом с вашей ручной позицией по тому же контракту и в ту же сторону: биржа считает результат закрытия от средней цены всей позиции, поэтому её цифра по такому циклу отличается от учёта стратегии. Учёт стратегии верен, делать ничего не нужно; если других расхождений нет, строка остаётся без значка ⚠️ и отдельное сообщение не приходит. «Ещё не выполнена» — сейф был закрыт (сверка пройдёт, когда он откроется, и возьмёт весь пропущенный период, но не больше трёх суток) или сверка ещё идёт. Новое подключение сверяется со следующей ночи.

Администратору в ней есть ещё служебные строки:

  • «Версия» — какая версия работает и номер её сборки, например «2.1.1 (b29ac88)»; в приложении под списком стратегий — только версия («Версия: 2.1.1»);
  • «База» — «отвечает» или «⚠️ не отвечает»;
  • «Копия базы» — сколько часов назад сделана последняя ночная (полная) копия; ⚠️, если больше 26 часов назад или сведений нет. О сбое часовой копии сообщает отдельное «🟠 …: часовая копия базы не сделана»;
  • «Диск» — занятость диска; ⚠️ от 80 %;
  • «⚠️ Копии уходят на Mac незашифрованными» — шифрование копий на Mac ещё не включено: один раз в Терминале на Mac bash ~/Downloads/vnext2.0/deploy/mac/setup-backup-key.sh (скрипт попросит придумать пароль ключа копий; он нужен только для восстановления);
  • предупреждение, если часы сервера не сверяются с точным временем: тогда цены могут считаться устаревшими, и стратегии перестанут ставить заявки.

Последняя строка сводки говорит, что сделать сегодня: открыть сейф и запустить стратегии, разобрать аварии, включить шифрование копий, сообщить разработчику о ⚠️ в строках службы или о сверке с биржей — или «Ничего делать не нужно.».

Служебные сигналы

Когда что-то не так у службы целиком, а не у одной стратегии, все, у кого есть стратегии, получают «Сигнал службы» (значок — по причине: 🔴, 🟠, ⚠️ или ✅). Например: ошибка в цикле службы или один счёт биржи под двумя подключениями. Список — Сообщения в Telegram.

Командная строка сервера

На сервере есть командная строка службы. Её команды выполняются от имени администратора системы и касаются только его стратегий и сейфа; другие пользователи открывают сейф и запускают стратегии в приложении. Команда сервера «запустить все» делает то же, что групповая «Запустить» в приложении: запускает все неработающие стратегии администратора, в том числе остановленные; между стратегиями пауза 2 секунды, чтобы биржа не получила все первые запросы разом. Аварийные стратегии пропускаются и остаются как есть; остановленная стратегия с незаконченным циклом остаётся остановленной, если выбор («продолжить» или «новый цикл») не указан; не трогает она и стратегии, остановка которых ещё не записана из-за недоступной базы (они названы в ответе). Стратегия в командах называется своим названием, как в приложении. Подробности — в техническом описании сервера.

Важно. Ключи зашифрованы паролем каждого пользователя. Но администратор сервера технически может прочитать всё на сервере, в том числе открытые ключи в памяти работающей службы. Пользователи должны доверять администратору системы.

Дальше: Вопросы и словарь