Ricerca mercati Up/Down di Polymarket

Incolla uno slug come btc-updown-5m-1780949100 e ottieni la finestra, i prezzi di riferimento, l’esito e il volume di quel mercato, anche per i mercati i cui order book Polymarket non fornisce più.

Prova:

Come leggere lo slug

Ogni mercato crypto Up/Down di Polymarket ha uno slug con una forma fissa e prevedibile. Una volta che sai leggerlo, puoi costruirne uno per qualsiasi finestra invece di cercarlo.

btc-updown-5m-1780949100
│   │      │   └── Unix timestamp: when the window OPENS, in UTC
│   │      └────── Timeframe: 5m | 15m | 1h | 4h | 24h
│   └───────────── Always "updown"
└───────────────── Coin: btc | eth | sol

La trappola: il campo startDate dell’API indica quando l’oggetto del mercato è stato creato, non quando apre il trading, spesso un giorno o più prima. Il timestamp nello slug è il vero inizio della finestra, e endDate è quel valore più il timeframe.

Cosa conserva Polymarket

Quando un mercato si risolve, Polymarket conserva il record del mercato e una serie di prezzi ridotta, e scarta l’order book. Se chiedi il book di un mercato chiuso ricevi 404. Lo storico dei prezzi torna con circa un punto al minuto, e solo se passi un inizio e una fine espliciti:

curl -s "https://clob.polymarket.com/book?token_id=$TOK"
# {"error":"No orderbook exists for the requested token id"}   404

curl -s "https://clob.polymarket.com/prices-history?market=$TOK&startTs=$START&endTs=$END&fidelity=1"
# about 6 points for a 5-minute market

curl -s "https://clob.polymarket.com/prices-history?market=$TOK&interval=max"
# {"history":[]} for older markets

La ricerca qui sopra funziona perché questi mercati sono stati registrati mentre erano attivi. Trovi di più sul funzionamento in I mercati Up/Down spiegati, e le statistiche aggregate di risoluzione sono nelle pagine dei dati di mercato.

Domande frequenti

Come cerco un mercato btc-updown-5m di Polymarket?
Incolla lo slug, ad esempio btc-updown-5m-1780949100, nella ricerca qui sopra. Ottieni la finestra di trading, il prezzo di riferimento all’apertura e alla chiusura, il lato su cui si è risolto e il volume finale. Funziona anche un URL completo di un evento Polymarket: lo slug viene estratto automaticamente. Se ometti il timestamp finale, ottieni il mercato più recente di quella serie.
Cosa significa il numero alla fine di uno slug Up/Down di Polymarket?
È il timestamp Unix del momento in cui si apre la finestra di trading, in UTC. In btc-updown-5m-1780949100 il mercato apre a quel timestamp e chiude 5 minuti dopo. Nota che non coincide con il campo startDate dell’API, che registra quando è stato creato l’oggetto del mercato e può essere di un giorno o più precedente.
Perché non trovo un mercato di Polymarket più vecchio?
Per due motivi. Polymarket restituisce 404 per l’order book di un mercato risolto e conserva solo circa un punto al minuto di storico dei prezzi. PolyTest mantiene un archivio mobile di 31 giorni, quindi anche un mercato risolto più di 31 giorni fa non è qui. A quel punto l’order book non esiste più da nessuna parte, per quanto ne sappiamo.
Posso ottenere l’order book di uno specifico mercato di Polymarket?
Sì, tramite l’API di PolyTest, per qualsiasi mercato all’interno della finestra di 31 giorni. Ogni mercato ha snapshot point-in-time con 8 livelli di profondità su entrambi i lati e risoluzione sotto il secondo, ed è quello che ti serve per simulare esecuzioni realistiche. L’API di Polymarket non può fornirlo per un mercato risolto.