Fill parziali e leg risk su Polymarket

Il rischio da fill parziale si verifica quando una gamba di un arbitraggio intra-market si esegue e la gamba complementare no. Questa guida spiega la meccanica sul CLOB di Polymarket, gli scenari comuni che vedrai come arbitraggista, i rischi concreti (risoluzione, slippage, commissioni, tempi di regolamento) e le mitigazioni passo‑passo che puoi applicare nel trading live.

Punti chiave

• Il rischio da fill parziale deriva da esecuzioni asincrone su un CLOB ed è funzione del tipo d'ordine, della liquidità e della tick size.
• Usa tipi d'ordine e sizing (inclusi gli ordini di mercato FAK) per minimizzare l'esposizione unilaterale; prevedi slippage e commissioni taker sulle esecuzioni.
• Se una sola gamba si esegue, considera la posizione come un'esposizione direzionale a vita breve: valuta il rischio di risoluzione, le commissioni, la liquidità disponibile per compensare e se effettuare split/merge dei token outcome.
• Predefinisci un workflow di recovery (hedge, squeeze o unwind) e integra controlli di dry‑run nel tuo bot.

Perché è importante

Le opportunità di arbitraggio su Polymarket sono spesso a tempo limitato e di piccola entità. Quando invii ordini per outcome complementari — es. YES e NO in un mercato binario, o un set completo in un mercato multi‑outcome — assumi che entrambi i fill avvengano quasi simultaneamente. Un'esecuzione parziale trasforma un trade bilanciato e definito dall'edge in un'esposizione aperta. Conoscere la meccanica e avere un piano di risposta fisso preserva l'edge e limita perdite inattese.

Come avvengono i fill parziali su Polymarket

• Tipi d'ordine e matching: il CLOB di Polymarket accetta ordini limit e di mercato. La piattaforma espone un helper che emette per default ordini di mercato FAK per esecuzione immediata. FAK esegue immediatamente sulla liquidità disponibile e cancella qualsiasi restante, quindi un FAK grande può fillare parzialmente se la profondità del book è bassa.
• Tick size & estremi: la tick size è solitamente $0.01 e si restringe a $0.001 quando i prezzi si avvicinano agli estremi. I cambi di passo della tick size possono causare effetti di quantizzazione che rendono anche piccole quantità rimanenti non eseguibili al prezzo richiesto.
• Latenza e matching: il matching è sincrono nel CLOB, ma latenze di rete e del relayer, flussi concorrenti di taker e aggiornamenti del book possono portare a un ordine che si esegue mentre il lato opposto viene cancellato o sopravanzato.

Scenari comuni di fill parziale

1. Arbitraggio binario a due gambe: posti ordini di acquisto per YES e NO aspettando che la somma dei best ask sia < $1.00. YES si riempie completamente; NO si riempie solo parzialmente o manca perché il best ask è cambiato. Ora hai esposizione su YES.
2. Set multi‑outcome: compri N‑1 outcome e non riesci a riempire l'ultima gamba. Sei long su un sottoinsieme di token outcome in un mercato dove un set completo sarebbe stato neutrale.
3. Ordine di mercato fuori profondità: usi un FAK per ottenere immediatezza; la profondità disponibile riempie solo la gamba più economica, lasciando il resto cancellato.

Rischi concreti da elencare (elencali sempre)

• Rischio di risoluzione: dispute UMA o risoluzioni ritardate possono estendere la vita della tua esposizione unilaterale.
• Slippage & esecuzione parziale: la gamba non riempita potrebbe non essere eseguibile a prezzi ragionevoli; inseguirla aumenta il costo e può eliminare l'edge.
• Commissioni: sulle esecuzioni si applicano commissioni taker (le commissioni maker sono zero). Variazioni delle commissioni o fee per categoria influenzano il profitto realizzato.
• Smart‑contract e tempi di regolamento: i tempi per split/merge/redeem del CTF e le operazioni on‑chain (anche se il gas è sponsorizzato dal Relayer) possono influenzare quando puoi neutralizzare le posizioni.
• Flusso dei controparti: altri trader potrebbero rilevare le tue posizioni unilaterali e muovere i prezzi contro di te mentre tenti di coprirti.

Checklist di triage immediato (cosa fare nei primi 30–120 secondi)

1. Conferma i fill tramite la Data API o gli endpoint di lettura del CLOB. Non dare per scontato che entrambi gli ordini si siano eseguiti.
2. Calcola il P&L peggiore incluso il costo delle commissioni taker e lo slippage potenziale richiesto per completare la complementare.
3. Interroga la liquidità disponibile a prezzi migliori/peggiori per determinare se puoi comprare la gamba mancante entro slippage accettabile.
4. Se la liquidità è insufficiente, decidi se coprirti con mercati correlati (raro su Polymarket) o ridurre l'esposizione vendendo parte della gamba completata.

Mitigazioni e workflow

