Быстрый старт

Начните работу с Polymarket API за 5 минут.

1. Получить события

Получите список активных событий через Gamma API:

curl "https://gamma-api.polymarket.com/events?active=true&closed=false&limit=10"

Ответ содержит события с массивом markets. Каждый market имеет clobTokenIds.

2. Получить цену

Используйте token_id из шага 1:

# Цена покупки Yes токена
curl "https://clob.polymarket.com/price?token_id=TOKEN_ID&side=buy"

# Ответ: {"price": "0.65"}

3. Получить ордербук

curl "https://clob.polymarket.com/book?token_id=TOKEN_ID"

Возвращает массивы bids (покупка) и asks (продажа).

4. Подписаться на обновления

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

ws.onopen = () => {
  ws.send(JSON.stringify({
    type: "subscribe",
    channel: "market",
    assets_ids: ["TOKEN_ID"]
  }));
};

ws.onmessage = (e) => console.log(JSON.parse(e.data));

5. Торговля (опционально)

Для торговли установите SDK:

# Python
pip install py-clob-client

# TypeScript
npm install @polymarket/clob-client

Создайте API ключ и начните торговать. См. Аутентификация.

Полезные ссылки

Gamma API	Метаданные рынков
CLOB API	Цены и торговля
Data API	Позиции и лидерборд
WebSocket	Real-time данные
Глоссарий	Термины

Типичный workflow

# 1. Найти рынок
curl "https://gamma-api.polymarket.com/search?query=bitcoin&type=markets"

# 2. Получить детали рынка
curl "https://gamma-api.polymarket.com/markets/MARKET_ID"

# 3. Извлечь token_id из clobTokenIds[0] (Yes) или clobTokenIds[1] (No)

# 4. Получить цену и ордербук
curl "https://clob.polymarket.com/price?token_id=TOKEN_ID&side=buy"
curl "https://clob.polymarket.com/book?token_id=TOKEN_ID"

# 5. Смотреть историю
curl "https://clob.polymarket.com/prices-history?market=TOKEN_ID&interval=1d"