Перейти к содержимому

API-ключ для торгового терминала. Права, фьючерсы и ошибки подключения

Как создать API-ключ для Tradepit на Binance, Bybit, OKX, Bitget и KuCoin, какие права включить, почему не открываются фьючерсы и что значат ошибки подключения.

Обновлено

Где создаётся ключ

API-ключ создаётся на самой бирже, в разделе управления API. Tradepit работает с биржей напрямую, через ваш API-ключ.

Поддерживаются биржи Binance, Bybit, OKX, Bitget и KuCoin.

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

Готовый ключ вставляется в Tradepit в «Аккаунт», раздел «API-ключи». Как это сделать по шагам, сказано в гайде «С чего начать», раздел «Ключ в Tradepit». Ключи только в вашем браузере.

Какие права дать ключу

Давайте ключу для Tradepit только права на чтение и торговлю, с выключенным выводом и переводами.

Право торговли нужно на том рынке, которым вы будете торговать в Tradepit, Spot или Futures.

Выбирайте ключ, который создаёт сама биржа, обычно он называется System-generated. Tradepit подписывает запросы секретом этого ключа. Ключ на вашей собственной паре ключей, Ed25519 или RSA, не подойдёт.

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

Ключ на Binance и Bybit

На Binance ключ создаётся так.

  1. Профиль → Account → API Management → Create API.
  2. Тип ключа System-generated, название любое, подтверждение 2FA.
  3. В правах ключа для Spot включите «Enable Spot & Margin Trading», для Futures «Enable Futures». «Enable Withdrawals» и «Permits Universal Transfer» оставьте выключенными.

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

На Bybit ключ создаётся только на сайте, в приложении этого нет. Новому аккаунту биржа может не давать создать ключ первые 48 часов после регистрации.

  1. Значок профиля справа вверху → API → Create New Key.
  2. Выберите ключ с правом записи, а не только чтения. Для Futures включите ордера и позиции контрактов, для Spot торговлю спотом. Вывод и переводы не включайте.
  3. Подтвердите кодом Google Authenticator.

Когда Bybit сообщает права ключа, Tradepit их проверяет. Ключ без торговли нужного рынка получит статус «только чтение», а ключ с правом вывода не сохранится.

Ключ на OKX, Bitget и KuCoin

Эти три биржи при создании ключа просят придумать кодовую фразу (passphrase). В Tradepit она вводится в поле «Кодовая фраза» рядом с секретом. Биржа её больше не покажет, и если фраза забыта, нужен новый ключ.

На OKX ключ создаётся так.

  1. Профиль → API → Create API key.
  2. Название ключа, права и кодовая фраза. Права Read и Trade, Withdraw и Transfer не включайте.
  3. Подтвердите кодами 2FA.

У ключей, где уже было право Trade, OKX включил Transfer сам. У старого ключа проверьте, что Transfer выключен.

Ключ OKX для EEA или US добавляется в Tradepit так же, как любой ключ OKX, регион ключа Tradepit находит сам. Для Bitget, KuCoin и OKX (EEA, US) нужно расширение Exchange Bridge для Chrome. Если его нет, Tradepit покажет, как его поставить.

На Bitget ключ создаётся так.

  1. Значок профиля справа вверху → API → Create API.
  2. Тип System-generated API Key (HMAC).
  3. Заметка к ключу, кодовая фраза, права и код подтверждения. Права на чтение и торговлю фьючерсами или спотом, без вывода и переводов.

На KuCoin ключ создаётся так.

  1. Аватар → API Management → Create API, вариант API Trading.
  2. Название ключа, кодовая фраза и права. Для Futures нужна торговля фьючерсами, для Spot торговля спотом.
  3. Подтвердите торговым паролем, кодом из письма и кодом Google.

Право Transfer у ключа KuCoin Tradepit считает правом вывода и такой ключ не сохраняет.

