API

Gli stessi dati di questa dashboard, via endpoint JSON. L'accesso richiede una API key: le richieste senza chiave ricevono 401.

Autenticazione

# Header (recommended)
curl -H "Authorization: Bearer <API_KEY>" \
  "https://trackerpoly.com/api/polymarket/events?order=volume24hr&limit=5"

# Or as a query parameter
curl "https://trackerpoly.com/api/polymarket/events?limit=5&api_key=<API_KEY>"

Base URL: https://trackerpoly.com. Ogni chiave ha un rate limit al minuto in base al piano; superarlo restituisce 429 con Retry-After. Per i WebSocket/browser puoi scambiare la chiave con un JWT a vita breve via POST /api/auth/token e passarlo come ?token=.

Ottieni una API key

Le chiavi sono rilasciate manualmente. Scrivici su Telegram indicando il tuo caso d'uso e il volume di richieste previsto:

Richiedi una chiave su Telegram

Piani: Starter 300 req/min (promo, prima 60) · Pro 600 req/min · Enterprise 6.000 req/min. Le risposte includono gli header X-Api-Tier e X-RateLimit-Limit.

Eventi e mercati

GET/api/polymarket/stats

Snapshot globale: eventi/mercati attivi, volume 24h, liquidità.

GET/api/polymarket/categories

Categorie con conteggio eventi, volume 24h e liquidità.

GET/api/polymarket/events

Eventi attivi, ordinabili, filtrabili e cercabili per titolo.

?category= &order=volume24hr|volume|liquidity &q= &limit= &offset=

GET/api/polymarket/events/{slug}

Un evento con tutti i mercati e le probabilità correnti degli esiti.

GET/api/polymarket/events/{slug}/changes

Variazione di probabilità per esito su una finestra.

?window=1h|24h|7d|30d

Movimenti e whales

GET/api/polymarket/movers

I maggiori spostamenti di probabilità su tutti i mercati.

?window=1m…7d &limit=

GET/api/polymarket/abnormal

Trade anomali (insolitamente grandi per il loro mercato).

GET/api/polymarket/whales

Le posizioni aperte più grandi con prezzo di ingresso e identità.

?limit=

GET/api/polymarket/trades

Nastro globale dei trade live.

?min_usd= &limit=

GET/api/polymarket/live

Ultimi tick di prezzo per il feed live.

Dati live per mercato (proxy diretto Polymarket)

GET/api/polymarket/markets/{id}/holders-live

Maggiori holder per esito, letti live da Polymarket per qualsiasi mercato.

?limit=20

GET/api/polymarket/markets/{id}/activity-live

Holder + ultimi trade di un mercato in una sola chiamata.

?holders_limit= &trades_limit=

GET/api/polymarket/events/{slug}/activity-live

Feed live dei trade su tutti i mercati di un evento, filtrabile.

?side=BUY|SELL &min_usd= &limit=

GET/api/polymarket/events/{slug}/history-live

Storico prezzi completo per i mercati principali (una serie per mercato), direttamente dal CLOB.

?interval=1h|6h|1d|1w|1m|max &markets=5

GET/api/polymarket/markets/{id}/history

Storico prezzi campionato in-house per un mercato.

?window=24h|7d|30d

UMA oracle

GET/api/uma/summary

Panoramica oracolo: richieste pendenti/disputate, round attivo.

GET/api/uma/disputes

Assertion disputate con titoli in chiaro e stato del ciclo di vita.

GET/api/uma/rounds

Round di voto con conteggio dei reveal.

GET/api/uma/voters

Maggiori staker letti on-chain dal contratto VotingV2.

?limit=

Note operative

Le risposte sono cacheate lato server (10–90s per gli endpoint *-live): non serve interrogare più spesso della cache. Gli endpoint *-live proxano Polymarket in tempo reale; gli altri leggono lo storico campionato in-house. Per volumi oltre il tuo piano o feed dedicati, contattaci via Telegram.