Какие данные может получить торговый бот через API-ключ?

API-ключ для торгового бота — это не пароль. Это разрешение с определёнными правами: биржа позволяет включить ровно три функции — просмотр данных вашего аккаунта, размещение и отмену сделок, а также вывод средств — и правильно настроенный торговый бот получает доступ только к первым двум. Третья функция, вывод средств, — это единственное разрешение, которое боту не нужно, и на всех крупных биржах его можно оставить отключённым.

Три уровня, которые предлагает каждая биржа

Binance, Bybit, OKX, Kraken и Gate.io разделяют доступ к API на те же три функциональные области, независимо от того, как они называются в своих собственных меню Настройки:

Read и trade — этого достаточно, чтобы бот выполнял всё, что от него требуется: проверял Market, открывал позицию, корректировал её, закрывал. Withdrawal полностью выводит средства с биржи, что никак не связано с работой стратегии — на это же указывают независимые исследователи в области безопасности: в одном стороннем анализе разрешений API бирж отмечается, что права на торговлю фактически неизбежны для любого бота, но withdrawal — «самое опасное право», и его следует всегда отключать, независимо от того, какая платформа его запрашивает.

Что именно включает в себя «сделка» при работе бота на Futures

Для Spot-ботов разрешение на сделки простое: размещение и отмена ордеров на покупку/продажу. Торговля на Futures добавляет немного больше возможностей в рамках того же разрешения «сделка» — бот, работающий по стратегии COMBO-бота или DCA Futures бота, должен открывать и закрывать позиции, а также, как правило, регулировать Плечо и маржу по этим позициям в процессе выполнения стратегии. Всё это по-прежнему полностью входит в рамки разрешения на сделки; для этого не требуются права на вывод средств, и бот не получает возможности перемещать базовое обеспечение с биржи. Если вы подключаете ключ с поддержкой Futures, ожидайте увидеть регулировку Плеча/маржи в списке того, что покрывает разрешение на сделки на этой бирже — это обычная часть того же уровня доступа, а не отдельное, более рискованное разрешение.

Разрешение, которое действительно нейтрализует утечку ключа: добавление IP-адресов в белый список

Область разрешений — не единственный инструмент. Большинство бирж также позволяют ограничить API-ключ определённым IP-адресом, чтобы даже если строка ключа попадёт в чужие руки, использовать её с другого места было бы невозможно — как отмечается в одном анализе, «злоумышленник, получивший строку символов, не сможет ничего с ней сделать, если не отправляет запросы именно с этого адреса». Binance идёт ещё дальше и применяет это по умолчанию: если для ключа не задано ограничение по IP, через 90 дней автоматически снимаются торговые права. Это важно знать само по себе, независимо от вопроса о уровнях разрешений — это также одна из самых частых причин, по которой бот внезапно перестаёт торговать без каких-либо других изменений с вашей стороны (см. почему мой бот перестал торговать, если вы столкнулись с такой ситуацией).

Почему «только торговля» — это не просто маркетинговый слоган

Когда платформа заявляет, что её боты работают только с ключом для сделок, это конкретное, проверяемое утверждение: переключатель вывода средств отключён, и это контролирует сама биржа, а не платформа бота. Запросы ключей Bitsgap требуют только разрешений на чтение и совершение сделок; если вы создаёте ключ на своей бирже с включённым выводом средств и пытаетесь подключить его, это несоответствие между тем, что вы предоставили, и тем, что требуется платформе, а не признак того, что ей нужно больше. Для более глубокого рассмотрения вопроса безопасности — что происходит при утечке ключа только для сделок и почему некостодиальный статус важнее одного лишь переключателя разрешений — смотрите Безопасно ли подключать API вашей биржи к торговому боту?.

Что на самом деле отображается в режиме только для чтения

Ключ только для чтения раскрывает больше информации, чем многие думают, даже без прав на совершение сделок: полный баланс по каждому активу, вся история ордеров, открытые позиции, иногда адреса для депозитов. Это не угроза для средств, но это утечка личных данных — причина ограничивать использование ключей только для чтения сервисами, которым вы доверяете, и всегда проверять, какие права запрашивает любой сторонний аналитический инструмент, прежде чем предоставить их. Например, сервисам для налоговой отчетности и трекерам Портфолио нужен только доступ для чтения; если какой-то из них запрашивает права на совершение сделок, это повод задать прямой вопрос, ведь у инструмента для отчетности нет легитимных причин размещать ордера от вашего имени.

Проверка области действия вашего собственного ключа

На любой из пяти бирж, перечисленных выше, на странице управления API рядом с каждым ключом отображаются его активные разрешения, обычно в виде ряда переключателей или значков. Если у ключа, который вы создали для бота, включено разрешение на вывод средств, немедленно исправьте это — удалите ключ и создайте новый, включив только чтение и сделку, а также ограничение по IP, если биржа поддерживает такую функцию, затем переподключите. Фактическое поведение бота не изменится; изменится только риск в случае утечки этого ключа.

Тот самый переключатель разрешений, к которому вы никогда не прикасаетесь, определяет, станет ли утечка ключа просто неприятностью или настоящей катастрофой.

Часто задаваемые вопросы

Может ли API-ключ торгового бота вывести мои средства с биржи? Нет, если ключ настроен правильно. Вывод средств — это отдельное, необязательное разрешение, которое торговому боту не требуется для работы, — запросы ключей Bitsgap никогда его не требуют.

В чем разница между разрешениями на чтение и на торговлю? Разрешение на чтение позволяет программе просматривать ваш баланс, ордера и историю. Разрешение на торговлю дает возможность размещать и отменять ордера. Боту нужны оба разрешения; ни одно из них не позволяет выводить средства.

Нужны ли боту для Futures какие-либо разрешения, кроме чтения и совершения сделок? Нет. Настройка плеча и маржи для позиций на Futures относится к тем же разрешениям на совершение сделок — это не отдельная, более рискованная категория, и она по-прежнему не дает права на вывод средств.

Имеет ли IP-белый список вообще значение, если у моего ключа уже нет прав на вывод средств? Да. Это защищает от злоупотребления теми разрешениями, которые у ключа всё же есть — даже если торговый ключ без права вывода попадёт в чужие руки, он будет бесполезен для других, если ограничен вашим IP-адресом, даже при наличии самой строки ключа.

Является ли API-ключ только для чтения полностью безопасным? Такой ключ не может переводить средства, но он открывает ваш баланс и историю сделок для того, кто им владеет. Предоставляйте доступ только для чтения только тем сервисам, которым это действительно необходимо, например, инструментам для отчетности.