Лимиты API WEEX: цифры, которые упускают новички

Лимиты API WEEX ограничивают количество запросов, которые ваш код может отправить за определенный промежуток времени — 100 спотовых ордеров в минуту, 50 фьючерсных ордеров в минуту, 20 публичных запросов рыночных данных каждые 2 секунды — и их превышение приводит к ошибке HTTP 429 и временному бану. Большинство руководств по лимитам бирж объясняют концепцию и на этом останавливаются. Это руководство дает вам реальные лимиты WEEX, поясняет, применяются ли они к IP или к аккаунту, и приводит расчеты, показывающие, как быстро бот новичка упирается в эти ограничения.

Все цифры ниже взяты из документации API WEEX для спотовой и фьючерсной торговли, обновленной 14 апреля 2026 года. Лимиты меняются при обновлениях системы, поэтому считайте официальную документацию источником истины, а эту страницу — картой.

Что такое лимиты API WEEX и зачем биржа их устанавливает?

Лимит — это потолок частоты запросов. Отправьте больше вызовов, чем позволяет потолок в окне измерения, и сервер перестанет отвечать — в WEEX это сопровождается статусом HTTP 429 Too Many Requests.

Причина не в жадности. Механизм сопоставления ордеров биржи обслуживает всех пользователей на общей инфраструктуре, и один неправильно настроенный цикл, опрашивающий цены 200 раз в секунду, создает реальные издержки для всех остальных. Лимиты также предотвращают манипуляции через спам ордерами. Если вы использовали API WEEX для автоматизированной торговли, вы уже работали в рамках этих бюджетов, независимо от того, заметили вы это или нет.

Практический совет для новичков: думайте о лимите как о бюджете, который пополняется по таймеру, а не как о переключателе вкл/выкл. Ваша задача — спроектировать бюджет запросов, а не реагировать на троттлинг аккаунта.

Лимиты API WEEX по эндпоинтам: важные цифры

Вот часть, которую пропускают большинство статей о лимитах. Это опубликованные потолки WEEX по типам операций.

Четыре детали в этой таблице часто сбивают с толку. Во-первых, лимиты на спотовые и фьючерсные ордера разные — 100/мин против 50/мин — поэтому стратегия, перенесенная с одного рынка на другой, не сохранит свой запас прочности. Во-вторых, квота на отмену ордеров имеет две формы: 80 за 10 секунд позволяет делать рывки по восемь в секунду, но 200 в минуту означает, что вы не сможете удерживать этот темп. В-третьих, лимит соединений отделен от лимита запросов; вы можете быть далеко от бюджета ордеров и все равно получить бан за открытие слишком большого количества сокетов, а документация WebSocket добавляет жесткий потолок в 100 одновременных соединений на IP и 100 каналов на соединение.

В-четвертых, пакетная обработка (batching) — это самая дешевая оптимизация. Страница ограничений доступа к фьючерсам гласит, что пакетный ордер, состоящий из четырех торговых пар по десять ордеров в каждой, считается одним запросом. Тем не менее, страницы отдельных эндпоинтов публикуют свои собственные лимиты и веса, и они не всегда совпадают с общими рекомендациями — поэтому проверяйте конкретный эндпоинт, который вы вызываете, а не предполагайте, что пакет всегда бесплатен.

WEEX также заявляет, что лимит каждого эндпоинта рассчитывается независимо и указан на его собственной странице документации. Не предполагайте наличие общего пула. В частности, Spot V3 измеряет рыночные данные по весу IP для каждого эндпоинта, а не по количеству запросов, поэтому цифра веса на странице эндпоинта — это то, что вас ограничивает.

Применяются ли лимиты WEEX к IP или к аккаунту?

И к тому, и к другому, в зависимости от того, что вы вызываете — и путаница здесь является самым частым источником тикетов "Я в лимитах, почему меня троттлят?".

Запросы с валидным API-ключом учитываются по ключу или аккаунту (userId). Запросы без ключа — публичные рыночные данные — учитываются по вашему публичному IP-адресу.

API спота V3 еще больше заостряет это различие. Каждый эндпоинт, кроме размещения ордера, ограничен по IP с использованием системы весов, где более тяжелые эндпоинты потребляют больше вашего бюджета за вызов. Эндпоинты размещения ордеров учитываются под отдельным типом ORDERS, привязанным к вашему аккаунту, и согласно документации по ограничениям доступа к споту, они не потребляют вес IP — хотя некоторые страницы эндпоинтов все еще указывают вес IP, поэтому читайте страницу того эндпоинта, который вы вызываете.

