Skip to main content
← Torna ai Docs
🚀Primi Passi

Collegare il tuo wallet

Collega Polymarket & Kalshi per vedere posizioni reali e fare trading

Predite legge le tue posizioni in tempo reale, i saldi e il P&L direttamente dai tuoi account di trading e, con il piano adatto, può piazzare ordini al posto tuo. Niente di tutto questo funziona finché non colleghi un wallet. Questa pagina spiega con precisione cosa sia una connessione, come configurarne una sia per Polymarket sia per Kalshi, i tre signature type di Polymarket, cosa sia un funder address e come manteniamo al sicuro le tue chiavi.

Cosa fa davvero "collegare un wallet"

Ci sono due cose distinte che puoi concedere a Predite, e vale la pena essere precisi sulla differenza perché hanno profili di sicurezza molto diversi:

  • •Connessione in sola lettura — Predite può vedere le tue posizioni, gli ordini aperti, le esecuzioni e i saldi. Non può spostare fondi né piazzare operazioni. Questo è sufficiente per alimentare la dashboard del Portfolio, il tuo Trade Journal, il monitoraggio del P&L su denaro reale e per permettere all'EV Scanner di segnalare opportunità sui mercati che già detieni.
  • •Connessione di trading — Predite può firmare e inviare ordini per tuo conto. È questo a far funzionare il Live Trading, gli ordini TWAP, il Copy Trading e il Bot automatizzato. Una connessione di trading richiede la tua private key (o una credenziale API, su Kalshi) affinché l'app possa firmare le transazioni.

Decidi tu quale vuoi per ciascun wallet. Una connessione in sola lettura non chiede mai una private key. Puoi iniziare in sola lettura e passare al trading in seguito, oppure tornare indietro in qualsiasi momento scollegando e ricollegando.

> Limitazioni per piano: le connessioni in sola lettura e il monitoraggio del portfolio su denaro reale sono disponibili su tutti i piani (Starter $29, Pro $59, Bot $99). Il Live Trading manuale e gli ordini TWAP richiedono Pro o Bot. L'esecuzione completamente automatizzata — il Bot che esegue le strategie e il Copy Trading con auto-fill — richiede il piano Bot $99/mese. Se colleghi un wallet di trading su Starter, otterrai comunque i dati completi in sola lettura; i pulsanti di esecuzione restano semplicemente disabilitati finché non esegui l'upgrade.

Dove trovarlo

