Tutta la documentazione Documentazione di Nebula Tutti gli endpoint Documentazione interattiva Markdown JSON OpenAPI

API REST
Altro

Mercati di previsione

GET /predictions

ListPredictionMarkets

Consulta i contratti di Polymarket e Kalshi. I prezzi sono probabilità di esito riportate da ciascuna piattaforma, non sentiment social. Il volume mantiene l'unità della piattaforma. I contratti equivalenti condividono un mercato; i contratti correlati restano separati. Le metriche dei soggetti usano gli endpoint esistenti per soggetti e asset.

Pagamento con wallet disponibile su https://nebula-api.hiddensystems.ai/api/v1/x402/predictions. Non sono richiesti un account Nebula o una chiave API; controlla l'offerta di pagamento prima di firmare. Guida al pagamento x402.

Parametri

query string QUERY

Ricerca senza distinzione tra maiuscole e minuscole su identificatori pubblici e nomi.

Example:NVIDIA

provider string QUERY

Piattaforma opzionale

Valori consentiti

polymarketkalshi

Example:polymarket

status string QUERY

Il valore predefinito è open

Valori consentiti

openclosedresolveddisputedall

Default:open

subject_id string QUERY

Identificatore canonico non relativo a un asset restituito da /subjects o /search, ad esempio text:jensen huang o handle:elonmusk. Accettato in qualsiasi combinazione di maiuscole e minuscole. Non può essere combinato con asset_id o asset_class.

Example:text:jensen huang

limit integer QUERY

Numero massimo di risultati restituiti.

Default:25

offset integer QUERY

Offset di paginazione

Default:0

Esempio cURL

curl --request GET \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/predictions' \
  --header 'X-API-Key: YOUR_API_KEY'

Risposte

200 OK

400 Richiesta non valida

401 Non autorizzato

402 Crediti esauriti; la risposta include i tempi di rinnovo e il saldo dei crediti acquistati

403 Vietato

404 Non trovato

405 Metodo non consentito; l'header Allow elenca il metodo supportato

429 Troppe richieste

500 Errore interno del server

503 Servizio non disponibile

Tipo di media application/json

has_more

boolean obbligatorio

True quando è disponibile un'altra pagina dopo i record restituiti.

limit

integer obbligatorio

Numero massimo di record richiesti.

markets

array<object> obbligatorio

Mercati canonici, ordinati per miglior rango di attività all'interno di ciascuna piattaforma. I volumi delle piattaforme non vengono sommati.

markets[].id

string obbligatorio

Identità stabile all'interno di questo tipo di oggetto.

markets[].listings

array<object> obbligatorio

Listing delle piattaforme con regole e quotazioni mantenute separatamente.

markets[].listings[].closes_at

string (date-time) obbligatorio

Chiusura del trading sulla piattaforma in UTC; non coincide necessariamente con l'evento o il settlement.

markets[].listings[].event_id

string obbligatorio

Identificatore dell'evento sulla piattaforma, o vuoto se assente.

markets[].listings[].id

string obbligatorio

Identità stabile all'interno di questo tipo di oggetto.

markets[].listings[].liquidity_usd

number (double) obbligatorio

Liquidità riportata dalla piattaforma in dollari USA; null quando non disponibile.

markets[].listings[].market_id

string obbligatorio

Identità canonica del mercato; i listing equivalenti delle piattaforme la condividono.

markets[].listings[].observed_at

string (date-time) obbligatorio

Ora UTC in cui Nebula ha recuperato questa quotazione. Controlla la freschezza prima di confrontare.

markets[].listings[].open_interest

number (double) obbligatorio

Contratti aperti sulla piattaforma; null quando non disponibile.

markets[].listings[].opens_at

string (date-time) obbligatorio

Ora di apertura della piattaforma in UTC; null quando non disponibile.

markets[].listings[].outcomes

array<object> obbligatorio

Esiti nativi ordinati con prove di prezzo indipendenti.

markets[].listings[].provider

string obbligatorio

Piattaforma: polymarket o kalshi.

markets[].listings[].provider_id

string obbligatorio

Identificatore nativo del mercato sulla piattaforma.

