Polymarket UMA oracle: come funzionano risoluzione e dispute

L'oracolo UMA di Polymarket determina quando i token di outcome diventano riscattabili e i mercati si risolvono. L'oracolo UMA usato da Polymarket è un sistema di reporting “ottimistico”: viene pubblicato un report iniziale che può essere contestato. Le dispute sospendono il settlement finché UMA non finalizza il risultato, e questo influisce su quando puoi riscattare le azioni vincenti o chiudere posizioni.

Punti chiave

• Polymarket usa un oracolo UMA ottimistico: un report iniziale può essere contestato e le dispute sospendono il settlement.
• La risoluzione rende i token CTF riscattabili per $1.00 ciascuno; prima della finalità, i token non sono riscattabili.
• Le dispute introducono rischio di risoluzione e incertezza temporale — non considerare un mercato non finalizzato come definitivamente settled.
• Per il trading, aspettati che ordini e trasferimenti siano soggetti allo stato di settlement; controlla i flag nel metadata del mercato e nelle Gamma/Data APIs.
• Le strategie di arbitraggio e endgame devono tener conto delle finestre di disputa, dello slippage, delle fee e dei meccanismi di disputa UMA.

Come l'oracolo UMA ottimistico si integra in Polymarket

Polymarket delega il reporting finale a un oracolo UMA ottimistico. UMA fornisce un report iniziale rapido e un meccanismo formale di disputa. Quando un evento si risolve nel mondo reale, l'oracolo pubblica un esito preliminare; quell'esito è considerato valido a meno che qualcuno non lo contesti con successo attraverso il processo UMA.

Su Polymarket questo è importante perché i token di outcome emessi dal Gnosis Conditional Token Framework (CTF) sono riscattabili per $1.00 solo dopo la decisione finale dell'oracolo. Fino a quando UMA non finalizza, il mercato rimane in uno stato di limbo per quanto riguarda il settlement.

La timeline di risoluzione (semplificata)

1. Trigger nel mondo reale: l'evento si verifica o arriva il tempo di risoluzione schedulato.
2. Report iniziale: l'oracolo UMA pubblica un outcome preliminare sulla chain.
3. Finestra di disputa: le parti possono presentare dispute su UMA. Mentre una disputa è attiva, il settlement è sospeso.
4. Finalizzazione: UMA chiude le dispute ed emette un outcome finale.
5. Riscatto/settlement: dopo la finalizzazione, i vincitori CTF possono chiamare redeem e ricevere $1.00 per ogni token vincente; i token perdenti non hanno valore.

Ogni passo è on-chain e può essere visibile nelle Gamma e Data APIs di Polymarket. Se ti affidi a controlli programmatici, usa i campi di Gamma /markets e la Data API per posizioni e stato di settlement.

Cosa comporta una disputa

Una disputa contesta il report iniziale. Le dispute tipicamente implicano staking o la presentazione di prove off-chain e on-chain attraverso i meccanismi di disputa di UMA. Mentre il processo di disputa è in corso:

• Il settlement è sospeso: le operazioni di redeem che pagherebbero i vincitori sono ritardate.
• I trasferimenti e alcune operazioni CTF possono essere limitati fino alla finalizzazione del mercato.
• I trader non possono fare affidamento su un cash-out immediato delle posizioni risolte finché UMA non finalizza l'esito.

Le dispute possono essere brevi o lunghe a seconda delle regole di governance di UMA e della complessità della questione fattuale. Polymarket non controlla la cadenza delle dispute di UMA; segue la decisione finale di UMA.

Come questo influenza trading e arbitraggio

Se fai trading vicino alla risoluzione (per esempio con strategie endgame o arbitraggio), il meccanismo di disputa crea tre effetti pratici:

• Incertezza temporale: un vincitore riportato non è riscattabile fino a che UMA non finalizza. Questo può estendere il tempo tra il report e il pagamento effettivo.
• Rischio di risoluzione: un report iniziale può essere ribaltato. Un outcome che hai comprato come "vincente" potrebbe poi essere modificato da una disputa riuscita.
• Costo opportunità e blocco del capitale: i token bloccati durante le dispute non possono essere riutilizzati fino al completamento del settlement.

Quando valuti un apparente arbitraggio (per esempio intra-market binary o arbitraggio combinatorio), aggiungi questi ai rischi usuali: slippage, fill parziali, taker fees (variabili per categoria) e rischio smart-contract. Non dare per scontato che un edge di arbitraggio sia effettivamente certo durante una disputa attiva.

Cosa osservare nell'UI e nelle API