• Preferisci FAK per immediatezza quando accetti fill parziali, e dimensiona gli ordini per adattarli alla profondità tipica. Vedi /glossary/fak per la definizione.
• Dimensiona gli ordini in modo conservativo rispetto alla profondità visibile su entrambi i lati del book. Se bestAsk(YES) + bestAsk(NO) < $1.00 solo di poco, riduci la size delle gambe alla profondità disponibile a quei livelli di prezzo.
• Staggia l'invio degli ordini: invia prima la gamba con liquidità più scarsa, poi l'altra. Questo riduce la probabilità di esecuzione unilaterale in molte forme pratiche del book.
• Usa workflow di split/merge: su fill parziali multi‑outcome, considera di unire (merge) gli outcome che detieni in un set più piccolo dove possibile, o trasferire token a una controparte sicura se pianifichi un'operazione di salvage coperta. Ricorda la meccanica CTF: split conia set completi da pUSD e merge restituisce pUSD bruciando token complementari.
• Preprogrammare una recovery automatica: oppure inseguire aggressivamente la gamba mancante fino a un tetto di prezzo, oppure liquidare immediatamente la gamba riempita per accettare una perdita parziale. Avere limiti fissi e non scalare senza approvazione umana per esposizioni grandi.

Esempio pratico: tentativo binario a due gambe

• Vedi bestAsk(YES) = 0.48, bestAsk(NO) = 0.49. Somma = 0.97, edge = 0.03.
• Profondità book: YES ha 100 azioni a 0.48, NO ha 20 azioni a 0.49.
• Incarichi acquisto FAK da 50 azioni su entrambe le gambe. YES si riempie completamente (50), NO si riempie solo per 20 e il resto viene cancellato.
• Opzioni post‑fill: comprare NO aggiuntivo fino al tuo cap (accettando slippage), vendere 50 YES nel book per neutralizzare (realizzando spread & commissioni), o tenere YES e aspettare — ogni scelta ha compromessi già elencati.

Commissioni e contabilità

• I maker pagano zero; le commissioni taker variano per categoria fino a ~1.8% per fill taker. Includi le commissioni taker attese quando calcoli i break‑even per le operazioni di recovery.
• Registra le commissioni e i timestamp per ogni fill. Il tempo di regolamento è importante: i token outcome riscattabili pagano $1.00 ciascuno dopo la risoluzione UMA e l'eventuale finestra di disputa.

Come questo influenza il tuo trading

Progetta ogni esecuzione di arbitraggio con un piano incorporato per i fill parziali. Dimensiona i trade sulla profondità visibile, preferisci FAK solo quando accetti fill parziali, e implementa un triage post‑fill automatizzato che interroga i fill, ricalcola l'esposizione netta incluse le commissioni e esegue una delle tre vie: completare la complementare entro un tetto di prezzo, liquidare la gamba riempita, o mantenere fino alla risoluzione solo quando il valore atteso giustifica i rischi. Così trasformi imprevisti in risposte routinarie e codificate e preservi il tuo edge.

Ulteriori letture

• Contesto di sistema completo: /guides/polymarket-arbitrage-complete-guide
• Tattiche specifiche binarie: /guides/intra-market-binary-arbitrage-explained
• Workflow multi‑outcome: /guides/combinatorial-arbitrage-on-polymarket
• Meccanica del CLOB: /guides/polymarket-clob-explained

Il rischio da fill parziale è una realtà d'esecuzione su qualsiasi exchange. Su Polymarket, la combinazione di tick size, profondità del book e comportamento degli FAK lo rende prevedibile — il che significa che puoi costruire risposte robuste e ripetibili nel tuo bot e nei processi di gestione del rischio.

Domande frequenti

Qual è la risposta più semplice quando una gamba si esegue e l'altra no?

La risposta immediata più semplice è ricalcolare l'esposizione netta includendo le commissioni taker, controllare la liquidità disponibile per la gamba mancante e o completare la gamba mancante entro un tetto di prezzo predefinito o liquidare la gamba riempita rivendendola. La scelta dovrebbe essere governata da limiti di rischio predefiniti e dallo slippage massimo accettabile.

Gli ordini FAK eliminano i fill parziali?

No. FAK (Fill‑And‑Kill) aumenta l'immediatezza ma può comunque fillare parzialmente se la profondità disponibile è limitata. FAK riempie fino alla liquidità esistente e cancella qualsiasi residuo, quindi puoi comunque rimanere esposto da un solo lato.

Come devo dimensionare gli ordini per ridurre i problemi di leg risk nell'arbitraggio?

Dimensiona ogni gamba rispetto alla profondità visibile ai livelli di prezzo che intendi colpire. Usa incrementi più piccoli rispetto alla maggiore profondità disponibile, o invia le gambe in sequenza in modo che la gamba più scarsa venga postata prima. Includi sempre un margine per il comportamento maker/taker e per la quantizzazione dovuta alla tick size.

Posso fare affidamento su split/merge dei token outcome per risolvere i fill parziali?

Split/merge sono operazioni CTF che permettono di convertire pUSD in set completi e viceversa. Non completano magicamente una gamba di mercato non riempita — aiutano a gestire esposizioni multi‑outcome una volta che detieni token. Usali come parte di un piano di recovery, ma non come sostituto dell'hedge della gamba mancante.

Quali sono i principali rischi che devo elencare quando documento gli esiti di trade?

Elenca sempre le dispute e i tempi di risoluzione UMA, il rischio di slippage e di esecuzione parziale, le commissioni taker applicabili e i tempi di smart‑contract/settlement. Questi fattori influenzano materialmente il risultato realizzato di qualsiasi situazione di fill parziale.