Collegare i tuoi account: Polymarket e Kalshi, dall'inizio alla fine
Predite funziona perfettamente come strumento di ricerca anche senza collegare nulla: puoi analizzare i mercati, leggere le stime di probabilità dell'AI e studiare l'EV per tutto il giorno. Ma la piattaforma diventa enormemente più utile nel momento in cui sa cosa detieni davvero. Collega i tuoi account e le tue posizioni reali confluiscono nella pagina Portfolio, il tuo P&L diventa in tempo reale anziché ipotetico, e l'EV Scanner inizia a incrociare ogni segnale con i mercati a cui sei già esposto. Questa guida ti accompagna nel collegamento di Polymarket e Kalshi da zero, spiega i due livelli di accesso molto diversi che puoi concedere e illustra esattamente come vengono memorizzati i tuoi dati segreti. È scritta per chi non ha mai incollato una private key da nessuna parte prima d'ora, quindi procederemo lentamente e spiegheremo il *perché* dietro ogni passaggio.
Due tipi di collegamento: sola lettura vs. trading
Il concetto più importante in assoluto qui è che esistono due livelli di accesso completamente diversi, e dovresti comprenderli entrambi prima di fare qualsiasi cosa.
Un collegamento in sola lettura consente a Predite di *vedere* le tue posizioni senza mai toccarle. Per Polymarket questo significa che ci fornisci nient'altro che l'indirizzo pubblico del tuo wallet: la stessa stringa 0x… di 42 caratteri visibile a chiunque su un block explorer. Con quel solo indirizzo, Predite legge le tue posizioni aperte, i tuoi prezzi medi di ingresso e il tuo valore corrente mark-to-market direttamente dalla chain. Nessuna private key, nessuna firma, nessuna possibilità di muovere fondi. Questo è il punto di partenza giusto per quasi tutti.
Un collegamento per il trading è tutt'altra storia. Per permettere a Predite di *piazzare ordini* per tuo conto — ciò che alimenta i bot automatizzati e l'interfaccia di Live Trading a un clic — abbiamo bisogno di credenziali in grado di firmare effettivamente le transazioni. Su Polymarket questo significa la tua private key. Si tratta di una concessione di potere seria: chiunque possieda una private key controlla i fondi in quel wallet, punto e basta. Spiegheremo esattamente come farlo in sicurezza, ma la regola di fondo è semplice: non collegare mai il tuo wallet principale per il trading. Usa un wallet dedicato al trading, finanziato solo con ciò che puoi permetterti di perdere.
Un modello mentale utile: un collegamento in sola lettura è come dare a qualcuno l'estratto conto della tua banca. Un collegamento per il trading è come dargli la carta di debito e il PIN. La maggior parte delle persone ha bisogno soltanto dell'estratto conto.
Limitazioni in base al piano, in breve
- •Il monitoraggio del portafoglio in sola lettura funziona su ogni piano, incluso Starter ($29/mese).
- •Il Live trading su Polymarket (il collegamento con private key, i bot che eseguono ordini reali, l'interfaccia di Live Trading) richiede il piano Bot ($99/mese) con un abbonamento attivo. Se provi a collegarti per il live trading su Starter o Pro, l'API restituirà un chiaro messaggio "Bot plan required".
- •Pro ($59/mese) si colloca a metà strada: scanner completo, alert e portafoglio unificato, ma nessun bot. Il Bot Builder appartiene al piano Bot da cima a fondo, paper incluso.
Parte 1: collegare Polymarket (sola lettura)
Questa è la versione da cinque minuti che copre il 90% degli utenti. Stai semplicemente fornendo un indirizzo pubblico.
- Apri Polymarket e individua l'indirizzo del tuo wallet. Clicca sul tuo avatar (in alto a destra) → l'indirizzo è mostrato in cima al menu e inizia con
0x. Clicca per copiarlo. Sarà esattamente di 42 caratteri. - In Predite, vai su Settings → Portfolio → Add Wallet (oppure incollalo nel prompt di onboarding dell'Unified Portfolio la prima volta che apri la pagina Portfolio).
- Incolla l'indirizzo. Predite ne valida il formato (deve essere un indirizzo EVM valido — 42 caratteri esadecimali) e rifiuta qualsiasi stringa malformata prima di salvarla.
- Tutto qui. Nel giro di pochi secondi le tue posizioni compaiono.
Trattandosi di dati pubblici, non c'è alcun rischio e non c'è nulla da cifrare. Puoi aggiungere più indirizzi — comodo se tieni wallet separati per i mercati politici e per quelli crypto — e persino monitorare wallet che non sono tuoi (alcuni trader tengono d'occhio così i wallet di operatori esperti noti).
Parte 2: collegare Polymarket per il trading
Se sei sul piano Bot e vuoi che i bot eseguano davvero, dovrai fornire una private key. Prima di toccare il modulo, preparati nel modo corretto.
Passaggio 0: crea un wallet dedicato al trading
Non saltare questo passaggio. Il wallet che colleghi per il trading dovrebbe essere un wallet nuovo che contiene soltanto il tuo bankroll di trading. Ecco il ragionamento in termini concreti: se hai $8.000 nel tuo wallet principale e un bug, un sito di phishing o un backup trapelato espone quella key, tutti gli $8.000 spariscono — su una blockchain non esiste alcuno storno. Se invece finanzi un wallet dedicato con $100, la tua perdita nel caso peggiore è $100. Questa asimmetria è enorme, e configurarlo non ti costa nulla.
Un approccio pulito:
- Crea un wallet completamente nuovo in MetaMask (o Rabby, o un hardware wallet): un nuovo account, una nuova seed phrase, mai usata per nient'altro.
- Trasferisci o invia solo il bankroll di trading che intendi usare in USDC su Polygon. Per le tue prime settimane, $20–$100 sono più che sufficienti.
- Usa la private key di *questo* wallet per il collegamento. Considera la sua seed phrase come sacrificabile nel senso che hai limitato il rischio al ribasso, ma conservala comunque in modo sicuro.
Passaggio 1: comprendere i tre signature type
Questa è la parte che mette in difficoltà i principianti, quindi siamo precisi. Polymarket supporta tre architetture di account, e Predite deve sapere quale hai. Il modulo di collegamento le etichetta e l'API verifica che tu abbia scelto una combinazione coerente.
- •Type 0 — EOA (Externally Owned Account). È un wallet Ethereum standard: MetaMask, Rabby, Coinbase Wallet o un hardware wallet. Scegli questo se hai importato il tuo wallet in Polymarket usando una seed phrase o una private key. Per un EOA, il *funder* (l'indirizzo che detiene il denaro) coincide con il tuo wallet di firma. Predite lo impone effettivamente: se selezioni il Type 0 e fornisci un funder address diverso, il server lo sostituisce con l'indirizzo del tuo stesso wallet, per evitare in seguito silenziosi fallimenti degli ordini.
- •Type 2 — Gnosis Safe Proxy. È il tipo più comune per chi si è registrato su polymarket.com tramite social login o email (Google, ecc.). Polymarket ha predisposto per te un wallet "proxy" basato su smart contract dietro le quinte. La tua chiave di firma è un indirizzo, ma i tuoi fondi risiedono in un wallet proxy *separato*. Quell'indirizzo proxy è il tuo funder, e lo trovi su polymarket.com/settings.
- •Type 1 — Magic Link Proxy. Scegli questo se accedi a Polymarket tramite Magic Link (email) e hai esportato la private key sottostante. Come il Type 2, usa un indirizzo proxy separato come funder.
Un modo rapido per autodiagnosticarti: *Ho importato in Polymarket il mio wallet in stile MetaMask?* → Type 0. *Mi sono semplicemente registrato con il mio account Google o con l'email sul sito?* → quasi certamente Type 2.
Passaggio 2: ottieni la tua private key
Dove esportare la key dipende dal tuo wallet:
- •MetaMask: clicca sui tre puntini accanto al nome del tuo account → Account details → Show private key, inserisci la password e copia la stringa esadecimale di 64 caratteri (potrebbe iniziare o meno con
0x— Predite accetta entrambe le forme e la normalizza). - •Account proxy Magic Link / email: usa l'opzione "Export Private Key" di Polymarket nelle impostazioni del tuo account.
Finché la hai negli appunti, tratta quella stringa come una granata innescata. Non incollarla in una chat, in una nota che si sincronizza sul cloud o in qualsiasi sito diverso dal modulo di collegamento di Predite su HTTPS. Svuota gli appunti subito dopo.
Passaggio 3: trova il tuo funder address (solo Type 1 e 2)
Se sei un EOA Type 0, salta questo passaggio: lascia vuoto il campo funder e Predite userà automaticamente l'indirizzo del tuo wallet. Per i Type 1 e 2, vai su polymarket.com/settings e copia il tuo indirizzo proxy/di deposito. Questo è l'indirizzo che Predite valida come tuo funder, e deve essere diverso dal tuo wallet di firma. Di fatto, l'endpoint di collegamento rifiuterà il tentativo con un messaggio esplicito se il funder coincide con il wallet su un tipo proxy: questa discrepanza è l'errore di configurazione più comune in assoluto, e quasi sempre significa che in realtà hai un EOA e avresti dovuto scegliere il Type 0.
Passaggio 4: esegui la procedura guidata di collegamento
In Predite, vai su Settings → Trading API → Polymarket. La procedura guidata ti accompagna passo dopo passo:
- Schermata introduttiva. Spiega il flusso e ti ricorda di usare un wallet dedicato. C'è una guida visiva opzionale passo dopo passo che puoi aprire prima.
- Presa d'atto dei rischi. Spunterai una casella confermando di aver compreso che il live trading è in beta, che i bug del software potrebbero causare operazioni indesiderate, che sei l'unico responsabile dei fondi nel wallet collegato e che Predite non può recuperare fondi persi. Questo viene registrato.
- Modulo delle credenziali. Scegli il tuo tipo di wallet (signature type 0/1/2), incolla la tua private key (c'è un toggle mostra/nascondi) e inserisci il tuo funder address se richiesto.
- Connect. Predite firma un messaggio con la tua key per derivare le tue credenziali dell'API CLOB di Polymarket (un passaggio L2 — al momento del collegamento non avviene alcuna transazione on-chain, e nulla viene speso), cifra tutto e lo salva.
I tentativi di collegamento sono soggetti a rate limit di 5 ogni 15 minuti per scoraggiare il brute-forcing e incentivare l'inserimento corretto dei dati. Se qualcosa non va, riceverai un errore specifico: signature type errato e wallet non registrati sono i colpevoli abituali.
Passaggio 5: testa prima di fidarti
Una volta collegato, la scheda Polymarket mostra un pulsante "Place Test Order". Usalo. Incolla il token_id di un mercato (lo trovi nei dettagli dell'asset nello scanner o su clob.polymarket.com), imposta una size minuscola come 5 share a $0,50 e invialo. Se il live trading a livello di piattaforma è ancora disattivato, l'ordine viene registrato come paper trade, così puoi validare l'intera pipeline collega → firma → invia con rischio zero. Quando passi al live, inizia con ordini da $1–$5 per le tue prime operazioni reali.
Alcune cose che vedrai sulla scheda collegata: i tuoi indirizzi wallet e funder, il tuo tipo di wallet, un indicatore di allowances (approvazioni di spesa USDC, configurate automaticamente alla prima operazione) e un indicatore di gas. Se il tuo account fa parte del programma relayer/builder di Polymarket vedrai un badge "Gasless" — le operazioni vengono instradate attraverso il relayer di Polymarket e ti servono solo USDC. In caso contrario ti servirà una piccola quantità di MATIC nel wallet per pagare il gas.
Parte 3: collegare Kalshi
Kalshi non ha nulla a che vedere, dal punto di vista architetturale, con Polymarket. È un exchange regolamentato dalla CFTC senza blockchain: l'autenticazione avviene tramite una API key più la firma RSA delle richieste, e richiede il completamento del KYC. A causa di questo design regolamentato e basato su firma, il live trading su Kalshi all'interno di Predite è in roadmap, non ancora rilasciato. La scheda Kalshi in Settings mostra un chiaro stato "coming soon".
Ecco però la sfumatura importante: i dati di mercato di Kalshi, le analisi, la copertura dello scanner e le letture del portafoglio in sola lettura funzionano già ovunque nel resto dell'app. I mercati Kalshi compaiono nell'EV Scanner, il motore di arbitrage li confronta con Polymarket per individuare spread cross-platform, e una volta collegato il connettore di lettura al tuo account le tue posizioni Kalshi confluiscono nel Portfolio unificato. Per avere pronta una API key di Kalshi in vista dell'espansione delle letture/del trading:
- Accedi a kalshi.com e completa il KYC se non l'hai ancora fatto.
- Vai su Account → API / Settings e crea una API key. Kalshi rilascia un key ID e ti consente di scaricare un file di private key RSA una sola volta: salvalo in modo sicuro, non può essere riscaricato.
- Conserva entrambi al sicuro. Quando Predite abiliterà il collegamento a Kalshi, incollerai il key ID e la key RSA, e verranno cifrati esattamente come le credenziali di Polymarket.
Per ora, la mossa pratica è: appoggiati a Kalshi per *letture e segnali* tramite lo scanner, ed esegui su Kalshi manualmente finché il live trading non arriverà.
Cosa si attiva una volta collegato
Questa è la ricompensa. Il collegamento trasforma Predite da scanner generico in qualcosa di calibrato su *di te*:
- •Il portafoglio prende vita. La pagina Unified Portfolio aggrega le posizioni di ogni piattaforma collegata in un'unica vista — valore totale, costo base totale (share × prezzo medio) e suddivisioni per singola piattaforma. Una sola schermata invece di tre schede del browser.
- •P&L reale, non ipotetico. Invece di tirare a indovinare, vedi i guadagni e le perdite non realizzati effettivi per ogni posizione, calcolati dai tuoi prezzi di ingresso reali rispetto ai prezzi di mercato in tempo reale. Una posizione aperta a $0,40 che ora viene scambiata a $0,61 mostra un concreto +52,5% anziché un'astrazione.
- •Lo scanner lavora sulle tue posizioni. Questa è quella silenziosamente potente. L'EV Scanner può segnalare quando un mercato che già detieni si è spostato: per esempio, il tuo modello indica ancora il 60% ma il prezzo lo ha raggiunto al 60%, il che significa che il tuo edge è svanito ed è ora di reimpiegare il capitale. Può anche far emergere esposizioni correlate: se tre delle tue posizioni si risolvono tutte sulla stessa decisione della Fed, in pratica si tratta di un'unica scommessa, e vederle insieme ti impedisce di concentrarti troppo.
- •Esportazioni e report fiscali. Con lo storico reale delle operazioni collegato, puoi esportare CSV e generare un report P&L/fiscale con totali mensili e costo base FIFO — molto più facile a fine anno che ricostruire le operazioni a mano.
- •Automazione (piano Bot). Con un collegamento per il trading attivo, i bot dimensionano e piazzano gli ordini sul tuo bankroll reale, e diventano disponibili l'interfaccia di Live Trading, il kill switch e i controlli per singola operazione.
Sicurezza: come vengono memorizzati i tuoi dati segreti
Ci stai affidando una private key, quindi meriti di sapere esattamente cosa le accade. La versione onesta e dettagliata:
- •La cifratura è AES-256-GCM, un cifrario autenticato che protegge sia la riservatezza sia l'integrità (un testo cifrato manomesso non si decifra, anziché restituire silenziosamente dati spazzatura).
- •La key è derivata con scrypt, una funzione di derivazione della chiave deliberatamente lenta, usando un salt casuale di 16 byte e un IV casuale di 12 byte nuovo per ogni singola cifratura. Due valori memorizzati non condividono mai gli stessi parametri, il che vanifica gli attacchi rainbow-table e di riuso dell'IV.
- •Il testo in chiaro non tocca mai il disco. La tua private key arriva via HTTPS, viene cifrata in memoria, e nel database viene scritto solo il testo cifrato. Quando un bot deve firmare un ordine, la key viene decifrata in memoria solo per l'istante necessario alla firma, poi scartata.
- •I dati segreti non vengono mai registrati nei log — nemmeno parzialmente. L'audit log registra che è avvenuto un collegamento, il wallet, il funder e il signature type, ma il codice esclude esplicitamente la private key e l'API secret da ogni riga di log.
- •Lo scollegamento rimuove davvero le credenziali. Premi "Disconnect" e una routine del server azzera le tue key memorizzate; qualsiasi bot in modalità live smette di inviare ordini e ricevi una notifica: non diventa un bot paper in silenzio. Per ruotare una key, basta scollegarsi e ricollegarsi con quella nuova.
Nulla di tutto ciò cambia la regola fondamentale, che vale la pena ripetere un'ultima volta: la cifratura protegge la key *a riposo nel nostro sistema*, ma non può annullare un'operazione sbagliata né recuperare fondi se la seed phrase del tuo wallet trapela altrove. L'abitudine del wallet dedicato è la tua vera rete di sicurezza — il software è il secondo livello, non il primo.
Ora hai tutto ciò che ti serve per integrare Predite nel tuo trading. Se oggi fai una sola cosa, incolla l'indirizzo del tuo wallet Polymarket nella pagina Portfolio e osserva le tue posizioni reali e il P&L live popolarsi in pochi secondi — è in sola lettura, privo di rischi e rende immediatamente più intelligente ogni altra funzione. Quando sarai pronto a lasciar lavorare i bot, finanzia un wallet nuovo con una cifra che ti lascerebbe indifferente, esegui la procedura guidata di collegamento e invia un ordine di test da $1 prima di qualsiasi cosa più grande. Inizia in piccolo, verifica tutto, e scala solo quando i numeri corrisponderanno alle tue aspettative.