API Polymarket Eventi
POST
Stato di salute dell'API
- Operatività nelle ultime 24 ore
- Normale
- Buono / normale
- Disponibile
- Limitato
- Quasi del tutto inattivo
Normale
Ultime 24 ore
Ultimi 30 giorni
Cerca eventi Polymarket per parola chiave nel titolo, categoria e ordinamento, con volume, liquidità, open interest, date e fino a 10 mercati annidati in ciascun evento.
Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su polymarket e action impostato su events. Prezzo $6.81 per 1.000 richieste ($0.006806 per chiamata). Le chiamate non riuscite e i risultati vuoti non vengono addebitati. Sincrona. Per i job più lenti, aggiungi "mode": "async" al corpo della richiesta, recupera il job_id ed esegui il polling.
Prompt per l'AI
#Aiutami a scrivere uno script di raccolta dei dati con l'endpoint Polymarket Eventi di EveryInfra (polymarket/events).
Come funziona l'endpoint:
- Richiesta: POST https://api.everyinfra.com/api/v1/social con l'header Authorization: Bearer <chiave API>. Leggi la chiave dalla variabile d'ambiente EVERYINFRA_API_KEY e non scriverla mai direttamente nel codice.
- Nel corpo della richiesta imposta platform su polymarket e action su events, e inserisci i parametri in params.
- Nessun parametro obbligatorio.
- Parametri facoltativi:
- category: Categoria dell'evento per events, ad es. Crypto, Sports o Politics.
- keyword: Parole da cercare nei titoli di mercati o eventi, almeno 3 caratteri, ad es. bitcoin o election; omettilo per elencare tutto secondo l'ordinamento scelto.
- sort: Ordinamento dell'elenco. markets: volume (predefinito), open_interest, price_desc, price_asc, expiration, created, volume_1d, volume_7d, trades_1d. (valori consentiti: created / end_date / open_interest / start_date / trades_1d / volume_1d / volume_7d / volume_all_time)
- status: open (ancora negoziabile) o closed (concluso); omettilo per entrambi. (valori consentiti: closed / open)
- limit: Numero massimo di righe da restituire in questa chiamata: un intero da 1 a 100. Se lo ometti, viene applicato il valore predefinito; una chiamata può restituire meno righe. (predefinito: 20)
- Restituisce un elenco di record. Campi principali di ogni record: id (ID Polymarket del mercato o dell'evento…), slug (Nome breve del mercato o dell'evento ne…), url, title, description, tags (Tag), status (open (ancora in negoziazione) o closed…), market_count (Numero di mercati nell'evento (events)), volume_usd (Valore totale scambiato in dollari USA), liquidity_usd (Liquidità attuale dell'order book in do…), open_interest_usd (Open interest attuale in dollari USA (e…), volume_24h_usd (Valore scambiato nelle ultime 24 ore, i…); 20 campi in totale, elenco completo su https://api.everyinfra.com/api/v1/social/catalog?platform=polymarket.
- Esempio di corpo della richiesta:
{
"platform": "polymarket",
"action": "events",
"params": {}
}
- Prezzo: $6.81 per 1.000 richieste; le richieste non riuscite e i risultati vuoti non vengono addebitati.
- Per decine o centinaia di target, aggiungi "mode": "async" al corpo: ricevi subito un job_id ed esegui il polling su GET https://api.everyinfra.com/api/v1/jobs/{job_id} per ottenere il risultato.
- In caso di 422, correggi la richiesta usando i nomi dei parametri e i valori consentiti suggeriti nell'errore; in caso di 429 o 503, attendi il tempo indicato da Retry-After e riprova.
Prima di scrivere il codice, chiedimi quali target mi servono, quanti, quali campi e quale formato di output voglio; poi conferma con me il piano e il costo indicativo.Parametri della richiesta
#| Nome | Posizione | Tipo | Obbligatorio | Predefinito | Descrizione |
|---|---|---|---|---|---|
Authorization | header | string | Sì | - | Bearer seguito dalla tua chiave API. Creala nella console; non inserirla mai in un URL o in un repository di codice. |
platform | body | string | Sì | polymarket | Identificativo della piattaforma, valore fisso. |
action | body | string | Sì | events | Identificativo della funzionalità, valore fisso. |
category | body.params | string | No | - | Categoria dell'evento per events, ad es. Crypto, Sports o Politics. |
keyword | body.params | string | No | - | Parole da cercare nei titoli di mercati o eventi, almeno 3 caratteri, ad es. bitcoin o election; omettilo per elencare tutto secondo l'ordinamento scelto. |
sort | body.params | string (enum) | No | - | Ordinamento dell'elenco. markets: volume (predefinito), open_interest, price_desc, price_asc, expiration, created, volume_1d, volume_7d, trades_1d. events: created (predefinito), start_date, end_date, volume_1d, volume_7d, volume_all_time, open_interest, trades_1d.Valori consentiticreatedend_dateopen_intereststart_datetrades_1dvolume_1dvolume_7dvolume_all_time |
status | body.params | string (enum) | No | - | open (ancora negoziabile) o closed (concluso); omettilo per entrambi.Valori consentiticlosedopen |
limit | body.params | integer (1–100) | No | 20 | Numero massimo di righe da restituire in questa chiamata: un intero da 1 a 100. Se lo ometti, viene applicato il valore predefinito; una chiamata può restituire meno righe. I valori più alti restituiscono 422 prima di qualsiasi addebito. |
Esempi di codice
#bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
-H "Authorization: Bearer $EVERYINFRA_API_KEY" \
-H 'Content-Type: application/json' \
--data-raw '{
"platform": "polymarket",
"action": "events",
"params": {}
}'Definizione OpenAPI (JSON)Gli esempi leggono la chiave dalla variabile d'ambiente EVERYINFRA_API_KEY; il codice copiato non contiene mai la tua chiave.
Esempio di risposta
#Non è ancora disponibile una risposta di esempio per questi parametri. Questa anteprima mostra la struttura e i campi della risposta secondo la definizione dell'API, con … come segnaposto; non è il risultato di una chiamata reale.
json
{ "id": "req_…", "platform": "polymarket", "action": "events", "results": [ { "id": …, "slug": …, "url": …, "title": …, "description": …, "tags": …, "status": …, "market_count": …, "volume_usd": …, "liquidity_usd": …, "open_interest_usd": …, "volume_24h_usd": …, "trade_count": …, "resolution_source": …, "image_url": …, "start_at": …, "end_at": …, "closed_at": …, "created_at": …, "markets": …, "platform": … } ], "count": …, "billing": { "charged": …, "charged_usd": …, "balance_after_usd": …, … }, "quota": { … }}
Campi della risposta
#I dati di business si trovano in results. La tabella elenca i campi che un record può contenere; i valori che la piattaforma non mostra non vengono mai inventati.
| Campo | Significato |
|---|---|
id | ID Polymarket del mercato o dell'evento, come stringa. |
slug | Nome breve del mercato o dell'evento nei link di Polymarket; lo slug di un mercato funziona come market per trades. |
url | Link al record sulla piattaforma. |
title | Titolo. null quando la piattaforma non prevede titoli (ad esempio post di solo testo). |
description | Riepilogo o descrizione, di solito più breve di text. |
tags | Tag; assenti se non ce ne sono. |
status | open (ancora in negoziazione) o closed (concluso). |
market_count | Numero di mercati nell'evento (events). |
volume_usd | Valore totale scambiato in dollari USA. |
liquidity_usd | Liquidità attuale dell'order book in dollari USA. |
open_interest_usd | Open interest attuale in dollari USA (events). |
volume_24h_usd | Valore scambiato nelle ultime 24 ore, in dollari USA. |
trade_count | Scambi in totale (events). |
resolution_source | La fonte di risoluzione indicata dall'evento (events). |
image_url | Link all'immagine. Le funzionalità con più immagini possono restituire un array image_urls. |
start_at | Data e ora di inizio, ISO 8601 UTC. |
end_at | Data e ora di fine prevista, ISO 8601 UTC. |
closed_at | Data e ora effettive di chiusura, ISO 8601 UTC; assente finché è aperto. |
created_at | Data e ora di creazione, nello stesso formato di posted_at. |
markets | Mercati dell'evento (events, fino a 10), ognuno con id, condition_id, slug, title, status, outcomes e volume_usd. |
platform | Identificativo della piattaforma di origine, uguale a platform nella richiesta (ad esempio xiaohongshu, tiktok). |
Errori e addebiti
#- 401
- Chiave mancante o non valida.
- 402
- Saldo insufficiente. Effettua prima una ricarica.
- 422
- Nome o valore del parametro non valido. Correggilo seguendo i suggerimenti dell'errore. Nessun addebito.
- 429
- Raggiunto il limite di richieste al minuto. Attendi il tempo indicato da Retry-After, poi riprova.
- 503
- Impossibile completare. L'importo trattenuto torna sul tuo saldo. Se l'esito è incerto, verificalo prima di riprovare.
- Risposta 200 vuota
- Nessun dato. Nessun addebito.