Подключение бирж и API-ключи
Какие биржи поддерживает LootX, какие права дать API-ключу, как добавить подключение, настроить прокси и понять состояние подключения по цвету.
Подключение — это связь терминала с вашим счётом на бирже через API-ключ. Без него стакан, лента и графики работают, но свои заявки, позиции и баланс терминал не видит, и торговать нельзя. Здесь — какие биржи поддерживаются, как создать ключ и с какими правами, как завести подключение, пустить его через прокси и понять по цвету, что с ним происходит.
Биржи и рынки
В списке бирж две группы.
| Группа | Площадки | Что даёт |
|---|---|---|
| Торговля и данные | Binance, Bybit, OKX, Bitget, Gate.io, MEXC, KuCoin, BingX, Hyperliquid, Aster | Стакан, лента, графики, свои заявки и позиции, торговля. Спот и фьючерсы. |
| Только данные | Binance Alpha, Upbit (спот) | Стакан, лента и графики. Торговли нет, ключи не нужны. |
К одной бирже можно завести несколько подключений — например, для разных субаккаунтов. Если биржа не входит в ваш тариф, при выборе терминал предложит подписку — см. Подписки.
Какой ключ создать на бирже
Ключ создаётся в разделе управления API на сайте биржи. Терминалу нужно:
- Чтение — чтобы видеть баланс, заявки и позиции.
- Торговля на тех рынках, где будете торговать: спот, фьючерсы или оба.
Привязка к IP. Если биржа позволяет ограничить ключ списком IP-адресов, это стоит сделать. Укажите адрес, с которого терминал реально выходит на биржу: ваш внешний IP, а если заявки идут через прокси — IP прокси. При запасном выходе напрямую (о нём ниже) упавший прокси покажет бирже ваш собственный IP, и она отклонит запросы.
Passphrase. OKX, Bitget и KuCoin при создании ключа просят придумать passphrase. Это не пароль от аккаунта — это третья часть ключа, её нужно ввести в терминале вместе с ключом и secret.
Как добавить подключение
Откройте список подключений
Шестерёнка в верхней панели окна → Подключения. Вверху видно, сколько подключений заведено и сколько из них активны.
Нажмите «+ Добавить подключение»
Откроется форма Добавить подключение.
Назовите подключение и выберите биржу
Название подключения — любое, например «Binance_main»; рядом можно выбрать цвет, чтобы отличать подключения в панелях. Биржа — список с поиском. После того как ключи введены, биржу сменить нельзя: для другой биржи создайте новое подключение.
Вставьте ключи
Обычно это API Key и API Secret, у OKX, Bitget и KuCoin — ещё Passphrase. У Hyperliquid и Aster поля свои, см. ниже.
Выберите рынки
Переключатели Спот и Фьючерс — на каких рынках работать через это подключение. Автоподключение — подключаться сразу при запуске терминала.
Нажмите «Сохранить»
Правки применяются сразу, по мере ввода. Сохранить закрывает форму, Отмена откатывает изменения, а у только что созданного подключения удаляет его.
В списке у каждой строки есть переключатель — он включает и выключает подключение, не удаляя его, — и отметка в столбце Авто для автоподключения. Изменить подключение — клик по строке. Удалить подключение в форме удаляет его вместе с ключами, вернуть нельзя.
Ключи хранятся в файле настроек в зашифрованном виде и расшифровываются только на этом компьютере. При экспорте конфигурации они не выгружаются.
Hyperliquid
У Hyperliquid нет пары «ключ + secret»: единственное поле Private Key / Seed принимает приватный ключ кошелька.
- Ключ API-кошелька (он же agent) — рекомендуемый вариант. Такой ключ создаётся на сайте Hyperliquid и может торговать, но не выводить средства. Терминал сам находит основной счёт, за которым закреплён API-кошелёк, и показывает его баланс и позиции. Действия уровня аккаунта — например, переводы — API-кошелёк подписать не может, их делайте на сайте Hyperliquid.
- Ключ самого кошелька тоже подойдёт, но он даёт полный доступ к средствам.
Hyperliquid узнаёт счёт по подписи ключа. Если на этом адресе нет депозита, терминал сообщит, что биржа отвергла ключ, — проверьте ключ и пополнение.
Aster
У Aster два вида ключей, форма принимает оба:
- обычный API-ключ — в поля API key / API wallet address и API secret / Private key;
- API-кошелёк — его адрес и приватный ключ в те же два поля, а в Account Id — адрес основного кошелька (0x…).
Прокси
Прокси нужен, если биржа недоступна из вашей страны или если ключ привязан к IP прокси.
Добавьте прокси
Настройки → Прокси → + Добавить прокси. Заполните Название, Адрес (хост и порт), при необходимости Логин и Пароль. Протокол — SOCKS5, HTTP или HTTPS — терминал определит сам.
Проверьте
Кнопка Проверить стучится в прокси и пишет результат: «OK — SOCKS5-прокси отвечает», «Не отвечает: …» или «Порт открыт, но это не SOCKS5/HTTP-прокси». Затем Сохранить.
Выберите прокси в подключении
В форме подключения, раздел Прокси: выберите прокси и отметьте, что через него пускать — Заявки и счёт, Рыночные данные или оба. Выбор для рыночных данных действует на все подключения этой биржи.
На странице Прокси есть переключатель «Переходить на прямое соединение, если прокси недоступен». По умолчанию он включён: упал прокси — терминал идёт на биржу напрямую, чтобы не терять данные.
Если прокси отвечает «Прокси … отвергает логин/пароль (407)», проверьте логин, пароль и срок подписки у поставщика прокси.
Состояние подключения
В строке подключения, рядом с рынками, стоит точка состояния. Наведите на неё — подсказка скажет подробности.
| Вид | Что значит |
|---|---|
| Зелёная точка | Подключено: данные идут, торговля поднята. |
| Жёлтое пульсирующее кольцо | Идёт подключение или торговля переподключается. Подсказка покажет последнюю причину сбоя, если она была. Терминал повторяет попытки сам. |
| Красное кольцо, не мигает | Нет связи с биржей, биржа отвергла ключ или торговля выключена вручную. |
| Точки нет | Подключение выключено. |
Рядом с названием — значок режима: зелёные стрелки у торгового подключения, серый глаз у площадки «только данные».
Включать и выключать торговлю на ходу удобно из главного окна: клик по полосе бирж в верхней панели открывает список подключений с кнопками Подкл и Откл и ссылкой Настройки подключений ›.
Если биржа отвергла ключ
Терминал сразу показывает сообщение «…: биржа отвергла API-ключ или secret — проверьте их в настройках подключения», а точка подключения горит красным с подсказкой «Биржа отвергла API-ключ или secret». Проверьте ключ, secret и passphrase: лишний пробел при вставке, удалённый на бирже ключ, ключ другого субаккаунта.
Если же ключ верный, но у него нет нужного права или ваш IP не в списке разрешённых, отдельного сообщения нет: терминал показывает текст биржи как есть. Найдите в нём код и откройте страницу своей биржи в разделе Сообщения об ошибках.
Расхождение часов компьютера и биржи терминал выравнивает сам — настраивать ничего не нужно.
Режим «только просмотр»
Если из панели сейчас торговать нельзя, в ней появляется значок-глаз. Наведите на него — подсказка назовёт причину:
| Подсказка | Что сделать |
|---|---|
| «Только просмотр: у этой площадки торговли нет — приходят стакан, лента и графики» | Ничего: так устроены Binance Alpha и Upbit. |
| «Только просмотр: к этой бирже нет подключения. Заведите его в настройках» | Добавьте подключение с ключом. |
| «Только просмотр: подключение выключено в настройках» | Включите подключение. |
| «Только просмотр: рынок этой панели сейчас не подключён — ждём восстановления» | Подождите: терминал переподключается сам. |
Если в таком состоянии нажать кнопку или горячую клавишу торговли, заявка не уйдёт, а терминал покажет «⚠ Биржа не подключена», «⚠ Подключение выключено» или «⚠ У этой площадки нет торговли».