• Flag di stato del mercato: il Gamma /markets include i flag closed e archived e il metadata. Usali per rilevare mercati che sono stati riportati ma non finalizzati.
• Posizioni e riscattabilità: la Data API espone posizioni, open interest e dati sui detentori; verifica se le operazioni di redeem vanno a buon fine o vengono rifiutate mentre una disputa è attiva.
• Messaggi correlati a UMA: Polymarket può mostrare una nota nell'interfaccia di mercato quando sono in corso dispute UMA. Leggi sempre il testo di risoluzione del mercato e eventuali note sulla disputa.
• Eventi WebSocket: la settlement del mercato o i cambi di tick non annulleranno una disputa; affidati a Gamma/Data per gli indicatori di finalità.

Best practice per diversi utenti

Traders: evita di dare per scontato un cash-out immediato su outcome riportati. Se ti serve liquidità, pianifica la finestra di disputa e incorporala nel dimensionamento della posizione. Per le giocate endgame, dichiara esplicitamente la maggiore incertezza di settlement e il possibile ribaltamento.

Arbitraggisti: quando compri un set completo per catturare un edge intra-market, ricorda che il profitto si cristallizza solo una volta che i token vincenti sono riscattabili. Se una disputa si estende, il tuo capitale è bloccato e il margine realizzato può cambiare se fee o slippage erodono lo spread.

Sviluppatori e bot: programma controlli contro Gamma /markets e gli endpoint della Data API per i flag di settlement. Il CLOB e i flussi d'ordine continuano a operare, ma le azioni dipendenti dalla finalità (redeem, withdraw dei fondi settled) devono aspettare la finalizzazione UMA.

Domande tipiche su tempi ed esiti

• Quanto tempo impiegherà una disputa? UMA controlla i tempi delle dispute; varia. Polymarket segue l'esito finale di UMA.
• Un report iniziale può essere ribaltato? Sì — dispute riuscite possono cambiare l'esito riportato e quindi il settlement.
• Le dispute influenzano i saldi on-chain? Solo dopo la finalizzazione le operazioni di redeem convertono i token CTF vincenti in pUSD; fino ad allora i saldi riflettono la detenzione di token, non cash riscattato.

Come questo influisce sul tuo trading (checklist pratica)

• Prima della risoluzione: annota ordini aperti, cancellali se vuoi evitare di detenere token durante una disputa.
• Al report iniziale: aspettati ritardi per il redeem; non dare per scontato che un vincitore riportato sia già settled per il pagamento.
• Durante una disputa: evita leva elevata o concentrazione di capitale nel mercato; il capitale può essere bloccato.
• Dopo la finalizzazione: chiama redeem sui token CTF vincenti per ricevere $1.00 per token (si applicano le semantiche di CTF redeem).

Ricorda di considerare le taker fees (variabili per categoria), la possibilità di dispute UMA, lo slippage dai fill e il rischio smart-contract quando stimi i rendimenti realizzati.

Riepilogo conclusivo

L'oracolo UMA di Polymarket fornisce report iniziali rapidi con una strada di disputa on-chain. Questo design bilancia velocità e correttezza, ma introduce rischio di risoluzione e incertezza temporale che devi considerare quando fai trading, arbitraggio o costruisci tool. Monitora Gamma e la Data API per i flag di settlement e tratta un esito inizialmente riportato come provvisorio fino alla finalizzazione di UMA.

Per approfondimenti operativi sui meccanismi di trading e sui tipi di ordine, vedi le guide correlate: /guides/polymarket-arbitrage-complete-guide e /guides/polymarket-clob-explained.

Domande frequenti

Cos'è l'oracolo UMA ottimistico usato da Polymarket?

L'oracolo UMA pubblica un report iniziale dell'esito e permette contestazioni. Polymarket segue la decisione finale di UMA; un report iniziale è provvisorio finché la finestra di disputa di UMA non si chiude e non viene emesso un outcome finale.

Un mercato risolto può essere ribaltato dopo un report iniziale?

Sì. Se una disputa ha successo secondo i meccanismi di disputa di UMA, l'esito riportato può cambiare. Quel cambiamento determina quali token CTF saranno riscattabili quando il settlement si completa.

Una disputa mi impedirà di fare trading su Polymarket?

No — il trading continua sul CLOB di Polymarket. Tuttavia, le operazioni di redeem che convertono i token vincenti in pUSD sono messe in pausa fino alla finalizzazione di UMA, e dovresti aspettarti incertezza temporale sul settlement.

In che modo le dispute influenzano le strategie di arbitraggio?

Le dispute introducono rischio di tempo e di esito: il capitale può restare bloccato fino alla finalizzazione, un vincitore iniziale può essere ribaltato, e i margini realizzati possono ridursi a causa di fee o slippage. Inserisci questi fattori nel dimensionamento della posizione e nei piani di esecuzione.

Dove posso controllare programmativamente lo stato di disputa o di finalità di un mercato?

Usa la Gamma API (https://gamma-api.polymarket.com) per metadata e flag di stato del mercato, e la Data API (https://data-api.polymarket.com) per posizioni e riscattabilità. Questi endpoint indicano se il settlement è stato completato.