БиржиБазовый

API-ключи биржи: права и ограничения

Чем отличаются права API-ключа на чтение, торговлю и вывод. Как ограничить доступ приложения, проверить IP и отозвать ненужное подключение к бирже.

В этой статье 01Короткий ответ02Начните с задачи приложения03Какие данные получает подключение04Запрет вывода — лишь одна граница05Проверяйте доступ и после подключения06Одно приложение считает портфель, другое выставляет заявки07Что проверить08Источники09Читайте дальше
КОРОТКИЙ ОТВЕТ

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

Ключ доступа и отдельные разрешения аккаунта.
Права доступа приложения к биржевому счёту.

Начните с задачи приложения

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

Публичные рыночные данные часто доступны вообще без ключа аккаунта. Например, Kraken разделяет открытые market-data методы и приватные методы учёта, торговли и переводов. Поэтому просьба дать торговый доступ ради просмотра графика требует объяснения. Возможности проверяют по документации подключаемого приложения и самой биржи, а не по заверению «мы ключом ничего не делаем».

Какие данные получает подключение

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

Даже доступ только на чтение может раскрывать баланс, позиции и историю операций. Секреты и QR-коды подключения не стоит отправлять в общий чат, репозиторий или необработанный диагностический лог. У разных приложений полезно иметь отдельные ключи: тогда по имени легче понять назначение и отозвать одно подключение, не перенастраивая остальные.

Запрет вывода — лишь одна граница

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

IP-ограничение допускает запросы с перечисленных адресов. Для серверного приложения это адрес исходящего подключения его сервера, а не обязательно адрес телефона владельца. Оно дополняет, но не заменяет защиту сервера и самого секрета. Правила срока действия, доступные ограничения и набор прав различаются у площадок и продуктов.

Проверяйте доступ и после подключения

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

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

Одно приложение считает портфель, другое выставляет заявки

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

Через месяц журнал перестали использовать. Его ключ можно отозвать отдельно, затем проверить, что старое подключение больше не получает данные. Торговая программа продолжит использовать собственный ключ с прежним набором полномочий. Если же утёк именно торговый секрет, одного отключения журнала недостаточно: исследуют действия соответствующего ключа и состояние счёта. Результат проверяют по фактам на бирже, а не по исчезновению значка соединения в приложении.

Что проверить

  • Какие действия разрешены ключу и действительно ли они нужны приложению.
  • К какому аккаунту, среде и исходящим IP относится подключение.
  • Где хранятся секреты и как отдельно отозвать каждый доступ.

Источники и документация

Материал носит образовательный характер. Примеры условные. Информация помогает изучить механику, но не гарантирует результат сделки.

Теперь стало понятнее?Сообщить о неточности