Polymarket API

Polymarket предоставляет API для разработчиков: получение данных о рынках, создание торговых ботов, интеграция в аналитические системы. Разбираем endpoints, примеры запросов и практическое применение.

Обзор API

API Polymarket позволяет программно взаимодействовать с платформой:

• Получать данные о рынках и ценах
• Анализировать исторические данные
• Размещать и отменять ордера
• Управлять позициями
• Создавать торговых ботов

Типы API:

• REST API: Стандартные HTTP-запросы для получения данных
• WebSocket API: Подключение для получения данных в реальном времени
• Smart Contract API: Прямое взаимодействие со смарт-контрактами

Начало работы

Публичные данные (без авторизации)

Для чтения данных о рынках авторизация не требуется. Можете делать запросы напрямую.

Базовый URL: https://clob.polymarket.com

Пример: Получение списка рынков

GET /markets

Ответ содержит список активных рынков с информацией о событиях, ценах, объёмах.

Торговля (требует подпись транзакций)

Для размещения ордеров нужен подключённый Web3-кошелёк:

1. Подключите кошелёк через ethers.js или web3.js
2. Создайте ордер (параметры: рынок, цена, размер)
3. Подпишите ордер приватным ключом кошелька
4. Отправьте подписанный ордер через API

Основные Endpoints

Получение рынков

Endpoint: GET /markets

Параметры:

• active — только активные рынки (true/false)
• closed — только закрытые рынки (true/false)
• limit — количество результатов
• offset — смещение для пагинации

Пример ответа:

{
  "data": [
    {
      "id": "123456",
      "question": "Победит ли кандидат А на выборах?",
      "end_date": "2025-12-31T00:00:00Z",
      "outcomes": ["Да", "Нет"],
      "prices": [0.65, 0.35],
      "volume": 1250000
    }
  ]
}

Получение ордербука

Endpoint: GET /book

Параметры:

• token_id — ID токена рынка

Возвращает все активные ордера на покупку и продажу с ценами и объёмами.

Получение исторических данных

Endpoint: GET /prices-history

Параметры:

• market — ID рынка
• startTs — начальная временная метка
• endTs — конечная временная метка
• interval — интервал (1m, 5m, 1h, 1d)

Возвращает исторические цены для построения графиков и анализа.

Размещение ордера

Endpoint: POST /order

Тело запроса:

{
  "market": "market_id",
  "side": "BUY",
  "price": "0.65",
  "size": "100",
  "signature": "0x..."
}

Ордер должен быть подписан приватным ключом кошелька.

WebSocket API

Для получения обновлений в реальном времени используйте WebSocket:

URL: wss://ws-subscriptions.polymarket.com

Подписка на обновления рынка

{
  "type": "subscribe",
  "channel": "market",
  "market_id": "123456"
}

После подписки получаете обновления цен, новые ордера, сделки в реальном времени.

Подписка на сделки

{
  "type": "subscribe",
  "channel": "trades",
  "market_id": "123456"
}

Получаете информацию о каждой совершённой сделке: цена, объём, время.

Примеры использования

Python: Получение списка рынков

import requests

url = "https://clob.polymarket.com/markets"
params = {"active": "true", "limit": 10}

response = requests.get(url, params=params)
markets = response.json()

for market in markets["data"]:
    print(f"{market['question']} - Price: {market['prices'][0]}")

JavaScript: Подключение к WebSocket

const ws = new WebSocket("wss://ws-subscriptions.polymarket.com");

ws.onopen = () => {
  ws.send(JSON.stringify({
    type: "subscribe",
    channel: "market",
    market_id: "123456"
  }));
};

ws.onmessage = (event) => {
  const data = JSON.parse(event.data);
  console.log("Price update:", data);
};

Python: Создание простого бота для мониторинга

import requests
import time

def monitor_price(market_id, target_price):
    url = f"https://clob.polymarket.com/markets/{market_id}"
    
    while True:
        response = requests.get(url)
        market = response.json()
        current_price = market["prices"][0]
        
        print(f"Current price: {current_price}")
        
        if current_price <= target_price:
            print("Target price reached!")
            # Здесь код для размещения ордера
            break
        
        time.sleep(10)  # Проверка каждые 10 секунд

monitor_price("123456", 0.60)

Торговые боты: идеи и стратегии

Арбитражный бот

Логика: Мониторит цены на Polymarket и других платформах. При обнаружении разницы автоматически покупает на одной платформе, продаёт на другой.

Требования:

• API доступ к нескольким платформам
• Быстрое исполнение (WebSocket для real-time данных)
• Управление балансами на нескольких платформах

Бот торговли на новостях

Логика: Парсит новостные ленты (Twitter, RSS), анализирует влияние на события, автоматически размещает ордера.

Требования:

• Интеграция с новостными API
• NLP для анализа текста новостей
• Быстрая реакция (секунды)

Маркет-мейкер бот

Логика: Размещает ордера на покупку и продажу, зарабатывает на спреде. Постоянно обновляет ордера в зависимости от рынка.

Требования:

• Мониторинг ордербука
• Динамическое ценообразование
• Управление инвентарём (баланс позиций)

Библиотеки и инструменты

Python

• requests: HTTP-запросы к REST API
• web3.py: Взаимодействие со смарт-контрактами Ethereum/Polygon
• pandas: Анализ исторических данных
• asyncio, websockets: Асинхронная работа с WebSocket

JavaScript/TypeScript

• ethers.js: Web3-библиотека для подписания транзакций
• axios: HTTP-клиент
• ws: WebSocket-клиент

Готовые решения

• Polymarket SDK (если доступен) — официальная библиотека
• Примеры кода на GitHub
• Сообщество разработчиков в Discord

Безопасность при работе с API

Защита приватных ключей

• Никогда не храните ключи в коде: Используйте переменные окружения
• Отдельный кошелёк для бота: Не используйте основной кошелёк
• Ограничьте средства: Держите на боте только необходимую сумму

Управление рисками

• Лимиты на позиции: Ограничьте максимальную сумму на одну сделку
• Стоп-лоссы: Автоматическая продажа при достижении убытка
• Тестирование: Запускайте бота на малых суммах
• Логирование: Записывайте все действия бота

Rate Limits

• Соблюдайте лимиты на запросы
• Кешируйте данные, которые не меняются часто
• Используйте WebSocket вместо polling для real-time данных

Частые вопросы

Похожие материалы

• Как заработать на Polymarket
• Как работает Polymarket
• Пополнение и вывод средств