Руководство пользователя

От API-ключей до безопасного выхода

Короткая последовательная инструкция: подключение бирж, создание связки, ручное управление, Telegram, расширения и диагностика.

1. Быстрый старт

Создайте аккаунт и войдите в кабинет.
Подключите API минимум двух бирж.
Выберите монету, LONG-биржу и SHORT-биржу.
Задайте порог, чанк и полный объём позиции.
Нажмите «Добавить и запустить».

Каждая добавленная связка работает независимо. Изменение одной карточки не меняет уже созданные маршруты.

2. Подключение API

В кабинете откройте «API интеграции». Выберите биржу, вставьте все запрошенные поля и нажмите «Проверить и подключить».

Разрешите только чтение аккаунта и торговлю.
Обязательно отключите вывод средств.
Если биржа поддерживает whitelist, добавьте IP сервера: 135.125.131.17.
Для замены нажмите «Редактировать», введите полный новый комплект и сохраните.
Для удаления сначала удалите мониторинги, использующие эту биржу.

Сервис никогда не показывает сохранённый Secret. Если секрет потерян, создайте новый API на бирже и замените комплект.

3. Создание автоматической связки

LONG покупает актив на более дешёвой стороне, SHORT продаёт на более дорогой. Для спота разрешена только LONG-нога.

Основные поля

Спред входа — минимальное значение для автоматического набора.
Один ордер — размер одного чанка на каждую ногу.
Вся позиция — целевой предел на каждую ногу.
Удержание — сколько миллисекунд условие должно сохраняться.
Пауза — интервал между чанками.
3 уровня и VWAP — дополнительная проверка доступного объёма; её можно выключить.

«Пауза» останавливает новый автоматический вход, но не скрывает уже открытую позицию. «Закрыть» запускает поэтапное reduce-only закрытие.

4. Ручной вход без ожидания

В карточке откройте «Ручной вход / выход». Задайте чанк, целевой объём и паузу между ордерами, затем нажмите «Открыть сейчас».

Ручной вход игнорирует только порог и удержание автоматического входа. Проверка API, направления позиции, исполнения обеих ног и биржевых ограничений остаётся включённой.

Кнопка «Остановить операцию» прекращает дальнейшие чанки. Уже исполненные ордера не отменяются и остаются видны как позиция.

5. Как работает автовыход

Введите размер ордера выхода и порог обратного спреда. Система следит за ценами, по которым реально можно закрыться: LONG продаётся, SHORT выкупается.

Когда обратный спред достигает заданного значения и удерживается, бот закрывает обе ноги одинаковыми reduce-only чанками. После каждого чанка позиция перечитывается с API.

Пример: вход был +4%, выход задан 0%. Автовыход ждёт схождения цен до обратного спреда ≥ 0%, а не изменения текущего входного спреда на четыре пункта.

6. Telegram, Mini App и расширения

Откройте «Telegram и расширение», создайте одноразовый код и отправьте полученную команду боту. Код действует 10 минут. После привязки уведомления и Mini App относятся только к вашему аккаунту.

Fundoor и Arbiter

Скачайте нужное расширение, распакуйте архив и загрузите папку через chrome://extensions → «Режим разработчика» → «Загрузить распакованное». Создайте персональный токен в кабинете и вставьте его вместе с адресом сервера.

Токен показывается один раз. Новый токен отключает предыдущий токен этого же расширения.

7. Что означают показатели

Спред — разница между исполнимой ценой SHORT bid и LONG ask.
ТВХ — средний фактический спред входа, рассчитанный по исполненным ценам обеих бирж.
PnL — доступная текущая оценка результата позиции; итог после закрытия может отличаться из-за комиссий и фандинга.
Чанк — объём одного шага набора или выхода.
Ожидание свежих стаканов — одна из котировок устарела; торговля временно заблокирована до свежих данных.

8. Частые ошибки

IP mismatch / неверный IP

Добавьте новый IP сервера в whitelist API биржи: 135.125.131.17.

Risk limit / maximum notional

На бирже достигнут лимит позиции для тикера. Уменьшите позицию, измените уровень риска на бирже или снизьте целевой объём.

Исполнилась только одна нога

Вторая биржа отклонила ордер или потеряла ликвидность. Система фиксирует критическую ошибку и пытается закрыть исполненную одиночную ногу.

Нет свежих стаканов

Проверьте, что тикер существует на обеих выбранных биржах. Если сообщение не проходит, откройте журнал событий и сохраните точный текст ошибки.