Mercados suportados

Conheça os ativos, timeframes, esquemas de dados e políticas de disponibilidade da API da PolyTest.

Ativos e timeframes

6 ativos

A PolyTest acompanha os mercados de previsão de cada ativo na Polymarket. Cada ativo suporta um subconjunto dos timeframes de mercado (duração da abertura à resolução). Os snapshots são capturados 8× por segundo em todos os timeframes. Use coin e market_type para filtrar na API.

Ativo	Parâmetro da API	Timeframes	Freq. 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 Em breve Coletando dados `coin="xrp"`	`coin="xrp"`	5m15m1hr4hr24hr	8×/s
DOGE Dogecoin Em breve Coletando dados `coin="doge"`	`coin="doge"`	5m15m1hr4hr24hr	8×/s
BNB BNB Em breve Coletando dados `coin="bnb"`	`coin="bnb"`	5m15m1hr4hr24hr	8×/s

~Snapshots por mercado = duração × 8 (ex.: 5m ≈ 2,400, 24h ≈ 691,200).

Disponibilidade dos dados

A disponibilidade dos dados depende do seu plano: o Builder (e o teste grátis de 3 dias, que o inclui por completo) cobre uma janela recente, enquanto Pro e Enterprise têm acesso histórico ilimitado. Em consultas por intervalo, cada requisição aceita uma janela máxima de 31 dias.

Builder

14 dias

Acesso a aproximadamente 14 dias de dados históricos de mercados e snapshots — inclusive durante o teste grátis de 3 dias.

Pro

Popular

Ilimitado

Acesso completo aos dados históricos.

Enterprise

Ilimitado

Acesso histórico completo, além de políticas de disponibilidade de dados personalizadas e exportações em massa.

Janela máxima de dados: o intervalo de start_time a end_time é limitado a 31 dias. Os dados mais antigos são apagados após 31 dias.

Esquema do objeto de mercado

Todo mercado retornado pela API contém os campos a seguir.

Campo	Tipo	Descrição
`market_id`	`string`	Identificador numérico único do mercado
`event_id`	`string`	ID do evento pai na Polymarket
`slug`	`string`	Slug de URL legível (ex.: btc-updown-5m-1772689200)
`market_type`	`string`	Tipo de duração: 5m \| 15m \| 1h \| 4h \| 24h
`coin`	`string`	Criptomoeda: btc \| eth \| sol \| xrp \| doge \| bnb
`start_time`	`ISO 8601`	Quando o mercado abriu para negociação
`end_time`	`ISO 8601`	Quando o mercado foi resolvido
`price_start`	`number`	Preço spot do ativo na abertura do mercado
`price_end`	`number \| null`	Preço spot do ativo no fechamento do mercado (null se não resolvido)
`winner`	`string \| null`	Resultado: "Up" ou "Down" (null se não resolvido)
`final_volume`	`number`	Volume total negociado no mercado
`final_liquidity`	`number`	Liquidez total no fechamento do mercado
`condition_id`	`string`	Identificador on-chain da condição
`clob_token_up`	`string`	ID do token CLOB do resultado "Up"
`clob_token_down`	`string`	ID do token CLOB do resultado "Down"
`resolved_at`	`ISO 8601 \| null`	Timestamp da resolução do mercado
`created_at`	`ISO 8601`	Quando o registro foi criado na PolyTest
`updated_at`	`ISO 8601`	Timestamp da última atualização

Esquema do objeto de snapshot

Os snapshots capturam o estado de um mercado em um instante, incluindo preços, probabilidades e, opcionalmente, a profundidade do livro de ofertas.

Campo	Tipo	Descrição
`id`	`integer`	Identificador único da linha
`market_id`	`string`	ID do mercado pai (chave estrangeira)
`time`	`ISO 8601`	Timestamp deste snapshot
`spot_price`	`number \| null`	Preço spot do ativo no momento do snapshot
`price_up`	`number \| null`	Probabilidade do resultado "Up" (0.00–1.00)
`price_down`	`number \| null`	Probabilidade do resultado "Down" (0.00–1.00)
`orderbook_up`	`object \| null`	Livro de ofertas completo do token "Up" (quando solicitado)
`orderbook_down`	`object \| null`	Livro de ofertas completo do token "Down" (quando solicitado)

Os campos do livro de ofertas só são incluídos quando você passa include_orderbook=true na requisição. Os dados do livro de ofertas estão disponíveis apenas nos planos Builder, Pro e Enterprise.

Como os mercados funcionam

Cada mercado representa uma previsão binária: o preço de uma determinada criptomoeda vai para Up (subir) ou Down (cair) dentro do timeframe do mercado?

Ciclo de vida do mercado

1O mercado abre — start_time é definido e a negociação começa
2Os snapshots são capturados 8×/s — os preços de probabilidade são atualizados em tempo real
3O mercado é resolvido — winner é definido como "Up" ou "Down"
4Os dados são arquivados — os snapshots continuam consultáveis pela API

Preços de probabilidade

price_up e price_down representam probabilidades implícitas no mercado, de 0.00 a 1.00.

Um price_up = 0.65 significa que o mercado atribui 65% de probabilidade de o preço do ativo estar mais alto no momento da resolução.

Esses preços são derivados do livro de ofertas da Polymarket e são atualizados a cada snapshot.