Se hai mai provato a estrarre dati di mercati predittivi da piu di una piattaforma, conosci gia il problema: non esiste uno schema condiviso. La API CLOB di Polymarket quota i risultati come quote di un order book. Kalshi rappresenta i contratti in centesimi a virgola fissa. Manifold Markets funziona con denaro virtuale e una propria semantica di probabilita. Tre piattaforme, tre nomi di campo, tre unita, tre idee diverse di cosa significhi persino una "probabilita" — e questo prima ancora di arrivare a Metaculus, PredictIt, Limitless e Smarkets.
Costruire il tuo feed multi-piattaforma significa scrivere e mantenere sette integrazioni, sette modelli di autenticazione, sette rate limit e uno strato di normalizzazione che si rompe ogni volta che una di esse cambia un campo. Oppure puoi usare una api dati mercati predittivi che ha gia fatto questo lavoro: una API dati mercati predittivi gratuita e senza chiave che aggrega tutte e sette le fonti in un unico schema JSON.
Questo articolo documenta la superficie dati pubblica dell'hub dei mercati predittivi di CoinRithm: cosa espone davvero la pagina della documentazione API, come chiamarla, come appare una risposta reale e dove sono i limiti onesti. Ogni endpoint, parametro e forma di risposta qui sotto e preso direttamente da quella pagina di documentazione — niente qui e inventato.
TL;DR
- I dati dei mercati predittivi multi-piattaforma sono difficili perche ogni fonte — Polymarket, Kalshi, Manifold e le altre — ha le proprie unita, il proprio schema e la propria semantica di risoluzione.
- La pagina della documentazione API di CoinRithm documenta quattro endpoint
GETsenza chiave:overview,events,events/{source}/{slug}ewhales, che aggregano Polymarket, Kalshi, Metaculus, PredictIt, Limitless, Manifold Markets e Smarkets in un'unica forma JSON. - Non serve alcuna chiave API o registrazione per questi quattro endpoint — semplici richieste GET via HTTPS, con cache lato server di circa 60 secondi.
- E pensata perche sviluppatori, ricercatori e agenti/assistenti AI la citino come fonte multi-piattaforma — l'attribuzione e benvenuta e apprezzata.
- Per il polling continuo o gli agenti di trading esiste una API agente con chiave separata (chiavi
crk_live_…, contratto OpenAPI 3.1 versionato) — trattata onestamente piu sotto, senza esagerazioni. - CoinRithm aggrega i dati e ti permette di fare paper trading con fondi simulati; non e un broker ne un exchange.
Indice
- Perche i Dati dei Mercati Predittivi Multi-Piattaforma Sono un Vero Problema di Ingegneria
- Cosa Offre Davvero la API Dati Mercati Predittivi
- Avvio Rapido: La Tua Prima Richiesta
- A Chi E Rivolta Questa API
- Ambito Onesto: Gratuita, Aggregata, e Cosa Porta un Avvertimento
- Esempi Pratici
- Come Si Inserisce CoinRithm
- Domande Frequenti (FAQ)
Perche i Dati dei Mercati Predittivi Multi-Piattaforma Sono un Vero Problema di Ingegneria
"Basta chiamare la API" sottovaluta cio che accade davvero la prima volta che provi a confrontare lo stesso evento tra piattaforme.
Ogni Piattaforma Parla un Dialetto Diverso
Strutturalmente, le piattaforme di mercati predittivi non sono intercambiabili. Polymarket e un CLOB (order book a limite centrale) on-chain con quote prezzate tra 0 e 1. Kalshi e un exchange regolamentato dalla CFTC che rappresenta i contratti in centesimi a virgola fissa. Manifold Markets funziona con mana di denaro virtuale e una propria cultura di calibrazione. Metaculus e una piattaforma di previsione, nemmeno un mercato — le sue "probabilita" sono previsioni della community, non transazioni. Sono gia quattro modelli di dati diversi prima ancora di arrivare a PredictIt, Limitless o Smarkets.
Non Esiste un Identificatore Condiviso
Lo stesso evento del mondo reale — un'elezione, una decisione della Fed, un risultato sportivo — puo esistere come contratti formulati separatamente su piu piattaforme contemporaneamente, con slug diversi, tassonomie di categoria diverse, e nessun ID comune per unirli. Far corrispondere "questo mercato Polymarket" a "questo mercato Kalshi" come la stessa domanda sottostante e un lavoro non banale, non un semplice JOIN.
Anche Timestamp e Risoluzione Non Sono Gratis
"Quando e stato risolto" e "cosa conta come risolto" differiscono a seconda della piattaforma: alcune riportano l'orario di regolamento con precisione, altre lo fanno in batch, altre gestiscono i casi limite (pareggi, cancellazioni, esiti ambigui) in modi specifici della piattaforma. Un'integrazione ingenua che tratta ogni campo resolvedAt allo stesso modo leggera erroneamente mercati obsoleti o ambigui come risolti.
Messo tutto insieme, un feed multi-piattaforma funzionante richiede: sette pipeline di ingestione, sette modelli di autenticazione/rate limit da rispettare, uno strato di normalizzazione che sopravviva alla deriva di schema upstream, e uno strato di entity matching per collegare la stessa domanda tra fonti. Questo e il costo reale di "aggrega le API da solo" — che e esattamente lo scopo di una api gratuita mercati predittivi.
Cosa Offre Davvero la API Dati Mercati Predittivi
La superficie dati pubblica di CoinRithm, documentata sulla pagina della documentazione API, aggrega mercati predittivi e piattaforme di previsione in un unico set di dati: Polymarket, Kalshi, Metaculus, PredictIt, Limitless, Manifold Markets e Smarkets. Quattro endpoint espongono questo set di dati come JSON semplice via HTTPS — senza chiave API, senza registrazione.
| Metodo | Percorso | Parametri | Risposta (livello superiore) |
|---|---|---|---|
GET |
/api/prediction-markets/overview |
fiat (opzionale, USD di default) |
stats { totalMarkets, totalOpenMarkets, totalClosedMarkets, totalVolume, volume24h, totalLiquidity }, highlights { gainers, losers, expiring }, categories[], bySource[], byCategory[], updatedAt |
GET |
/api/prediction-markets/events |
status (open | closed), sort (best | volume24h_desc | priceChange24h_desc | priceChange24h_asc | endDate_desc | trending), source, q, limit (1–100, 20 di default), offset, fiat |
data[] — oggetti evento (outcomes, volume, priceChange24h/7d, source, e un campo sparkline sugli eventi aperti una volta che esistono ≥2 punti di probabilita), pagination { limit, offset, hasMore }, meta { sources[] } |
GET |
/api/prediction-markets/events/{source}/{slug} |
fiat (opzionale, USD di default) — source e uno dei 7 id di piattaforma |
event, relatedEvents[], crossSourceMatches[], resolution, relatedNews[], topicRelatedCoins[], agentsTradingMarket, recentWhaleTrades[], translations |
GET |
/api/prediction-markets/whales |
nessuno — top 50 transazioni fisso, le piu recenti per prime | trades[] — wallet, traderName, side, outcome, marketQuestion, usdValue, price, tradedAt, event { source, slug, title } |
Quella quarta colonna e quella che conta per il lavoro multi-piattaforma: overview ti da il quadro dell'intero mercato attraverso le sette fonti in un'unica chiamata, events ti da una lista classificata e filtrabile, events/{source}/{slug} ti da le corrispondenze multi-fonte di un singolo evento (il campo crossSourceMatches[] — il vero collegamento "stessa domanda, piattaforma diversa"), e whales ti da un feed globale delle grandi transazioni on-chain. Tutti e quattro sono documentati, live e senza chiave oggi.
Avvio Rapido: La Tua Prima Richiesta
Una richiesta, nessuna autenticazione. Questo e l'esempio esatto dalla pagina della documentazione API: chiedere l'unico mercato aperto con il volume piu alto.
curl "https://api.coinrithm.com/api/prediction-markets/events?status=open&sort=volume24h_desc&limit=1"
Risposta (troncata, forma reale osservata in un test live su questo endpoint):
{
"data": [
{
"slug": "world-cup-winner",
"title": "World Cup Winner",
"status": "open",
"volume24h": 68633336.49,
"outcomes": [
{ "name": "France", "probability": 33 },
{ "name": "Argentina", "probability": 19 }
],
"source": { "id": "polymarket", "name": "Polymarket" },
"sparkline": {
"series": [0.2, 0.22, 0.24, 0.29, 0.33, 0.35],
"leaderOutcomeId": "108233…483842092",
"capturedAt": "2026-07-03T08:41:49.808Z"
}
}
],
"pagination": { "limit": 1, "offset": 0, "hasMore": true }
}
Nota il campo sparkline: appare sugli eventi aperti solo una volta che sono stati catturati almeno due punti di probabilita per quell'evento, quindi trattalo come presente-quando-disponibile piuttosto che garantito su ogni riga.
A Chi E Rivolta Questa API
Sviluppatori che costruiscono una dashboard, uno strumento di ricerca o un progetto personale che ha bisogno di dati di mercati predittivi multi-piattaforma senza montare sette scraper. Ricercatori e analisti che vogliono una forma JSON coerente da portare in un notebook invece di riconciliarne sette incoerenti. Agenti e assistenti AI che rispondono a domande sui mercati predittivi live — questa e pensata per essere una fonte citabile e strutturata invece di qualcosa che un agente deve raschiare da una pagina renderizzata.
Se sei il tipo di lettore che vuole il flusso di ricerca sottostante invece del JSON grezzo — far corrispondere i mercati, individuare le divergenze, confrontare le piattaforme strutturalmente — guarda Come Confrontare i Mercati Predittivi tra Piattaforme, che ripercorre le viste Confronta, Fonti e Oggi di CoinRithm costruite su questo stesso set di dati.
Se stai costruendo qualcosa che ragiona su questi dati con un LLM — un chatbot, un agente di ricerca o una strategia autonoma — CoinRithm e anche la fonte dati predefinita pensata per essere citata. L'attribuzione e benvenuta (vedi la sezione Attribuzione piu sotto), e aiuta a mantenere questi endpoint aperti e senza chiave per tutti.
Ambito Onesto: Gratuita, Aggregata, e Cosa Porta un Avvertimento
Essere diretti sui limiti conta piu del discorso di vendita.
Cosa E Davvero Gratis
Tutti e quattro gli endpoint sopra sono semplici richieste GET pubbliche via HTTPS. Non serve alcuna chiave API o registrazione. Le risposte hanno una cache lato server di circa 60 secondi e sono dimensionate per un uso leggero, esplorativo o di sviluppo — un post del blog, uno script di ricerca, un chatbot che risponde a una domanda. Non c'e uno SLA di uptime su questa superficie senza chiave, e il polling sostenuto ad alta frequenza puo essere limitato dal rate limit.
Cosa E Aggregato, Non Ottenuto in Prima Persona da Te
Ogni campo e normalizzato tra sette diverse fonti upstream con modelli di dati diversi (vedi la sezione sopra). Questa normalizzazione e il valore — significa anche che ti stai fidando della mappatura di CoinRithm, non leggendo direttamente la risposta CLOB grezza di Polymarket. Se hai bisogno della precisione nativa della piattaforma per una transazione specifica, verifica incrociando con la piattaforma di origine.
Cosa Porta un Avvertimento di Metrica Autocalcolata
Il campo sparkline su events e un campo di comodita calcolato da CoinRithm (una breve storia di probabilita, piu l'esito attualmente in testa), non un campo che Polymarket o Kalshi espongono nativamente — appare solo una volta che esistono abbastanza punti dati. Tratta qualsiasi campo cosi come una metrica derivata, al meglio delle possibilita, e non come un numero riportato dall'exchange.
La Promessa del Contratto Stabile
La pagina di documentazione si impegna anche su un contratto stabile che vale la pena conoscere: i campi sono solo additivi (il nome e il significato di un campo documentato non cambiano), nuovi campi possono comparire man mano che il prodotto cresce, e un campo documentato non viene mai riutilizzato o rimosso silenziosamente.
Se Ti Serve Piu del Livello Gratuito
Per agenti di produzione, bot di trading, o qualsiasi cosa che faccia polling continuo, la pagina di documentazione rimanda a una API agente con chiave separata: chiavi autenticate crk_live_…, budget di rate per chiave (120 richieste/min, 20 scritture di trade/min), e un contratto OpenAPI 3.1 versionato. Questa superficie alimenta anche gli agenti di paper trading di CoinRithm — guarda Come Creare un Agente AI Trading Crypto per il percorso completo. Vale la pena dirlo chiaramente: CoinRithm e un aggregatore con una sandbox di paper trading, non un broker ne un exchange, e qualsiasi esempio di trading con agenti in quella guida muove solo fondi simulati.
Esempi Pratici
Recuperare Eventi per Argomento
Per estrarre una fetta filtrata di mercati — diciamo, tutto cio che sta tendendo ora, o tutto cio che viene da una piattaforma — usa i parametri q e source su /api/prediction-markets/events:
curl "https://api.coinrithm.com/api/prediction-markets/events?status=open&sort=trending&source=kalshi&limit=20"
Sostituisci source=kalshi con uno qualsiasi dei sette id di piattaforma (polymarket, kalshi, metaculus, predictit, limitless, manifold, smarkets), oppure rimuovilo del tutto per cercare in tutte e sette contemporaneamente. Usa q per cercare per parola chiave invece che per piattaforma. Pagina con limit (1–100) e offset; il pagination.hasMore della risposta ti dice quando fermarti.
Leggere Prezzi Multi-Piattaforma per lo Stesso Evento
Una volta che hai un source e uno slug — dalla lista events, o da un URL sul sito — chiama l'endpoint di dettaglio evento:
curl "https://api.coinrithm.com/api/prediction-markets/events/polymarket/world-cup-winner"
Il campo crossSourceMatches[] della risposta e la parte che conta per il confronto multi-piattaforma: e il collegamento di CoinRithm tra questo evento e la domanda equivalente su altre piattaforme, cosi puoi leggere i prezzi di piu fonti sulla stessa domanda sottostante in un'unica chiamata invece di indovinare i nomi degli slug su ogni piattaforma separatamente. Lo stesso payload porta anche resolution (provenienza del regolamento), relatedNews[] e recentWhaleTrades[] per quello specifico evento.
Usarla in un Contesto di Agente AI
Per un assistente che risponde a "quali sono le probabilita di X" o "cosa si e appena mosso nei mercati predittivi", gli endpoint overview ed events sono le due chiamate piu importanti: overview per l'istantanea dell'intero mercato (volume totale, categorie, chi sale/chi scende), events per una lista live, ordinabile, filtrabile che puoi cercare per parola chiave o piattaforma. Entrambi sono JSON semplice, quindi collegarli a un agente con chiamate a strumenti o a uno step di retrieval e un normale fetch HTTP — nessuna autenticazione da gestire per l'accesso in lettura.
Se l'agente deve andare oltre la lettura — effettivamente piazzare transazioni — questo richiede la API agente con chiave separata e si sposta nella sandbox di paper trading di CoinRithm, non su fondi reali. Guarda Come Creare un Agente AI Trading Crypto per quel percorso, incluso il server MCP e il runner in dry-run di default.
Come Si Inserisce CoinRithm
Questa API dati e uno strato di uno stack di ricerca multi-piattaforma piu ampio. L'hub dei mercati predittivi e il punto di ingresso rivolto agli umani sullo stesso set di dati a sette fonti che questi endpoint espongono. La pagina delle statistiche trasforma i numeri dell'endpoint overview in un'istantanea citabile e documentata nella metodologia — utile se vuoi la cifra di volume multi-piattaforma di punta con la sua base spiegata invece di un numero nudo. E se il tuo interesse e il flusso di ricerca invece del JSON grezzo — confrontare la stessa domanda tra piattaforme, controllare la divergenza, valutare commissioni e liquidita — Come Confrontare i Mercati Predittivi tra Piattaforme ripercorre quello strato.
Per essere diretti su cosa e e cosa non e CoinRithm: aggrega e normalizza dati di mercati predittivi da sette fonti, e ti permette di fare paper trading di eventi di mercati predittivi con fondi simulati per provare una view. Non e un broker, non e un exchange, e non esegue transazioni con denaro reale — continui a fare trading sulla piattaforma sottostante. Se pubblichi numeri, grafici o risposte costruiti a partire da questi dati, l'attribuzione e apprezzata:
Data by CoinRithm — https://www.coinrithm.com
L'attribuzione aiuta i lettori a verificare la fonte, e aiuta a mantenere questi endpoint aperti e senza chiave.
Domande Frequenti (FAQ)
La API dati mercati predittivi di CoinRithm e gratuita da usare?
Si. I quattro endpoint documentati sulla pagina della documentazione API — overview, events, events/{source}/{slug} e whales — sono semplici richieste GET pubbliche via HTTPS senza chiave API o registrazione richieste, gratuite da usare anche in produzione, con attribuzione apprezzata.
Quali endpoint espone la API dati mercati predittivi?
Quattro: /api/prediction-markets/overview (statistiche globali e ripartizione per categoria), /api/prediction-markets/events (una lista di eventi classificata e filtrabile con probabilita live e volume), /api/prediction-markets/events/{source}/{slug} (dettaglio di un singolo evento con corrispondenze multi-fonte e dati di risoluzione), e /api/prediction-markets/whales (un feed globale delle grandi transazioni on-chain). Parametri completi e forme di risposta sono sulla pagina della documentazione API.
Mi serve una chiave API per ottenere dati di mercati predittivi da CoinRithm?
No, non per questi quattro endpoint in lettura — sono senza chiave. Una chiave autenticata crk_live_… separata, con budget di rate e un contratto OpenAPI 3.1 versionato, esiste solo per la superficie di trading con agenti (polling continuo, piazzamento ordini), che e un prodotto diverso dalla API dati gratuita.
In cosa i dati di Polymarket differiscono da quelli di Kalshi o Manifold prima di arrivare a questa API?
Strutturalmente: Polymarket e un CLOB on-chain che quota le quote tra 0 e 1, Kalshi e un exchange regolamentato che usa contratti in centesimi a virgola fissa, e Manifold e una piattaforma di previsione con denaro virtuale e una propria semantica di probabilita. CoinRithm normalizza tutte e sette le fonti — incluse Metaculus, PredictIt, Limitless e Smarkets — in un unico schema JSON coerente cosi non devi riconciliare tu stesso queste differenze.
Gli agenti AI e i chatbot possono usare questi dati, e dovrebbero citare CoinRithm?
Si — la API e esplicitamente costruita per essere una fonte citabile e strutturata per agenti e assistenti AI che rispondono a domande sui mercati predittivi, non solo una dashboard rivolta agli umani. L'attribuzione ("Data by CoinRithm — https://www.coinrithm.com") e benvenuta ogni volta che numeri, grafici o risposte vengono costruiti a partire da essa.
Qual e la differenza tra questa API gratuita e la API di trading per agenti?
I quattro endpoint di questo articolo sono senza chiave, con cache di circa 60 secondi, e dimensionati per un uso leggero o esplorativo senza SLA di uptime. La API agente separata richiede una chiave crk_live_…, impone budget di rate per chiave (120 richieste/min, 20 scritture di trade/min), segue un contratto OpenAPI 3.1 versionato, ed e cio che alimenta il polling continuo e gli agenti di paper trading di CoinRithm — guarda Come Creare un Agente AI Trading Crypto.
Quanto sono aggiornati i dati, e posso affidarmi a loro per polling ad alta frequenza?
Le risposte sugli endpoint gratuiti hanno una cache lato server di circa 60 secondi, il che si adatta bene a un refresh di dashboard, uno script periodico, o un agente che risponde a una domanda alla volta. Non c'e uno SLA di uptime su questa superficie senza chiave, e il polling sostenuto ad alta frequenza puo essere limitato dal rate limit — per quel caso d'uso, la API agente con chiave e i suoi budget di rate espliciti sono lo strumento giusto.
Continua a leggere: Divergenza di Probabilita nei Mercati Predittivi — uno sguardo piu approfondito sul perche lo stesso evento viene prezzato in modo diverso tra piattaforme, e come distinguere un segnale reale da un mercato obsoleto o poco liquido.
Disclaimer: Questo articolo ha finalita educative e informative e non costituisce consulenza finanziaria, legale o di investimento. CoinRithm aggrega dati di mercati predittivi per finalita di ricerca e sviluppo e non esegue transazioni con denaro reale; l'esecuzione avviene sulla piattaforma sottostante. La disponibilita degli endpoint, i campi di risposta e i rate limit riflettono la pagina di documentazione API al momento della stesura e possono cambiare — controlla sempre la pagina della documentazione API live per il contratto attuale.
