Как создать торгового бота для Polymarket

Бот для Polymarket состоит из шести частей: найти рынки, прочитать цены, принять решение, выставить ордера, управлять позициями и не упасть. Первые две простые, четвёртая муторная, а на шестой большинство ботов и погибает. Это руководство проходит весь путь с проверенным кодом и честно говорит о действительно сложных местах.

Шаг 0: решите, чем торгует ваш бот

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

Если вы автоматизируете, вас почти наверняка интересует второе семейство — высокая частота, непрерывность и достаточно механики, чтобы закодировать. Они подробно разобраны в статье Рынки Up/Down: как они устроены.

Шаг 1: установите актуальный SDK

Оба SDK дают единый клиентский интерфейс ко всем API Polymarket, типизированные модели, единообразную пагинацию и встроенную подпись — а это большой объём муторной работы, которую вы не захотите реализовывать заново.

pip install polymarket-client
# or: uv add polymarket-client / poetry add polymarket-client

Клиентов для Python четыре, и правильный выбор важнее, чем кажется:

Шаг 2: найдите рынки

Для поиска публичных рынков учётные данные вообще не нужны. Пагинатор SDK работает одинаково во всех методах получения списков, так что этот шаблон применим везде.

import asyncio
from polymarket import AsyncPublicClient


async def main() -> None:
    async with AsyncPublicClient() as client:
        pages = client.list_markets(closed=False, page_size=50)

        # Iterate items directly when page boundaries do not matter.
        async for market in pages.iter_items():
            if "updown" in (market.slug or ""):
                print(market.slug, market.condition_id)


asyncio.run(main())

Здесь важно усвоить две вещи. Во-первых, page.next_cursor — это непрозрачный курсор: сохраняйте его как есть, если хотите продолжить обход позже, и не пытайтесь его разбирать или конструировать. Во-вторых, у /markets самый жёсткий лимит запросов на всей платформе — 300 запросов / 10 с, поэтому кешируйте метаданные рынков, а не запрашивайте их список заново в горячем цикле. Все цифры — в справочнике по лимитам запросов.

Шаг 3: пройдите аутентификацию

Для торговли нужен кошелёк. Python SDK создаёт подписанта из локального приватного ключа:

import os
from polymarket import AsyncSecureClient

client = await AsyncSecureClient.create(
    private_key=os.environ["POLYMARKET_PRIVATE_KEY"],
    wallet=os.environ["POLYMARKET_WALLET_ADDRESS"],
)

Под капотом Polymarket использует два уровня аутентификации: L1 — это подпись кошелька EIP-712, которая доказывает, что вы контролируете адрес, и позволяет создать или получить учётные данные API; L2 подписывает каждый приватный запрос этими учётными данными с помощью HMAC-SHA256. SDK берёт на себя оба уровня — это главная причина им пользоваться.

Шаг 4: получайте цены в реальном времени

Самая частая архитектурная ошибка в первом боте — опрашивать /book по таймеру. Это сжигает бюджет лимита запросов, добавляет задержку и плохо масштабируется. Вместо этого подписывайтесь — SDK объединяет несколько потоков в один поток событий.

from polymarket.streams import MarketSpec

async with await client.subscribe([MarketSpec(token_ids=[token_id])]) as stream:
    async for event in stream:
        # MarketBookEvent | MarketPriceChangeEvent | MarketLastTradePriceEvent
        # | MarketTickSizeChangeEvent | MarketBestBidAskEvent
        # | NewMarketEvent | MarketResolvedEvent
        handle(event)

Если вы подключаетесь к WebSocket напрямую, а не через SDK, вы обязаны отправлять PING каждые 10 секунд, иначе соединение будет разорвано, а чтобы вообще получать события best_bid_ask, new_market и market_resolved, нужен параметр custom_feature_enabled: true. Это и шаблоны переподключения разобраны в руководстве по WebSocket. Отдельно: 15 сентября 2026 года референсные цены переехали на PolyBolt — если ваш бот получает поток спот-цен, см. руководство по миграции.

Шаг 5: выставьте ордер

Рыночный ордер — самое простое, что работает, и amount указывается в pUSD, которые вы готовы потратить, а не в акциях:

market = await client.get_market(slug="<market-slug>")
token_id = market.outcomes.yes.token_id
assert token_id is not None

response = await client.place_market_order(
    token_id=token_id,
    side="BUY",
    amount="10",          # spend up to 10 pUSD
)

if not response.ok:
    raise RuntimeError(response.message)

