Кальтер / Блог

API-ключ биржи: выбери минимальные права и проверь старые разрешения

Сравни Binance USER_DATA/TRADE с наборами прав OKX, включая Transfer, Loan и Earn; проверь IP allowlist и старые ключи перед подключением бота.

Материал подготовлен с помощью ИИ; документация Binance и OKX проверена редакцией ZASLON 6 ноября 2026. Аккаунты и ключи не создавались.

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

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

Сопоставь задачу с разрешениями

В Binance Spot API у endpoint указан security type. USER_DATA нужен для приватной информации, например статуса ордеров и истории; TRADE позволяет размещать и отменять ордера. В документации Binance торговля по умолчанию выключена для ключа; включать её нужно в API Management (официальная документация REST API). FAQ Binance уточняет, что системный HMAC-ключ без IP-ограничений по умолчанию ограничен чтением; для withdrawal ограничение IP обязательно (FAQ о ключах).

В OKX в официальной документации есть Read, Trade и Withdraw, а FAQ отдельно описывает Transfer, Loan и Earn. Transfer разрешает движение средств между счетами, Loan — операции с займами, Earn — подписку и погашение продуктов Earn. В FAQ, обновлённом 28 сентября 2026 года, сказано, что при переходе старые ключи с разрешением Trade автоматически получили также Transfer, Loan и Earn (OKX API FAQ, API permissions). Поэтому проверь существующие ключи, даже если сам ничего не менял.

Твоя задача Что проверить Что не включать автоматически
Читать приватную историю/статус ордеров Binance: endpoint с USER_DATA; OKX: Read и нужный endpoint TRADE, вывод, внутренние переводы
Создавать или отменять ордера Конкретные Binance endpoints с TRADE; OKX Trade и подходящая account mode Withdraw, если интеграция не выводит средства
Переводить между собственными счетами OKX Нужен ли именно Transfer для используемой операции Loan, Earn и Withdraw
Не использовать API дальше Удалить или отозвать ключ в настройках аккаунта Не оставлять ключ «про запас»

Названия прав не заменяют проверку endpoint. На обеих биржах конкретные функции зависят от продукта, типа аккаунта и региона. Например, Trade на одном endpoint не даёт универсального ответа, нужны ли дополнительные права для другого сервиса. Для Binance сверяй security type у каждого endpoint; для OKX открывай соответствующий раздел API guide.

Пример: мониторинг ордеров

Синтетический сценарий: бот раз в минуту читает статус ордеров и пишет их в локальный отчёт. Он не создаёт, не отменяет и не перемещает активы. В таблице требований укажи «просмотр приватного статуса», сопоставь используемые endpoints, затем проверь, что права ключа не включают Trade, Withdraw, Transfer, Loan или Earn без необходимости. Для Binance это вероятно означает USER_DATA scope; для OKX — Read. После настройки проверь страницу permissions и IP allowlist в аккаунте. Ключ и секрет в примере не создавались.

Если тот же бот должен выставлять ордера, это уже отдельная задача: добавь конкретные TRADE/Trade endpoints и опиши, кто утверждает действие, как ограничены суммы и как отозвать доступ. Не выдавай один ключ с максимальными правами ради упрощения настройки.

Проверь IP и хранение

OKX позволяет указать IP allowlist и показывает её в карточке ключа; FAQ указывает лимит до 20 адресов. У Binance FAQ говорит, что незакреплённый IP ограничивает system-generated HMAC key чтением, а для withdrawal IP restriction обязательна. Эти правила бирж и их интерфейсы могут меняться, поэтому сверяй экран перед сохранением.

Секрет держи только в серверном secret store или переменной окружения защищённого backend-процесса. Не помещай его в браузерный код, мобильное приложение, публичный репозиторий, скриншот, тикет поддержки или промпт ИИ. При смене поставщика, утечке или завершении задачи отзови соответствующий ключ и проверь, что он больше не отображается как активный.

Запрос к ИИ для проверки списка прав

Проверь эту обезличенную матрицу API-разрешений только по приложенной документации биржи. Не проси ключ, secret, passphrase, IP-адрес или скрин аккаунта. Для каждой операции укажи endpoint, требуемую permission по документации, риск лишнего права и вопрос, который нужно проверить в текущем интерфейсе. Отдельно проверь у OKX permissions Read/Trade/Withdraw/Transfer/Loan/Earn и возможное наследование прав старого ключа. Не советуй включать вывод, если задача его не требует. Не утверждай, что настройка применена к аккаунту.

Успешная проверка — у каждого включённого права есть конкретный endpoint/действие, IP allowlist соответствует серверу, а старые ключи просмотрены после изменений схемы permissions. Это не гарантия отсутствия компрометации. Общие принципы хранения API secrets собраны в отдельном гайде.

Материал подготовлен с помощью ИИ. Ключи и аккаунты не создавались; примеры синтетические.