Когда OKX, Bitget или KuCoin сообщают права ключа, Tradepit их проверяет. Ключ без торговли нужного рынка получит статус «только чтение», а ключ с правом вывода не сохранится.

Почему не открываются фьючерсы

Фьючерсы открывает биржа, а не Tradepit. Пока биржа не открыла вам фьючерсы, ключ ими не торгует, какие бы права у него ни стояли.

Binance. Для фьючерсов нужна верификация личности, а сам фьючерсный счёт открывается в разделе Futures кнопками «Open Account» и «Open Now». Ключ, созданный до открытия фьючерсного счёта, право «Enable Futures» не получит, нужен новый ключ. С включённым Portfolio Margin это право ключу тоже не включить.

Bybit. Верификация личности уровня Standard обязательна для всех продуктов биржи.

OKX. В режиме счёта Spot фьючерсы недоступны. Ключ для Futures получит в Tradepit статус «только чтение», а в карточке ошибки будет код 51010. Выберите на странице торговли OKX любой другой режим счёта, через API он не меняется.

Bitget. Без верификации личности первого уровня биржа не даёт торговать.

KuCoin. Для фьючерсов нужны верифицированный аккаунт и тест или оценка опыта, если биржа их просит. Жителям части стран биржа фьючерсы не открывает.

Когда фьючерсы открыты и право на них у ключа включено, нажмите «Проверить» у ключа. Окнам Futures нужен ключ, добавленный с рынком Futures, ключ рынка Spot им не подходит.

Ошибки подключения

Ошибки биржи показываются вам в понятном виде. Когда биржа отказывает, в углу экрана появляется карточка. В её заголовке биржа, действие и пара, ниже причина. «Подробнее» показывает код и текст ошибки самой биржи без перевода и HTTP-статус. Отказ при проверке ключа подписан «Проверка ключа».

Ниже причины, связанные с ключом, и коды бирж, которые Tradepit к ним относит.

«Биржа не принимает этот API-ключ». Биржа не узнала ключ, его подпись или кодовую фразу. Проверьте, что ключ, секрет и кодовая фраза скопированы целиком и что в форме выбрана та же биржа. Ключ демо-счёта не подойдёт, Tradepit работает с настоящим счётом биржи.

БиржаКоды
Binance-2014, -2015, -1022, -1002
Bybit10003, 10004
OKX50101, 50105, 50111, 50113, 50114, 50119
Bitget40006, 40009, 40012, 40036, 40037
KuCoin400003, 400004, 400005

Код -2015 Binance даёт и тогда, когда адреса нет в списке IP ключа или у ключа нет права на это действие, например «Enable Futures» для фьючерсов.

«У ключа нет прав на это действие или ваш IP не разрешён». У ключа не включена торговля этого рынка, или биржа не пускает ключ с этого адреса.

БиржаКоды
Bybit10005, 10010
OKX50110, 50120
Bitget40014, 40018
KuCoin400006, 400007

Блок «Мой IP» в «API-ключах» показывает адрес, который видит биржа, когда вы торгуете с этого компьютера. Если ключ привязан к IP, у KuCoin и OKX в списке нужен и IPv6, они работают и по нему.

«Часы компьютера расходятся с биржей». Сверьте время на компьютере и повторите действие.

БиржаКоды
Binance-1021
Bybit10002
OKX50102, 50112
Bitget40005, 40008
KuCoin400002

«Биржа закрыла доступ из этой сети», а у ключа приписка «биржа отклонила доступ (403)…». Это ответ 403 без кода биржи. О самом ключе он ничего не говорит, и права ключа остаются прежними.

«Биржа вернула ошибку, которую терминал пока не знает». Код и текст биржи всё равно есть в «Подробнее».

Ключ перестал работать сам. OKX удаляет ключ без привязки к IP с правом Trade или Withdraw после 14 дней без использования. KuCoin такой ключ с торговлей после 30 дней без использования удаляет или снимает с него торговлю. Тогда создайте новый ключ и добавьте его в Tradepit.

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