Лимиты запросов API Polymarket: полный справочник

Если вы когда-нибудь пытались ответить на простой вопрос — сколько запросов в секунду можно отправлять в Polymarket? — то обнаружили, что простого ответа нет. Лимиты разбросаны по двум отдельным системам, опубликованы на разных страницах и выражены в 10-секундном окне, а не в запросах в секунду или в минуту, как у большинства API.

Лимит для конкретного маршрута также указан на отдельной странице каждого эндпоинта в справочнике API Polymarket.

На этой странице собраны все задокументированные лимиты, объяснены обе системы и показано, что на самом деле происходит при их превышении. Все цифры взяты из официальной документации Polymarket и актуальны на сентябрь 2026 года.

Две разные системы лимитов

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

Лимиты запросов Gamma API

Базовый URL https://gamma-api.polymarket.com. Gamma отдаёт метаданные рынков и событий — к этим эндпоинтам большинство обращается первыми, когда изучает платформу.

Лимиты запросов Data API

Базовый URL https://data-api.polymarket.com. Позиции, история сделок и данные портфеля. Обратите внимание, насколько этот API жёстче, чем Gamma или CLOB: общий лимит — 1,000 запросов / 10 с, четверть от лимита Gamma.

Data API v2

Data API v2 вышел 4 сентября 2026 года по адресу https://data-api.polymarket.com/v2 с собственными лимитами. v1 продолжает работать, но заморожен — новые эндпоинты и поля появляются только в v2.

Лимиты запросов CLOB API

Базовый URL https://clob.polymarket.com. Сам стакан. У CLOB самый высокий общий лимит среди всех API Polymarket (9,000 запросов / 10 с), но он делится на четыре группы с очень разными лимитами.

Общие

Рыночные данные

Закономерность, которую стоит заметить: эндпоинты в единственном числе получают 1,500 запросов / 10 с, пакетные во множественном — 500 запросов / 10 с. Это похоже на понижение, пока не вспомнишь, что один пакетный вызов охватывает много токенов. По лимиту пакетный запрос втрое дороже, но каждый вызов делает гораздо больше работы — всегда выбирайте /books, а не цикл по /book.

Журнал

Аутентификация

Торговля — всплеск и устойчивый темп

Торговые эндпоинты — единственные, у которых два лимита Cloudflare: лимит всплеска для коротких пиков и устойчивый лимит, измеряемый за 10 минут. Нужно укладываться в оба.

Отдельно стоит отметить DELETE /cancel-all с 250 запросами / 10 с. Маркетмейкеры, которые делают cancel-all в каждом цикле перекотировки, быстро исчерпывают этот лимит, а устойчивый лимит в 6,000 за 10 минут в среднем даёт всего 10 вызовов cancel-all в секунду.

Bridge, Relayer и всё остальное

Token bucket на подписанта (торговля в CLOB)

Отдельно от Cloudflare Polymarket проверяет запросы ордеров и отмен в CLOB по token bucket на каждого подписанта. У каждого адреса подписанта есть bucket ордеров и bucket отмен; расход из одного не влияет на другой. В отличие от слоя Cloudflare, превышение здесь возвращает настоящий 429.

Запросы стоят токенов, а не считаются как одна единица каждый:

Уровни по объёму

Размер вашего bucket зависит от совокупного объёма кошелька-мейкера за скользящие 30 дней. Уровни пересчитываются каждые три часа.

Сколько длится полный всплеск, считается по формуле burst_seconds = burst / rate_per_sec. Для подписанта уровня Standard это 60 / 40 — 1.5 секунды отправки ордеров на полной скорости, после чего вы ограничены скоростью пополнения 40/с.

Как читать заголовки лимитов

Ограничитель на подписанта возвращает заголовки в каждом проверенном запросе. Это самый дешёвый способ следить за бюджетом — никаких дополнительных вызовов API.

Правильная обработка 429

Правильная стратегия повторов зависит от того, в какой ограничитель вы упёрлись, и ошибка здесь делает только хуже. Соблюдайте Retry-After, если он есть; если нет — используйте экспоненциальный отступ со случайным разбросом. Разброс важен: без него все ваши обработчики повторяют запрос в один и тот же момент, и вы сразу снова упираетесь в лимит.

const MAX_RETRIES = 5;

async function polyFetch(url: string, init?: RequestInit): Promise<Response> {
  for (let attempt = 0; attempt <= MAX_RETRIES; attempt++) {
    const res = await fetch(url, init);

    // Watch the budget even on success — this is your early warning.
    const remaining = res.headers.get("Poly-RateLimit-Remaining");
    if (remaining !== null && Number(remaining) < 10) {
      console.warn(`Low token budget: ${remaining} (tier ${res.headers.get("Poly-RateLimit-Tier")})`);
    }

    // Warning mode: not rejected yet, but it would have been.
    if (res.headers.get("Poly-RateLimit-Warning") === "true") {
      console.warn("Request would be rejected under live enforcement — slow down.");
    }

    if (res.status !== 429) return res;
    if (attempt === MAX_RETRIES) return res;

    // Prefer the server's own answer, else exponential backoff.
    const retryAfter = res.headers.get("Retry-After");
    const baseMs = retryAfter
      ? Number(retryAfter) * 1000
      : Math.min(2 ** attempt * 250, 8000);

    // Full jitter — spreads a fleet of workers out instead of resynchronising them.
    await new Promise((r) => setTimeout(r, Math.random() * baseMs));
  }

  throw new Error("unreachable");
}

Как изначально укладываться в лимиты

• Используйте пакеты вместо циклов. Один вызов /books вместо пятидесяти вызовов /book стоит одного запроса из бюджета 500 запросов / 10 с, а не пятидесяти из бюджета 1,500 запросов / 10 с — запас увеличивается в 17 раз.
• Кешируйте метаданные. Метаданные рынка из /markets почти не меняются за время жизни рынка, а у /markets самый жёсткий лимит в Gamma — 300 запросов / 10 с. Получите один раз, закешируйте и перестаньте запрашивать их заново в горячем цикле.
• Используйте WebSocket для текущего состояния. Опрос /book по таймеру — самый частый способ сжечь бюджет запросов. Подпишитесь на поток, и пусть сервер сам присылает изменения.
• Добавляйте случайный разброс к запланированным задачам. Если каждый обработчик просыпается ровно в начале минуты, вы создаёте синхронный всплеск намного выше среднего темпа. Рандомизируйте смещения запуска.
• Следите за задержкой, а не только за долей ошибок. Поскольку Cloudflare замедляет, а не отклоняет, рост задержки p99 — первый сигнал превышения лимита по IP, задолго до того, как что-то проявится в виде ошибок.
• Отслеживайте заголовки. Poly-RateLimit-Remaining ничего не стоит прочитать, и он точно говорит, сколько бюджета осталось.

Лимиты запросов — это не то же самое, что доступ к данным

И последнее, о чём стоит сказать прямо, потому что это самое частое заблуждение, которое мы видим: ни один уровень лимитов не даёт историческую глубину стакана. API Polymarket отдаёт текущее состояние стакана. Он не предоставляет исторический архив того, как выглядел стакан в 14:03:17 прошлого вторника, а после разрешения рынка его стакан возвращает 404.

Это структурный пробел, а не проблема ограничения скорости, и никакая логика отступа его не решит. Если вы пытаетесь провести бэктест стратегии, вам нужны снимки на конкретный момент времени, которые кто-то записал в то время, — ровно для этого и существует PolyTest: 240M+ исторических снимков крипторынков Polymarket Up/Down с полной глубиной стакана, разрешением до долей секунды и без пропусков.