Events

События (Events) представляют вопросы на Polymarket. Каждое событие может содержать один или несколько рынков.

GET /events

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

Query параметры

Параметр	Тип	Описание
id	string	ID события optional
slug	string	Slug из URL optional
tag_id	integer	Фильтр по тегу optional
series_id	integer	Фильтр по серии optional
active	boolean	Только активные optional
closed	boolean	Только закрытые optional
limit	integer	Количество (макс. 100) optional
offset	integer	Смещение optional
order	string	Поле сортировки optional
ascending	boolean	Направление сортировки optional

Пример

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

Ответ

[
  {
    "id": "123456",
    "slug": "will-bitcoin-reach-100k",
    "title": "Will Bitcoin reach $100k?",
    "description": "This market resolves Yes if...",
    "active": true,
    "closed": false,
    "liquidity": 150000.50,
    "volume": 2500000.00,
    "volume24hr": 125000.00,
    "startDate": "2024-01-01T00:00:00Z",
    "endDate": "2025-12-31T23:59:59Z",
    "image": "https://polymarket-upload.s3.amazonaws.com/...",
    "tags": [{"id": "21", "label": "Crypto", "slug": "crypto"}],
    "markets": [
      {
        "id": "789",
        "question": "Will Bitcoin reach $100k?",
        "conditionId": "0x1234...",
        "outcomes": "[\"Yes\", \"No\"]",
        "outcomePrices": "[\"0.65\", \"0.35\"]",
        "clobTokenIds": ["TOKEN_YES", "TOKEN_NO"]
      }
    ]
  }
]

GET /events/{id}

Возвращает одно событие по внутреннему числовому ID. Используйте, когда ID уже известен из предыдущих запросов или хранится в вашей базе данных. Быстрее, чем фильтрация через /events?id=.

curl "https://gamma-api.polymarket.com/events/123456"

GET /events/slug/{slug}

Возвращает одно событие по slug — человекочитаемому идентификатору из URL страницы на Polymarket. Удобен, когда пользователь делится ссылкой или вы парсите URL вида polymarket.com/event/will-bitcoin-reach-100k.

curl "https://gamma-api.polymarket.com/events/slug/will-bitcoin-reach-100k"

Поля ответа

Поле	Тип	Описание
id	string	Уникальный ID
slug	string	URL-friendly идентификатор
title	string	Заголовок
active	boolean	Событие активно
closed	boolean	Закрыто для торговли
volume	number	Общий объём (USD)
volume24hr	number	Объём за 24ч (USD)
liquidity	number	Ликвидность (USD)
markets	array	Массив рынков
tags	array	Массив тегов

Примеры

# Топ по объёму
curl "https://gamma-api.polymarket.com/events?active=true&closed=false&order=volume&ascending=false&limit=20"

# По категории
curl "https://gamma-api.polymarket.com/events?tag_id=2&active=true"

# Спортивная лига
curl "https://gamma-api.polymarket.com/events?series_id=10345&active=true"