Операционное следствие легко упустить: запуск трех ботов с одной облачной VM делит один бюджет IP для рыночных данных, независимо от того, сколько у вас API-ключей. И наоборот, перенос потока ордеров на второй сервер никак не поможет с лимитом ордеров на уровне аккаунта.

Как читать заголовки лимитов WEEX до получения ошибки 429

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

Буквы интервала — S, M, H, D для секунды, минуты, часа и дня, поэтому X-USED-WEIGHT-1M — это вес, который ваш IP сжег за последнюю минуту. Логируйте их в каждом ответе, и вы превратите невидимое ограничение в индикатор, по которому можно регулировать скорость — делайте паузу, когда оставшийся вес падает ниже, скажем, 20%, вместо того чтобы ждать отказа сервера.

Чего на самом деле стоит ошибка 429 в WEEX

Превышение лимита — это не бесплатная попытка повтора. Запрос завершается ошибкой 429, и документация спота гласит, что нарушение лимитов приводит к 10-секундному бану. 10 секунд — это вечность, если у вас открыта позиция с плечом, а ваш вызов отмены ордера был тем самым, который отклонили.

Риск второго порядка хуже. WEEX отмечает, что аккаунты, нарушающие правила платформы — включая устойчивые высокочастотные невалидные запросы — могут получить автоматическое отключение API-прав, а для реактивации потребуется тикет в поддержку. Цикл повторных попыток, который долбит по неработающему эндпоинту, не просто попадает под троттлинг; это может выглядеть как злоупотребление.

Два связанных режима отказа вызывают ошибки, которые новички ошибочно принимают за лимиты. Запрос, чей ACCESS-TIMESTAMP отклоняется более чем на 30 секунд от времени сервера, отклоняется сразу (ошибка -1046), что на сбитых часах выглядит как случайный сбой. А WebSocket-соединение, открытое без заголовка User-Agent, блокируется файрволом с ошибкой 403, а не 429 — решение в заголовке, а не в замедлении цикла.

Четыре способа, которыми новички сжигают лимиты API WEEX

Расчеты здесь — самая полезная часть, потому что лимиты кажутся щедрыми, пока вы не начнете умножать.

Опрос каждого символа отдельно. Запрос тикеров для 50 символов раз в секунду — это 50 отдельных вызовов в секунду, в пять раз больше темпа 10 в секунду, который позволяет публичный лимит 20 каждые 2 секунды — и это постоянный перебор. Большинство эндпоинтов рыночных данных принимают список символов, так что та же задача часто решается одним вызовом. Еще лучше — перейдите на WebSocket-поток, который сам пушит обновления, вместо того чтобы вы их запрашивали.

Слишком быстрая перекотировка сетки. Сетка из 20 уровней, которая отменяет и заменяет каждый уровень каждые 10 секунд, генерирует 120 размещений в минуту. Это превышает спотовый потолок в 100 и более чем вдвое — фьючерсный в 50. Увеличение интервала перекотировки до 30 секунд вписывает ту же стратегию в оба лимита.

Штормы переподключений. WebSocket-клиент, который отключается и немедленно пытается переподключиться в узком цикле, может потребить бюджет в 300 соединений за 5 минут на IP менее чем за минуту. Каждое переподключение требует экспоненциальной задержки и джиттера, а не мгновенной попытки.

Повтор запроса при 429. Самая дорогая ошибка — считать 429 временной сетевой ошибкой и немедленно повторять запрос. WEEX прямо заявляет, что при получении 429 вы обязаны остановиться. Экспоненциальная задержка (backoff) — удваивайте ожидание каждый раз, ограничьте его, добавьте джиттер — это стандартный ответ, которого ждет биржа.

Как построить бота, который остается в лимитах API WEEX

Спроектируйте бюджет до написания стратегии. Решите, сколько ордеров в минуту реально нужно вашей логике, сравните это с потолками в таблице выше и оставьте 30–40% запаса на случай волатильности, когда бот естественным образом захочет торговать больше.

Затем разделите транспорт по задачам. REST для дискретных действий — размещение, отмена, запрос балансов. WebSocket для всего остального: обновления стакана, тикеры, исполнения. Перенос рыночных данных на поток обычно убирает большую часть объема запросов простого бота одним махом и одновременно снижает задержку.

