Поддерживаемые рынки

Активы, таймфреймы, схемы данных и правила доступности данных в API PolyTest.

Активы и таймфреймы

Активов: 6

PolyTest отслеживает рынки предсказаний Polymarket по каждому активу. Каждый актив поддерживает часть таймфреймов рынков (длительность от открытия до разрешения). Снимки делаются 8 раз в секунду на всех таймфреймах. Для фильтрации в API используйте coin и market_type.

Актив	Параметр API	Таймфреймы	Частота снимков
BTC Bitcoin `coin="btc"`	`coin="btc"`	5m15m1hr4hr24hr	8×/с
ETH Ethereum `coin="eth"`	`coin="eth"`	5m15m1hr	8×/с
SOL Solana `coin="sol"`	`coin="sol"`	5m15m1hr	8×/с
XRP XRP Скоро Сбор данных `coin="xrp"`	`coin="xrp"`	5m15m1hr4hr24hr	8×/с
DOGE Dogecoin Скоро Сбор данных `coin="doge"`	`coin="doge"`	5m15m1hr4hr24hr	8×/с
BNB BNB Скоро Сбор данных `coin="bnb"`	`coin="bnb"`	5m15m1hr4hr24hr	8×/с

~Снимков на рынок = длительность × 8 (например, 5m ≈ 2,400, 24h ≈ 691,200).

Доступность данных

Доступность данных зависит от вашего тарифа: Builder (и 3-дневный бесплатный пробный период, который полностью его включает) охватывает недавнее окно, а у Pro и Enterprise доступ к истории не ограничен. Для запросов по диапазону каждый запрос поддерживает окно не более 31 дня.

Builder

14 дней

Доступ примерно к 14 дням исторических данных о рынках и снимках — в том числе во время 3-дневного бесплатного пробного периода.

Pro

Enterprise

Без ограничений

Полный доступ к истории, а также индивидуальные правила доступности данных и массовая выгрузка.

Максимальное окно данных: промежуток от start_time до end_time ограничен 31 днём. Более старые данные удаляются через 31 день.

Схема объекта рынка

Каждый рынок, возвращаемый API, содержит следующие поля.

Поле	Тип	Описание
`market_id`	`string`	Уникальный числовой идентификатор рынка
`event_id`	`string`	ID родительского события на Polymarket
`slug`	`string`	Человекочитаемый slug для URL (например, btc-updown-5m-1772689200)
`market_type`	`string`	Тип длительности: 5m \| 15m \| 1h \| 4h \| 24h
`coin`	`string`	Криптовалюта: btc \| eth \| sol \| xrp \| doge \| bnb
`start_time`	`ISO 8601`	Когда рынок открылся для торгов
`end_time`	`ISO 8601`	Когда рынок разрешился
`price_start`	`number`	Спот-цена актива на открытии рынка
`price_end`	`number \| null`	Спот-цена актива на закрытии рынка (null, если рынок не разрешён)
`winner`	`string \| null`	Исход: "Up" или "Down" (null, если рынок не разрешён)
`final_volume`	`number`	Общий объём торгов на рынке
`final_liquidity`	`number`	Общая ликвидность на закрытии рынка
`condition_id`	`string`	Ончейн-идентификатор условия
`clob_token_up`	`string`	ID токена CLOB для исхода "Up"
`clob_token_down`	`string`	ID токена CLOB для исхода "Down"
`resolved_at`	`ISO 8601 \| null`	Метка времени разрешения рынка
`created_at`	`ISO 8601`	Когда запись была создана в PolyTest
`updated_at`	`ISO 8601`	Метка времени последнего обновления

Схема объекта снимка

Снимки фиксируют состояние рынка на конкретный момент времени, включая цены, вероятности и необязательную глубину стакана.

Поле	Тип	Описание
`id`	`integer`	Уникальный идентификатор строки
`market_id`	`string`	ID родительского рынка (внешний ключ)
`time`	`ISO 8601`	Метка времени этого снимка
`spot_price`	`number \| null`	Спот-цена актива на момент снимка
`price_up`	`number \| null`	Вероятность исхода "Up" (0.00–1.00)
`price_down`	`number \| null`	Вероятность исхода "Down" (0.00–1.00)
`orderbook_up`	`object \| null`	Полный стакан для токена "Up" (по запросу)
`orderbook_down`	`object \| null`	Полный стакан для токена "Down" (по запросу)

Поля стакана включаются, только если передать в запросе include_orderbook=true. Данные стакана доступны только на тарифах Builder, Pro и Enterprise.

Как устроены рынки

Каждый рынок — это бинарное предсказание: пойдёт ли цена заданной криптовалюты Up или Down в пределах таймфрейма рынка?

Жизненный цикл рынка

1Рынок открывается — задаётся start_time, начинаются торги
2Снимки делаются 8 раз в секунду — цены-вероятности обновляются в реальном времени
3Рынок разрешается — winner принимает значение "Up" или "Down"
4Данные архивируются — снимки по-прежнему доступны через API

Цены-вероятности

price_up и price_down — это вероятности, подразумеваемые рынком, от 0.00 до 1.00.

price_up = 0.65 означает, что рынок оценивает в 65% вероятность того, что на момент разрешения цена актива будет выше.

Эти цены рассчитываются по стакану Polymarket и обновляются с каждым снимком.