API · Costruzione

Polymarket gestisce mercati crypto su/giù da 5 e 15 minuti - "Bitcoin Up or Down, 16:30-16:35 ET" - che aprono e si risolvono ogni pochi minuti, centinaia al giorno. Sono il bersaglio più popolare per i bot API perché sono frequenti, liquidi e puramente meccanici. Questa pagina è la meccanica API: come trovarli, leggerli e costruire un bot (prima in paper) - non un vantaggio magico. La maggior parte dei bot a breve termine perde per colpa di latenza e fee; lo diciamo subito.

Parliamoci chiaro. Questi mercati si risolvono su un movimento di prezzo minimo in pochi minuti. Il tuo segnale deve battere la visione già prezzata del book E coprire la taker fee E arrivare prima che il movimento sia finito. È difficile. Costruiscilo in modalità paper, misura la latenza reale del fill e dai per scontato di essere il denaro lento finché i tuoi dati non dicono il contrario.

Trova i mercati da 5 minuti live (Gamma)

Seguono uno schema di slug prevedibile - btc-updown-5m-<unix-window-start> - e compaiono nella ricerca e nel feed di Gamma. Recupera quelli attivi, dal più recente:

curl -s "https://gamma-api.polymarket.com/public-search?q=bitcoin%20up%20or%20down&limit_per_type=10"

Ogni mercato ti dà il suo conditionId e i due clobTokenIds (Up = indice 0, Down = indice 1 - leggi l'array outcomes per esserne certo). Quei token ID sono ciò che negozi.

Il loop del bot

Ogni bot crypto a breve termine ha la stessa forma - cambia solo il segnale:

  1. Leggi il sottostante - prezzo/velocità di BTC da un feed di exchange (Binance, Coinbase) o dall'RTDS di Polymarket (crypto_prices / crypto_prices_chainlink).
  2. Leggi il mercato - l'order book del CLOB per il token Up/Down; calcola il mid e il costo per prendere size.
  3. Decidi - il tuo segnale dice "Up è a buon mercato rispetto alla mia stima". Applica un gate sul tempo alla scadenza (non entrare negli ultimi secondi) e sullo spread (salta quando è illiquido).
  4. Esegui - un ordine FOK/FAK per prendere immediatamente, o un GTC a riposo per fare il maker (e guadagnare rebate).
  5. Esci - take-profit, stop-loss o semplicemente tieni fino alla risoluzione (è binario; si liquida a 1 o 0).

Stima la tua entrata prima di negoziarla

Percorri il book live per vedere quanto costa davvero la tua size (questo è paper - non piazza alcun ordine):

Perché fee e latenza dominano

  • Fee, con i numeri reali: i maker pagano 0; i taker pagano shares × feeRate × p × (1-p), e la crypto ha il tasso più alto, 0,07 (7 bps). A un prezzo 50/50 significa 0.07 × 0.5 × 0.5 = 0.0175 per azione - circa 1,75¢ a azione. Su un mercato il cui fair value si muove di uno o due centesimi in cinque minuti, una taker fee vicina ai 2¢ al midpoint può inghiottire l'intero vantaggio. La fee si riduce verso gli estremi 1¢/99¢ (il termine p(1-p)), quindi entrate tardive, quasi decise, costano meno da prendere - e i maker non solo non pagano nulla ma guadagnano un rebate (~20% delle taker fee raccolte nella crypto, pagato ogni giorno in pUSD). È questa la matematica dietro "fai il maker".
  • Latenza: nel tempo in cui il tuo ordine HTTP firma e arriva, il movimento potrebbe essere già prezzato. Misura onestamente il tuo tempo evento→fill (spesso è 0,5-1,5s su Python). Rust è più veloce; per i deposit wallet è l'unico client funzionante oggi.

Paper prima - sempre

Simula i fill contro il book live prima di rischiare un centesimo. L'MCP in sola lettura ha uno strumento paper_quote, e il capitolo sul motore di paper trading mostra un simulatore di fill realistico. Dimostra un'aspettativa positiva su carta attraverso centinaia di finestre prima di passare al live.

Prossimo: il capitolo sul bot crypto da 5 minuti (strategia) · CLOB API · WebSocket e RTDS.

Solo a scopo educativo. Il trading automatico rischia denaro reale; la maggior parte dei bot a breve termine perde. Non è consulenza finanziaria.