Добавьте клиентский ограничитель частоты вместо того, чтобы полагаться на отказ сервера. Токен-бакет (token bucket), настроенный чуть ниже опубликованного лимита, означает, что ваш код ставит излишки в очередь, а не собирает баны. Логируйте каждую 429 с эндпоинтом и таймстемпом, чтобы видеть, какой вызов на самом деле является нарушителем — часто это не тот, на который вы думаете.

Наконец, держите права доступа узкими во время экспериментов. Ограничьте API-ключи тем, что нужно боту, включите IP-вайтлистинг и помните, что новые или измененные ключи распространяются по системе около 15 минут, поэтому мгновенный отказ в аутентификации после создания ключа — это обычно вопрос распространения, а не ошибка кода. Детали по каждому эндпоинту для каждого рынка живут в FAQ по спотовому API WEEX и FAQ по фьючерсному API WEEX.

Итог по лимитам API WEEX

Лимиты API WEEX — это не препятствие, которое нужно обходить; это ограничение дизайна, которое отделяет бота, выживающего в волатильную сессию, от того, который получает бан. Выучите три цифры, управляющие вашей стратегией — лимит ордеров, лимит публичных данных и лимит соединений — настройте логирование заголовков ответов, чтобы видеть остаток бюджета, и правильно отступайте при получении 429. Это большая часть работы.

Готовы протестировать стратегию на реальных эндпоинтах? Создайте API-ключ в аккаунте WEEX, начните с прав «только чтение» и одного символа, и убедитесь, что учет запросов верна, прежде чем включать торговые права.

FAQ

1. Что произойдет, если я превышу лимит API WEEX?

Запрос завершится ошибкой HTTP 429 Too Many Requests, и документация спота гласит, что нарушение лимитов приводит к 10-секундному бану. Устойчивые высокочастотные невалидные запросы могут также вызвать срабатывание систем контроля рисков платформы, что может привести к отключению API-прав до обращения в поддержку.

2. Лимиты API WEEX применяются к IP или к API-ключу?

И к тому, и к другому. Эндпоинты, требующие API-ключ, учитываются по аккаунту, а публичные эндпоинты без ключа — по IP. В API спота V3 размещение ордеров ограничено по аккаунту (userId) под типом ORDERS, а все остальное — по весу IP.

3. Сколько ордеров в минуту я могу разместить на WEEX?

Согласно документации, обновленной 14 апреля 2026 года, спот позволяет 100 размещений ордеров в минуту, а фьючерсы — 50 в минуту. Отмены на споте ограничены 80 за 10 секунд или 200 в минуту; отмены на фьючерсах — 50 в минуту.

4. Учитывается ли WebSocket в лимите REST-запросов WEEX?

Не напрямую, но у WebSocket свои бюджеты: 300 запросов на REST/WS-соединение за 5 минут на IP с макс. 100 одновременными соединениями, и 240 подписок на каналы в час на соединение с макс. 100 открытыми каналами. Перенос рыночных данных на WebSocket — самый эффективный способ снизить объем REST-запросов.

5. Почему я получаю ошибки, хотя я в лимитах?

Проверьте три вещи, прежде чем грешить на троттлинг. Таймстемп, отличающийся от времени сервера более чем на 30 секунд, отклоняется как -1046. WebSocket-соединение без заголовка User-Agent возвращает 403. А новый или измененный API-ключ распространяется по системе около 15 минут.

6. Считаются ли пакетные ордера как один запрос на WEEX?

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

Предупреждение о рисках

Криптоактивы крайне волатильны, и торговля ими может привести к частичной или полной потере капитала. API и автоматизированная торговля добавляют риски, которых нет в ручной торговле: бан по лимиту может оставить вас без возможности отменить или закрыть позицию во время резкого движения, сбой переподключения может оставить стратегию «слепой» к исполнениям, а ошибка в коде может исполнить непреднамеренный объем за секунды. Фьючерсы с плечом усиливают каждый из этих исходов и могут привести к ликвидации. Компрометация API-ключей — это прямой риск кастодиального хранения: ограничьте права доступа минимумом, включите IP-вайтлистинг и никогда не делитесь ключами или секретами. Лимиты, эндпоинты и коды ошибок могут меняться при обновлениях системы; всегда сверяйтесь с текущей официальной документацией API WEEX перед деплоем. Ничто из этого не является инвестиционным советом.