Настройка API-ключа WEEX: как безопасно подключить стороннюю платформу

Чтобы подключить стороннюю платформу к WEEX, создайте API-ключ WEEX в разделе «Аккаунт», затем «Управление API», предоставьте ему только необходимые платформе разрешения и вставьте в платформу API-ключ, секретный ключ и парольную фразу. Если платформа — зарегистрированный брокер WEEX, ту же задачу можно выполнить с помощью кнопки «Войти через WEEX», не используя ключ. В этом руководстве описаны оба способа подключения, безопасное размещение первого ордера, наиболее частые ошибки и настройки безопасности, от которых зависит возможный ущерб в случае утечки ключа. Информация о шагах и ограничениях актуальна на 7 октября 2026 года.

Быстрое подключение или ручная настройка API-ключа WEEX: что выбрать

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

Fast Connect — это авторизация OAuth от WEEX, о запуске которой объявили 3 августа 2026 года. Нажмите «Войти через WEEX» на платформе-партнёре, перейдите на страницу авторизации WEEX, проверьте разрешения (торговля и доступ на чтение выбраны по умолчанию) и подтвердите действие. Затем WEEX создаст API-ключ и отправит его на сервер платформы. Вы не увидите ключ и не будете копировать его. По данным WEEX, процесс занимает менее 10 секунд.

Важно учитывать два момента. Страница авторизации находится на www.weex.com, поэтому перед подтверждением проверьте адресную строку. Кроме того, правила OAuth WEEX разрешают создавать по одному ключу на пользователя для каждой сторонней платформы, поэтому для повторного подключения той же платформы сначала нужно удалить старый ключ.

Ручной ключ подходит для любого программного обеспечения с поддержкой WEEX, включая инструменты, которые не являются брокерами, и позволяет полностью контролировать разрешения и привязку IP-адресов.

Как пошагово создать API-ключ WEEX

1. Войдите в WEEX через веб-сайт. Перейдите в раздел «Аккаунт», затем «Управление API» и выберите «Создать API-ключ». На странице API WEEX есть кнопка «Создать API», которая открывает тот же экран.
2. Укажите в названии ключа платформу, для которой он предназначен.
3. Создайте парольную фразу, используя только буквы и цифры. Согласно разделу часто задаваемых вопросов WEEX, специальные символы не принимаются. Восстановить или изменить парольную фразу позже нельзя.
4. Выберите разрешения. Для новых ключей по умолчанию установлено разрешение «Только чтение». Добавляйте разрешение для спотовой или фьючерсной торговли, только если платформа будет совершать сделки на этом рынке. Эти разрешения независимы друг от друга, поэтому фьючерсному боту не нужен доступ к спотовой торговле.
5. Привяжите IP-адреса, если платформа указывает адреса, с которых подключается.
6. Пройдите проверку безопасности.
7. Скопируйте API-ключ, секретный ключ и парольную фразу и сохраните их в безопасном месте. В руководствах HaasOnline и KoinX предупреждают, что секретный ключ показывается только один раз.

Следует знать о трёх ограничениях. Согласно руководству WEEX по подготовке интеграции, для каждого аккаунта можно создать не более 10 групп API-ключей. Новый или отредактированный ключ активируется повсюду примерно через 15 минут. Кроме того, в руководстве KoinX говорится, что WEEX может запросить анкету для активации API и отправить письмо с подтверждением перед тем, как ключ начнёт работать. Поэтому если в первые часы ключ не работает, это не обязательно означает, что он настроен неправильно.

Привязка ключа и размещение первого ордера

На разных платформах эти три значения могут называться по-разному. Типичный пример — HaasOnline, добавившая поддержку WEEX 22 августа 2026 года: откройте раздел Exchange Accounts, выберите спотовую или фьючерсную торговлю WEEX, введите API-ключ в поле публичного ключа, а секретный ключ — в поле приватного ключа, добавьте парольную фразу и нажмите кнопку проверки ключа. «Ключ доступа» и «публичный ключ» — это одно и то же, что и API-ключ.