Tutto si trova in Impostazioni → Trading API. Da qualsiasi schermata:

  1. Apri Impostazioni dalla barra laterale sinistra (o dall'icona a ingranaggio, in alto a destra).
  2. Seleziona la scheda Trading API.
  3. Vedrai due card: Polymarket e Kalshi, ciascuna con un badge di stato — Non connesso, Sola lettura o Trading abilitato.

Ogni card si espande nel proprio flusso di connessione. Puoi collegare un venue, entrambi o nessuno. Le funzionalità di Predite si adattano in modo graduale: collega solo Kalshi e gli strumenti specifici per Polymarket semplicemente non mostreranno dati.

Collegare Polymarket

Polymarket gira su Polygon e regola le operazioni tramite il suo CLOB (Central Limit Order Book). Poiché gli account Polymarket esistono in diverse varianti, questa è la più articolata delle due connessioni. Dovrai fornire tre elementi: una private key, un signature type e — per due dei tre tipi — un funder address.

Passo dopo passo

  1. In Impostazioni → Trading API, clicca su Connetti nella card di Polymarket.
  2. Scegli Sola lettura o Trading. - Per la Sola lettura, incolla soltanto il tuo indirizzo wallet pubblico (l'indirizzo 0x…). Clicca Verifica e hai finito — passa alla nota di verifica più sotto. - Per il Trading, prosegui con i passaggi qui sotto.
  3. Seleziona il tuo signature type (vedi la sezione successiva — è la singola causa più comune di errori di connessione).
  4. Incolla la tua private key. È la chiave dell'account che firma gli ordini sul CLOB. È una stringa esadecimale di 64 caratteri, con o senza il prefisso 0x.
  5. Inserisci il tuo funder address se il tuo signature type lo richiede (tipi 1 e 2 — spiegati più sotto). Per un EOA (tipo 0), lascialo vuoto.
  6. Clicca Testa connessione. Predite ricava il signer address dalla tua chiave, interroga il CLOB per il tuo saldo ed eventuali posizioni aperte e ti mostra un riepilogo di conferma: il signer che ha ricavato, il funder da cui opererà e il tuo saldo USDC attuale.
  7. Verifica che il riepilogo corrisponda a quanto ti aspetti, poi clicca Salva e cripta. La tua chiave viene crittografata prima ancora di toccare il nostro database (dettagli nella sezione sulla sicurezza).

I tre signature type

Polymarket supporta tre architetture di account, e il CLOB ha bisogno di sapere quale stai usando per costruire correttamente la firma dell'ordine. Scegli quello sbagliato e gli ordini verranno rifiutati con un errore di signature-mismatch anche se la tua chiave è valida.

  • •Tipo 0 — EOA (Externally Owned Account). Un wallet semplice — la private key controlla direttamente i fondi e firma gli ordini. Il signer *è* il funder, quindi non serve alcun funder address. Usa questo tipo se hai finanziato Polymarket da un wallet self-custodied come MetaMask e non sei mai passato per l'onboarding web di Polymarket.
  • •Tipo 1 — Wallet Email / Magic. È il tipo più comune per chi si è registrato su polymarket.com con un indirizzo email. Polymarket ti assegna un wallet Magic e i tuoi fondi risiedono in un proxy contract associato. La private key firma, ma i fondi si trovano a un funder address separato. Devi fornire quel funder address — è l'indirizzo di deposito che Polymarket mostra nel tuo account, non il signer address.
  • •Tipo 2 — Browser wallet / proxy Gnosis Safe. Hai collegato un browser wallet esterno (ad es. MetaMask) tramite l'interfaccia di Polymarket, e Polymarket ha distribuito un proxy Gnosis Safe che detiene effettivamente le tue posizioni. La chiave del tuo browser wallet firma, ma il Safe è il funder. Indica l'indirizzo del Safe come funder.

Un modo rapido per decidere: se accedi a Polymarket con un'email, sei quasi certamente di tipo 1. Se accedi collegando un browser wallet, sei di tipo 2. Se non hai mai usato il sito di Polymarket e hai finanziato tu stesso un wallet grezzo, sei di tipo 0.

Cos'è un funder address

Il funder address è semplicemente *l'indirizzo che detiene gli USDC e i token di posizione* — l'account che viene effettivamente addebitato quando compri e accreditato quando vendi. Nel tipo 0, il signer e il funder sono lo stesso indirizzo, quindi non c'è nulla da inserire. Nei tipi 1 e 2, Polymarket separa il *signer* (la chiave che autorizza un ordine) dal *funder* (il contratto che detiene e muove il denaro). Il CLOB associa gli ordini al funder, quindi se lo ometti o incolli il signer address per errore, l'exchange segnalerà un saldo pari a zero o rifiuterà l'ordine.

Puoi trovare il tuo funder address in Polymarket sotto il tuo profilo → indirizzo di deposito, oppure copiando l'indirizzo mostrato nella pagina del tuo portfolio Polymarket. Sarà diverso dall'indirizzo ricavato dalla tua private key — è normale e corretto per i tipi 1 e 2.

Problemi comuni con Polymarket

  • •"Il saldo mostra $0 ma ho dei fondi." Quasi sempre il funder address o il signature type sbagliato. Ricontrolla se sei di tipo 1 (Magic/email) o di tipo 2 (Safe/browser), e conferma che il funder sia l'indirizzo di deposito, non il signer.
  • •"Firma rifiutata sull'ordine." Signature type sbagliato. La chiave va bene; il tipo non corrisponde. Scollega e ricollega con il tipo corretto.
  • •Allowance. Per una connessione di trading, il funder deve aver approvato la spesa di USDC e di conditional token sul CLOB. Se hai mai operato sul sito di Polymarket, questo è già impostato. Se l'account è nuovissimo e non ha mai piazzato un ordine, piazza prima un piccolo ordine su polymarket.com per impostare le allowance, poi collegati qui.
  • •Usa un wallet di trading dedicato per il Bot. Se prevedi di eseguire strategie automatizzate, valuta di finanziare un wallet separato con il solo bankroll di trading, anziché collegare una chiave che controlla l'intero tuo patrimonio crypto. Raggio d'azione più ridotto in caso di problemi, P&L più pulito.

Collegare Kalshi

Kalshi è un exchange statunitense regolamentato e non usa wallet crypto o private key nel senso di Polygon. Ti colleghi invece con una API key Kalshi.

  1. In Kalshi, vai su Account → API Keys e genera una chiave. Kalshi ti fornisce un Key ID e una private key (una chiave RSA usata per firmare le richieste API). Scarica o copia entrambi — Kalshi mostra la private key una sola volta.
  2. In Predite, clicca su Connetti nella card di Kalshi in Impostazioni → Trading API.
  3. Scegli Sola lettura o Trading. (Il modello a API key di Kalshi fa sì che la stessa credenziale possa fare entrambe le cose; scegli Sola lettura se vuoi che Predite ignori il permesso di trading e non piazzi mai ordini.)
  4. Incolla il tuo Key ID e la private key.
  5. Clicca Testa connessione. Predite si autentica, recupera il tuo saldo e le posizioni aperte e mostra un riepilogo.
  6. Clicca Salva e cripta.

Note su Kalshi:

  • •Assicurati che l'API key abbia i permessi che intendi assegnarle. Una chiave in sola lettura su Kalshi semplicemente non può operare, anche se in seguito attivi l'interruttore in Predite.
  • •Kalshi applica i propri rate limit. Predite raggruppa e regola automaticamente le richieste, ma se usi il Bot in modo aggressivo su molti mercati potresti occasionalmente notare brevi ritardi nell'aggiornamento dei dati — è un limite di Kalshi, non un bug di Predite.

Come proteggiamo la tua chiave

Questa è la parte che conta di più, quindi saremo precisi.

  • •Crittografia a riposo. La tua private key (o chiave RSA di Kalshi) viene crittografata con AES-256-GCM prima di essere scritta nel database. AES-256-GCM è un cifrario autenticato: cripta i dati e rileva qualsiasi manomissione. Ogni chiave viene crittografata con un vettore di inizializzazione univoco, e la chiave di crittografia è conservata in un secrets store gestito, mai nello stesso luogo del testo cifrato.
  • •Decrittografata solo in memoria, solo per firmare. Quando piazzi un'operazione (o lo fa il Bot), la chiave viene decrittografata in memoria per il solo istante necessario a firmare quella singola transazione, poi viene scartata. Non viene mai riscritta su disco in chiaro.
  • •Non registriamo mai le chiavi. Le private key sono escluse da ogni log, report di errore, crash dump ed evento di analytics. Se qualcosa va storto, i nostri log registrano l'*evento* ("firma dell'ordine fallita per il wallet che termina con …a3f1") ma mai il segreto stesso. Inoltre, oscuriamo le chiavi da qualsiasi sessione di supporto — il nostro team non può vedere la tua chiave, nemmeno se lo chiedi.
  • •In transito. Tutte le connessioni avvengono tramite TLS. La tua chiave viene crittografata al momento dell'invio e non viene mai inviata ad alcuna terza parte diversa dall'exchange su cui stai operando.
  • •Mantieni il controllo. Predite firma esclusivamente gli ordini specifici che autorizzi (trading manuale) o che corrispondono alla strategia/ai guardrail che hai configurato (Bot, Copy Trading). Non può prelevare fondi verso un indirizzo esterno — le trading API che usiamo hanno permessi limitati al piazzamento e all'annullamento di ordini, non ai trasferimenti.

Se preferisci non memorizzare affatto una chiave di firma, usa una connessione in sola lettura. Perderai le funzionalità di esecuzione ma manterrai analisi complete del portfolio, journaling e avvisi EV. Per il modello di minaccia completo e i nostri impegni sulla gestione dei dati, consulta la pagina Sicurezza.

Scollegare un wallet

Puoi revocare l'accesso in qualsiasi momento:

  1. Vai su Impostazioni → Trading API.
  2. Nella card pertinente, clicca su Scollega.
  3. Conferma. Eliminiamo in modo permanente il testo cifrato memorizzato della tua chiave dai nostri sistemi. Vengono rimossi anche gli indirizzi pubblici in sola lettura.

Lo scollegamento disabilita immediatamente qualsiasi funzionalità che dipende da quel wallet — il Bot va in pausa, il Copy Trading smette di replicare e i pulsanti di esecuzione live diventano grigi. Le voci storiche del tuo Trade Journal e i record del P&L vengono conservati (sono i tuoi dati, non la tua chiave), quindi lo scollegamento non cancella il tuo storico delle performance.

Per la massima sicurezza dopo aver scollegato un wallet *di trading* di cui non ti fidi più, ruota il segreto sottostante alla fonte: genera una nuova API key Kalshi oppure, per Polymarket, sposta i fondi su un nuovo wallet. Eliminarla da Predite rimuove la nostra copia, ma solo tu puoi invalidare la chiave stessa.

Verificare che abbia funzionato

Dopo esserti collegato, vai alla pagina Portfolio. Entro pochi secondi dovresti vedere le tue posizioni in tempo reale, il cost basis e il P&L non realizzato recuperati direttamente dall'exchange. Se la card Trading API mostra Trading abilitato e il Portfolio è popolato, la configurazione è completa. Da qui:

  • •L'EV Scanner e il modello AI Probability possono confrontare le tue posizioni con il fair value.
  • •Live Trading e ordini TWAP si sbloccano (Pro/Bot) per l'esecuzione manuale con il wallet collegato.
  • •Il Bot e il Copy Trading possono operare automaticamente (piano Bot), entro i guardrail che imposti.

Se le posizioni non compaiono, ricontrolla i controlli su signature type e funder address descritti sopra — questo risolve la grande maggioranza dei problemi di connessione con Polymarket.

Documentazione correlata

← Tutta la Documentazione