Public API
Chiavi API REST per accesso programmatico (piano Bot)
La Public API di Predite ti permette di leggere i tuoi dati in modo programmatico — il tuo portfolio live e gli ultimi segnali Expected Value — dai tuoi script, fogli di calcolo o strumenti di trading. È una REST API di sola lettura protetta da una API key personale, disponibile nel piano Bot.
Le key si creano e si gestiscono dalla dashboard, in Impostazioni, nella pagina API.
Creare una API key
Assegna alla key un'etichetta (per esempio "sheet import" o "backtest script") e creala. Qualche cosa da sapere:
- •La key completa viene mostrata una sola volta, al momento della creazione. Ha la forma pdt_live_ seguito da una stringa casuale. Copiala subito e conservala in un posto sicuro — non viene mai più mostrata, perché sui nostri server resta solo il suo hash.
- •Dopo la creazione la dashboard mostra soltanto il prefisso breve della key, così puoi distinguere le tue key tra loro.
- •Ogni key è di sola lettura e scade dopo un anno dalla creazione. Ti avvisiamo prima che decada.
- •Puoi revocare una key in qualsiasi momento. La revoca ha effetto immediato — ogni script che la sta ancora usando inizia a ricevere 401 Unauthorized.
Autenticazione
Invia la key come Bearer token nell'header Authorization di ogni richiesta:
Authorization: Bearer pdt_live_your_key_here
Una key mancante o non valida restituisce HTTP 401. Le richieste hanno un rate limit per client — se ne invii troppe troppo in fretta ricevi HTTP 429 con un header Retry-After che indica quanti secondi aspettare. Tieni il polling a poche richieste al minuto e metti in cache quello che scarichi; questi dati non cambiano di secondo in secondo.
Endpoint
Oggi sono disponibili due endpoint GET, entrambi restituiscono JSON.
GET /api/v1/portfolio
Restituisce le posizioni aperte del wallet Polymarket collegato al tuo account, insieme a un riepilogo e a un timestamp generated_at. Se non hai ancora collegato e verificato un wallet, l'array positions torna vuoto con errore no_wallet_connected — collegane prima uno (vedi Collegare un wallet).
GET /api/v1/signals
Restituisce i migliori segnali Expected Value del momento, ordinati per edge. Due query parameter opzionali:
- •limit — quanti segnali restituire, da 1 a 100 (default 20)
- •min_edge — l'edge minimo in punti percentuali (default 5)
La risposta include l'array signals, un count, i filtri che hai usato e un timestamp generated_at.
Esempio
Una richiesta minima con curl, che chiede i dieci segnali più forti con almeno sei punti di edge:
curl -H "Authorization: Bearer pdt_live_..." "https://predite.io/api/v1/signals?limit=10&min_edge=6"
Da sapere
- •La API è di sola lettura — non esistono endpoint di trading o di scrittura. Gli ordini si piazzano sempre dall'app, quindi una key trafugata non può mai muovere i tuoi soldi.
- •Detto questo, tratta la key come una password. Se trapela, revocala ed emettine una nuova.
- •Preferisci ricevere gli alert invece di fare polling? Collega il tuo account a Telegram e lascia che siano i segnali a raggiungerti.