Прежде чем запускать торговую стратегию, разместите через платформу один ордер вручную:

1. Выберите ликвидную пару и укажите минимальный доступный на платформе размер ордера. Разместите лимитный ордер далеко от текущей цены.
2. Проверьте, появился ли ордер в открытых ордерах непосредственно на WEEX.
3. Отмените ордер на платформе и убедитесь, что он исчез на WEEX.

Такая проверка подтверждает, что ключ, разрешение и сопоставление торговой пары работают, и ничего не стоит.

Если что-то не работает, обычно причина одна из следующих:

• Ошибка -1052: недостаточно разрешений. У ключа нет разрешения на фьючерсную торговлю или эта пара не поддерживается.
• Ошибки разрешений у только что созданного ключа. Подождите 15 минут.
• HTTP 429. Платформа отправляет слишком много запросов. Лимит WEEX для REST составляет 500 единиц веса за 10 секунд на IP-адрес.
• Ошибки подписи или парольной фразы. В одном из трёх значений пропущен символ или случайно добавлен пробел.
• Запросы отклоняются при включённой привязке IP. Платформа подключается с адреса, которого нет в вашем списке.

Полный список кодов приведён в разделе часто задаваемых вопросов об API для фьючерсов WEEX.

Безопасность API-ключа WEEX: шесть настроек, которые ограничивают возможный ущерб

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

1. Предоставляйте минимально необходимые разрешения. Инструментам для налогового учёта и управления портфелем достаточно разрешения «Только чтение». Именно его запрашивает KoinX. Ключ только для чтения не позволяет размещать ордера.
2. Привязывайте IP-адреса, если платформа это поддерживает. В документации WEEX сказано, что ключи без привязки IP «представляют угрозу безопасности». Некоторые сервисы не могут работать с фиксированным списком. KoinX рекомендует пользователям отключить ограничение по IP. Если платформе нужен ключ без ограничений, оставьте для него только разрешение на чтение.
3. Создавайте отдельный ключ для каждой платформы. При наличии до 10 групп ключей нет причин использовать один ключ для нескольких сервисов. Отдельный ключ позволяет отключить один сервис, не нарушая работу остальных, и понять, откуда произошла утечка.
4. Считайте парольную фразу третьим секретом. Не храните её на скриншотах, не отправляйте в сообщениях и не указывайте в обращениях в поддержку. В рекомендации WEEX сказано прямо: «Никогда не сообщайте свою парольную фразу».
5. Отклоняйте запросы на разрешения, выходящие за рамки торговли. В руководствах по интеграции для создаваемых ключей перечислены разрешения «Только чтение», спотовая торговля и фьючерсная торговля. Если платформа просит пароль для входа в WEEX или разрешение на вывод средств, она запрашивает то, что не требуется для торговли.
6. При малейших сомнениях удаляйте ключ. WEEX рекомендует немедленно удалить скомпрометированный ключ. Так же поступайте с ключами платформ, которыми вы больше не пользуетесь.

Как отключить платформу от WEEX

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

Ключи, созданные через Fast Connect, подчиняются тому же правилу. В руководстве WEEX по OAuth сказано, что существующий ключ нужно удалить, прежде чем аккаунт можно будет снова подключить к этой платформе.

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

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

1. Сколько API-ключей можно создать на WEEX?

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

2. Можно ли сбросить утерянную парольную фразу API WEEX?

Нет. В документации WEEX указано, что утерянную парольную фразу нельзя восстановить или изменить. Удалите ключ, создайте новый с другой парольной фразой и обновите настройки платформы, которая использовала старый ключ.

3. Почему новый API-ключ WEEX выдаёт ошибку разрешений?

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

4. Поддерживает ли WEEX подключения через TradingView или FIX?

В разделе часто задаваемых вопросов об API для фьючерсов WEEX указано, что интеграция с TradingView и FIX API не поддерживаются. Подключение выполняется через интерфейсы REST и WebSocket — напрямую или через платформу, которая интегрировала их.