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 собраны в отдельном гайде.
Материал подготовлен с помощью ИИ. Ключи и аккаунты не создавались; примеры синтетические.