markets[].listings[].provider_updated_at

string (date-time) obbligatorio

Ora di aggiornamento dei metadati della piattaforma; null quando non disponibile.

markets[].listings[].question

string obbligatorio

Domanda originale del contratto.

markets[].listings[].resolution_source

string obbligatorio

Fonte della risoluzione della piattaforma, o vuota se assente.

markets[].listings[].resolves_at

string (date-time) obbligatorio

Ora prevista di risoluzione della piattaforma in UTC; null quando non disponibile.

markets[].listings[].result

string obbligatorio

Esito del settlement della piattaforma; vuoto prima di un esito noto.

markets[].listings[].revision

string obbligatorio

SHA-256 of question, rules, source, close and outcome orientation.

markets[].listings[].rules

string obbligatorio

Regole complete di risoluzione della piattaforma.

markets[].listings[].source_url

string obbligatorio

URL originale del listing sulla piattaforma.

markets[].listings[].status

string obbligatorio

Ciclo di vita del listing: open, closed, resolved o disputed. Per i soggetti: resolved o pending.

markets[].listings[].volume

number (double) obbligatorio

Volume cumulativo della venue in volume_unit; null quando non disponibile.

markets[].listings[].volume_24h

number (double) obbligatorio

Volume della venue nelle ultime 24 ore in volume_unit; null quando non disponibile.

markets[].listings[].volume_unit

string obbligatorio

usd per Polymarket, contracts per Kalshi. Queste quantità non possono essere sommate.

markets[].question

string obbligatorio

Domanda originale del contratto.

markets[].subjects

array<object> obbligatorio

Soggetti collegati. Usa separatamente i loro endpoint di analisi esistenti; non viene dedotto alcun sentiment di mercato.

markets[].subjects[].fallback_image_urls

array<string> obbligatorio

Candidati icona di fallback ordinati come risolti dal backend.

markets[].subjects[].image_url

string obbligatorio

Primo candidato icona del soggetto risolto dal backend; se vuoto usa i fallback.

markets[].subjects[].name

string obbligatorio

Nome visualizzato canonico del soggetto.

markets[].subjects[].role

string obbligatorio

Ruolo dell'allegato della domanda: entity, topic o place.

markets[].subjects[].status

string obbligatorio

Ciclo di vita del listing: open, closed, resolved o disputed. Per i soggetti: resolved o pending.

markets[].subjects[].subject_id

string obbligatorio

Identificatore canonico del soggetto nel registro; preserva l'idoneità esistente come asset o topic.

markets[].subjects[].types

array<string> obbligatorio

Tipi canonici del soggetto dal resolver di identità esistente.

offset

integer obbligatorio

Numero di record corrispondenti saltati.

{
  "has_more": false,
  "limit": 50,
  "markets": [
    {
      "id": "polymarket:123",
      "listings": [
        {
          "closes_at": "2026-10-07T20:00:00Z",
          "event_id": "event-123",
          "id": "polymarket:123",
          "liquidity_usd": 5000,
          "market_id": "polymarket:123",
          "observed_at": "2026-10-06T12:00:00Z",
          "open_interest": 100,
          "opens_at": "2026-10-01T00:00:00Z",
          "outcomes": [],
          "provider": "polymarket",
          "provider_id": "123",
          "provider_updated_at": "2026-10-06T12:00:00Z",
          "question": "Will NVIDIA close above $200 on October 7?",
          "resolution_source": "Official exchange close",
          "resolves_at": "2026-10-08T00:00:00Z",
          "result": "yes",
          "revision": "revision-hash",
          "rules": "Resolves Yes if the official closing price exceeds $200.",
          "source_url": "https://polymarket.com/event/example",
          "status": "open",
          "volume": 10000,
          "volume_24h": 1000,
          "volume_unit": "usd"
        }
      ],
      "question": "Will NVIDIA close above $200 on October 7?",
      "subjects": [
        {
          "fallback_image_urls": [],
          "image_url": "https://example.com/nvda.png",
          "name": "NVIDIA",
          "role": "entity",
          "status": "open",
          "subject_id": "eq:NVDA",
          "types": []
        }
      ]
    }
  ],
  "offset": 0
}