Mercados compatibles

Conoce los activos, intervalos, esquemas de datos y políticas de disponibilidad que ofrece la API de PolyTest.

Activos e intervalos

6 activos

PolyTest registra los mercados de predicción de cada activo en Polymarket. Cada activo admite un subconjunto de intervalos de mercado (la duración desde la apertura hasta la resolución). Los snapshots se capturan 8× por segundo en todos los intervalos. Usa coin y market_type para filtrar en la API.

Activo	Parámetro de API	Intervalos	Frec. de snapshots
BTC Bitcoin `coin="btc"`	`coin="btc"`	5m15m1hr4hr24hr	8×/s
ETH Ethereum `coin="eth"`	`coin="eth"`	5m15m1hr	8×/s
SOL Solana `coin="sol"`	`coin="sol"`	5m15m1hr	8×/s
XRP XRP Muy pronto Recopilando datos `coin="xrp"`	`coin="xrp"`	5m15m1hr4hr24hr	8×/s
DOGE Dogecoin Muy pronto Recopilando datos `coin="doge"`	`coin="doge"`	5m15m1hr4hr24hr	8×/s
BNB BNB Muy pronto Recopilando datos `coin="bnb"`	`coin="bnb"`	5m15m1hr4hr24hr	8×/s

~Snapshots por mercado = duración × 8 (p. ej., 5m ≈ 2,400, 24h ≈ 691,200).

Disponibilidad de datos

La disponibilidad de datos depende de tu plan: Builder (y la prueba gratuita de 3 días, que lo incluye completo) cubre una ventana reciente, mientras que Pro y Enterprise tienen acceso histórico ilimitado. En las consultas por rango, cada solicitud admite una ventana máxima de 31 días.

Builder

14 días

Acceso a aproximadamente 14 días de datos históricos de mercados y snapshots, también durante la prueba gratuita de 3 días.

Pro

Popular

Ilimitado

Acceso completo a los datos históricos.

Enterprise

Ilimitado

Acceso histórico completo, más políticas de disponibilidad de datos personalizadas y exportaciones masivas.

Ventana máxima de datos: el intervalo de start_time a end_time está limitado a 31 días. Los datos más antiguos se eliminan pasados 31 días.

Esquema del objeto Market

Cada mercado que devuelve la API contiene los siguientes campos.

Campo	Tipo	Descripción
`market_id`	`string`	Identificador numérico único del mercado
`event_id`	`string`	ID del evento padre en Polymarket
`slug`	`string`	Slug de URL legible (p. ej., btc-updown-5m-1772689200)
`market_type`	`string`	Tipo de duración: 5m \| 15m \| 1h \| 4h \| 24h
`coin`	`string`	Criptomoneda: btc \| eth \| sol \| xrp \| doge \| bnb
`start_time`	`ISO 8601`	Cuándo se abrió el mercado a la negociación
`end_time`	`ISO 8601`	Cuándo se resolvió el mercado
`price_start`	`number`	Precio spot del activo en la apertura del mercado
`price_end`	`number \| null`	Precio spot del activo en el cierre del mercado (null si no se ha resuelto)
`winner`	`string \| null`	Resultado: "Up" o "Down" (null si no se ha resuelto)
`final_volume`	`number`	Volumen total negociado en el mercado
`final_liquidity`	`number`	Liquidez total en el cierre del mercado
`condition_id`	`string`	Identificador on-chain de la condición
`clob_token_up`	`string`	ID del token CLOB del resultado "Up"
`clob_token_down`	`string`	ID del token CLOB del resultado "Down"
`resolved_at`	`ISO 8601 \| null`	Marca de tiempo de la resolución del mercado
`created_at`	`ISO 8601`	Cuándo se creó el registro en PolyTest
`updated_at`	`ISO 8601`	Marca de tiempo de la última actualización

Esquema del objeto Snapshot

Los snapshots capturan el estado de un mercado en un instante, incluidos precios, probabilidades y la profundidad opcional del libro de órdenes.

Campo	Tipo	Descripción
`id`	`integer`	Identificador único de la fila
`market_id`	`string`	ID del mercado padre (clave foránea)
`time`	`ISO 8601`	Marca de tiempo de este snapshot
`spot_price`	`number \| null`	Precio spot del activo en el momento del snapshot
`price_up`	`number \| null`	Probabilidad del resultado "Up" (0.00–1.00)
`price_down`	`number \| null`	Probabilidad del resultado "Down" (0.00–1.00)
`orderbook_up`	`object \| null`	Libro de órdenes completo del token "Up" (si se solicita)
`orderbook_down`	`object \| null`	Libro de órdenes completo del token "Down" (si se solicita)

Los campos del libro de órdenes solo se incluyen cuando pasas include_orderbook=true en tu solicitud. Los datos del libro de órdenes solo están disponibles en los planes Builder, Pro y Enterprise.

Cómo funcionan los mercados

Cada mercado representa una predicción binaria: ¿el precio de una criptomoneda dada subirá (Up) o bajará (Down) dentro del intervalo del mercado?

Ciclo de vida de un mercado

1El mercado abre: se fija start_time y empieza la negociación
2Se capturan snapshots 8×/s: los precios como probabilidades se actualizan en tiempo real
3El mercado se resuelve: winner se fija en "Up" o "Down"
4Los datos se archivan: los snapshots siguen pudiendo consultarse con la API

Precios como probabilidades

price_up y price_down representan las probabilidades implícitas del mercado, de 0.00 a 1.00.

Un price_up = 0.65 significa que el mercado asigna un 65% de probabilidad a que el precio del activo sea más alto en el momento de la resolución.

Estos precios se derivan del libro de órdenes de Polymarket y se actualizan con cada snapshot.