API Polymarket Mercati

POST

Stato di salute dell'API

Operatività nelle ultime 24 ore: Normale

Buono / normale
Disponibile
Limitato
Quasi del tutto inattivo

Ultime 24 ore

Ultimi 30 giorni

Cerca mercati Polymarket per parola chiave nel titolo e ordinamento, con prezzi degli esiti, volume, liquidità, attività recente, esito e l'evento padre di ciascun mercato.

Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su polymarket e action impostato su markets. 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 Mercati di EveryInfra (polymarket/markets).

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 markets, e inserisci i parametri in params.
- Nessun parametro obbligatorio.
- Parametri facoltativi:
  - 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 / expiration / open_interest / price_asc / price_desc / trades_1d / volume / volume_1d)
  - 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…), condition_id (Il condition ID on-chain del mercato (0…), slug (Nome breve del mercato o dell'evento ne…), url, title, description, status (open (ancora in negoziazione) o closed…), winning_outcome (Il lato vincente di un mercato risolto,…), outcomes (Gli esiti che puoi acquistare, ognuno c…), volume_usd (Valore totale scambiato in dollari USA), liquidity_usd (Liquidità attuale dell'order book in do…), volume_24h_usd (Valore scambiato nelle ultime 24 ore, i…); 23 campi in totale, elenco completo su https://api.everyinfra.com/api/v1/social/catalog?platform=polymarket.
- Esempio di corpo della richiesta:
{
  "platform": "polymarket",
  "action": "markets",
  "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ì	`markets`	Identificativo della funzionalità, valore fisso.
`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 consentiti`createdexpirationopen_interestprice_ascprice_desctrades_1dvolumevolume_1dvolume_7d`
`status`	body.params	`string (enum)`	No	-	open (ancora negoziabile) o closed (concluso); omettilo per entrambi.Valori consentiti`closedopen`
`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": "markets",
  "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

json

{  "id": "req_…",  "platform": "polymarket",  "action": "markets",  "results": [    {      "id": …,      "condition_id": …,      "slug": …,      "url": …,      "title": …,      "description": …,      "status": …,      "winning_outcome": …,      "outcomes": …,      "volume_usd": …,      "liquidity_usd": …,      "volume_24h_usd": …,      "volume_7d_usd": …,      "trades_24h": …,      "tags": …,      "event_id": …,      "event_slug": …,      "event_title": …,      "image_url": …,      "start_at": …,      "end_at": …,      "closed_at": …,      "created_at": …,      "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.
`condition_id`	Il condition ID on-chain del mercato (0x...); passalo come `market` a trades.
`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.
`status`	open (ancora in negoziazione) o closed (concluso).
`winning_outcome`	Il lato vincente di un mercato risolto, ad esempio Yes; assente prima della risoluzione.
`outcomes`	Gli esiti che puoi acquistare, ognuno con label, token_id e price (da 0 a 1, interpretabile come la probabilità implicita del mercato; 1 per l'esito vincente dopo la risoluzione).
`volume_usd`	Valore totale scambiato in dollari USA.
`liquidity_usd`	Liquidità attuale dell'order book in dollari USA.
`volume_24h_usd`	Valore scambiato nelle ultime 24 ore, in dollari USA.
`volume_7d_usd`	Valore scambiato negli ultimi 7 giorni, in dollari USA (markets).
`trades_24h`	Scambi nelle ultime 24 ore (markets).
`tags`	Tag; assenti se non ce ne sono.
`event_id`	ID dell'evento padre (markets).
`event_slug`	Nome breve dell'evento padre (markets).
`event_title`	Titolo dell'evento padre (markets).
`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.
`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.

Errori