# Settlement is on-chain and asynchronous — this waits for it.
hashes = await client.wait_for_order_fill_settlement(response)

С лимитными ордерами в стакане раньше всего остального вас укусят два правила. Цены должны лежать на сетке тиков рынка — вызывайте GET /tick-size для каждого рынка, а не предполагайте 0.01, потому что размер тика различается и может уменьшаться по мере взросления рынка. А ордера меньше минимального размера рынка отклоняются сразу. Оба случая возвращаются как 400 с конкретными сообщениями, перечисленными в справочнике по ошибкам.

Шаг 6: узнайте, работает ли стратегия

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

Тестовой сети нет. Ни песочницы, ни демо-API, ни эндпоинта для бумажной торговли. Этих слов нет нигде в документации Polymarket. Ваш первый настоящий ордер — это реальные деньги против реальных контрагентов. Четыре обходных пути — в статье Есть ли у Polymarket тестовая сеть.

И исторического стакана тоже нет. После разрешения рынка его стакан возвращает 404. Сохраняется ценовой ряд примерно с одной точкой в минуту, и то лишь если запрашивать с явно заданными началом и концом:

TOK=<token_id_of_a_resolved_market>
START=<epoch seconds the window opened>
END=$((START + 300))

curl -s "https://clob.polymarket.com/book?token_id=$TOK"
# {"error":"No orderbook exists for the requested token id"}   HTTP 404

curl -s "https://clob.polymarket.com/prices-history?market=$TOK&startTs=$START&endTs=$END&fidelity=1"
# about 6 points for a 5-minute market; interval=max returns [] for older ones

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

import os, requests

BASE = "https://api.polytest.io/api/v1"
H = {"X-API-Key": os.environ["POLYTEST_KEY"]}

markets = requests.get(f"{BASE}/markets",
                       params={"coin": "btc", "market_type": "5m", "limit": 50},
                       headers=H).json()["markets"]

snaps = requests.get(f"{BASE}/markets/{markets[0]['id']}/snapshots",
                     params={"include_orderbook": "true"},
                     headers=H).json()["snapshots"]


def simulate_fill(levels, qty):
    """Walk the ladder. Mid-price is not a price you can trade at."""
    filled = cost = 0.0
    for lvl in levels:
        take = min(lvl["size"], qty - filled)
        cost += take * lvl["price"]
        filled += take
        if filled >= qty:
            break
    return cost / filled if filled >= qty else None


print(simulate_fill(snaps[0]["orderbook"]["asks"], 500))

Шаг 7: переживите встречу с продакшеном

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

• Тестируйте путь отмены до пути входа. Не суметь выйти гораздо хуже, чем не суметь войти.
• Ограничивайте экспозицию в коде, а не в голове. Жёсткий лимит позиции превращает логическую ошибку в небольшой убыток, а не в неограниченный.
• Сделайте аварийный выключатель и действительно проверьте его. Непроверенный аварийный выключатель — это просто комментарий.
• Добавляйте случайный разброс к запланированным задачам. Обработчики, просыпающиеся в одну и ту же секунду, создают синхронный всплеск, намного превышающий ваш средний темп.
• Логируйте каждый запрос и ответ в первую неделю. Они вам понадобятся, а восстановить их потом невозможно.
• Оповещайте по категориям, а не по сообщениям. Polymarket встраивает ID ордеров и цены в строки ошибок, поэтому оповещения по сырым строкам — чистый шум.

Реалистичный порядок разработки

Последовательность, которая тратит меньше всего времени и денег:

1. Интеграция только на чтение, публичный клиент, без ключей. Докажите, что поиск рынков, парсинг, пагинация и отступ работают. Один день, бесплатно.
2. Бэктест стратегии на исторических стаканах с честным моделированием исполнения. Большинство идей умирают здесь. В этом и смысл.
3. Бумажная торговля вживую минимум неделю — записывайте предполагаемые ордера в лог вместо отправки. Это доказывает аптайм, переподключения и тайминг.
4. Выход в живую торговлю с минимальным размером с жёстким лимитом экспозиции и проверенным аварийным выключателем.
5. Масштабируйтесь, только когда живые цифры совпадают с бумажными. Если они расходятся, ваша модель исполнения была неверной — вернитесь к шагу 2.

Шаги 1, 3 и 4 можно построить за несколько дней. Для шага 2 нужны данные, которые Polymarket не хранит, и именно этот шаг надёжнее всего экономит деньги. Начните бесплатный пробный период в PolyTest — этого хватит, чтобы выяснить, переживёт ли ваша идея спред.