Mercati supportati

Scopri gli asset, i timeframe, gli schemi dei dati e le politiche di disponibilità offerti dall’API di PolyTest.

Asset e timeframe

6 asset

PolyTest monitora i mercati di previsione di Polymarket per ogni asset. Ogni asset supporta un sottoinsieme di timeframe di mercato (la durata dall’apertura alla risoluzione). Gli snapshot vengono acquisiti 8× al secondo su tutti i timeframe. Usa coin e market_type per filtrare nell’API.

Asset	Parametro API	Timeframe	Freq. snapshot
BTC Bitcoin `coin="btc"`	`coin="btc"`	5m15m1hr4hr24hr	8×/sec
ETH Ethereum `coin="eth"`	`coin="eth"`	5m15m1hr	8×/sec
SOL Solana `coin="sol"`	`coin="sol"`	5m15m1hr	8×/sec
XRP XRP In arrivo Raccolta dati in corso `coin="xrp"`	`coin="xrp"`	5m15m1hr4hr24hr	8×/sec
DOGE Dogecoin In arrivo Raccolta dati in corso `coin="doge"`	`coin="doge"`	5m15m1hr4hr24hr	8×/sec
BNB BNB In arrivo Raccolta dati in corso `coin="bnb"`	`coin="bnb"`	5m15m1hr4hr24hr	8×/sec

~Snapshot per mercato = durata × 8 (ad es. 5m ≈ 2,400, 24h ≈ 691,200).

Disponibilità dei dati

La disponibilità dei dati dipende dal tuo piano: Builder (e la prova gratuita di 3 giorni, che lo include per intero) copre una finestra recente, mentre Pro ed Enterprise hanno accesso storico illimitato. Per le query su intervalli, ogni richiesta supporta una finestra massima di 31 giorni.

Builder

14 giorni

Accesso a circa 14 giorni di dati storici di mercati e snapshot, anche durante la prova gratuita di 3 giorni.

Pro

Popolare

Illimitato

Accesso completo ai dati storici.

Enterprise

Illimitato

Accesso storico completo più politiche di disponibilità dei dati personalizzate ed esportazioni in blocco.

Finestra massima dei dati: l’intervallo da start_time a end_time è limitato a 31 giorni. I dati più vecchi vengono eliminati dopo 31 giorni.

Schema dell’oggetto Market

Ogni mercato restituito dall’API contiene i seguenti campi.

Campo	Tipo	Descrizione
`market_id`	`string`	Identificatore numerico univoco del mercato
`event_id`	`string`	ID dell’evento padre su Polymarket
`slug`	`string`	Slug URL leggibile (ad es. btc-updown-5m-1772689200)
`market_type`	`string`	Tipo di durata: 5m \| 15m \| 1h \| 4h \| 24h
`coin`	`string`	Criptovaluta: btc \| eth \| sol \| xrp \| doge \| bnb
`start_time`	`ISO 8601`	Quando il mercato è stato aperto al trading
`end_time`	`ISO 8601`	Quando il mercato si è risolto
`price_start`	`number`	Prezzo spot dell’asset all’apertura del mercato
`price_end`	`number \| null`	Prezzo spot dell’asset alla chiusura del mercato (null se non risolto)
`winner`	`string \| null`	Esito: "Up" o "Down" (null se non risolto)
`final_volume`	`number`	Volume totale di trading del mercato
`final_liquidity`	`number`	Liquidità totale alla chiusura del mercato
`condition_id`	`string`	Identificatore on-chain della condizione
`clob_token_up`	`string`	ID del token CLOB per l’esito "Up"
`clob_token_down`	`string`	ID del token CLOB per l’esito "Down"
`resolved_at`	`ISO 8601 \| null`	Timestamp della risoluzione del mercato
`created_at`	`ISO 8601`	Quando il record è stato creato in PolyTest
`updated_at`	`ISO 8601`	Timestamp dell’ultimo aggiornamento

Schema dell’oggetto Snapshot

Gli snapshot catturano lo stato di un mercato in un preciso istante, inclusi prezzi, probabilità e profondità facoltativa dell’order book.

Campo	Tipo	Descrizione
`id`	`integer`	Identificatore univoco della riga
`market_id`	`string`	ID del mercato padre (chiave esterna)
`time`	`ISO 8601`	Timestamp di questo snapshot
`spot_price`	`number \| null`	Prezzo spot dell’asset al momento dello snapshot
`price_up`	`number \| null`	Probabilità dell’esito "Up" (0.00–1.00)
`price_down`	`number \| null`	Probabilità dell’esito "Down" (0.00–1.00)
`orderbook_up`	`object \| null`	Order book completo del token "Up" (se richiesto)
`orderbook_down`	`object \| null`	Order book completo del token "Down" (se richiesto)

I campi dell’order book sono inclusi solo se passi include_orderbook=true nella richiesta. I dati dell’order book sono disponibili solo sui piani Builder, Pro ed Enterprise.

Come funzionano i mercati

Ogni mercato rappresenta una previsione binaria: il prezzo di una data criptovaluta andrà Up o Down entro il timeframe del mercato?

Ciclo di vita del mercato

1Il mercato apre: viene impostato start_time e inizia il trading
2Gli snapshot vengono acquisiti 8×/sec: i prezzi come probabilità si aggiornano in tempo reale
3Il mercato si risolve: winner viene impostato a "Up" o "Down"
4I dati vengono archiviati: gli snapshot restano interrogabili tramite API

Prezzi come probabilità

price_up e price_down rappresentano le probabilità implicite del mercato, da 0.00 a 1.00.

Un price_up = 0.65 significa che il mercato assegna una probabilità del 65% che il prezzo dell’asset sia più alto al momento della risoluzione.

Questi prezzi derivano dall’order book di Polymarket e si aggiornano a ogni snapshot.