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

API REST
Altro

Dettagli del mercato di previsione

GET /predictions/market

GetPredictionMarket

Regole del contratto, esiti, osservazioni della venue e soggetti collegati. I soggetti pending attendono il resolver esistente. Non viene dedotto alcun sentiment di mercato combinato.

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

Parametri

market_id string QUERY obbligatorio

ID stabile del mercato o del listing da /predictions

Example:polymarket:123

Esempio cURL

curl --get \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/predictions/market' \
  --data-urlencode 'market_id=polymarket:123' \
  --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

id

string obbligatorio

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

listings

array<object> obbligatorio

Listing delle piattaforme con regole e quotazioni mantenute separatamente.

listings[].closes_at

string (date-time) obbligatorio

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

listings[].event_id

string obbligatorio

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

listings[].id

string obbligatorio

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

listings[].liquidity_usd

number (double) obbligatorio

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

listings[].market_id

string obbligatorio

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

listings[].observed_at

string (date-time) obbligatorio

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

listings[].open_interest

number (double) obbligatorio

Contratti aperti sulla piattaforma; null quando non disponibile.

listings[].opens_at

string (date-time) obbligatorio

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

listings[].outcomes

array<object> obbligatorio

Esiti nativi ordinati con prove di prezzo indipendenti.

listings[].outcomes[].ask

number (double) obbligatorio

Ask della piattaforma come frazione da 0 a 1; null quando non disponibile.

listings[].outcomes[].bid

number (double) obbligatorio

Bid della piattaforma come frazione da 0 a 1; null quando non disponibile.

listings[].outcomes[].id

string obbligatorio

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

listings[].outcomes[].label

string obbligatorio

Etichetta dell'esito sulla piattaforma.

listings[].outcomes[].position

integer obbligatorio

Posizione dell'esito nativo, a base zero.

listings[].outcomes[].price

number (double) obbligatorio

Quotazione dell'esito come frazione da 0 a 1; null quando non disponibile. Non è sentiment social.

listings[].outcomes[].price_basis

string obbligatorio

provider, last_trade, midpoint o unavailable.

listings[].provider

string obbligatorio

Piattaforma: polymarket o kalshi.

listings[].provider_id

string obbligatorio

Identificatore nativo del mercato sulla piattaforma.

listings[].provider_updated_at

string (date-time) obbligatorio

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

listings[].question

string obbligatorio

Domanda originale del contratto.

listings[].resolution_source

string obbligatorio

Fonte della risoluzione della piattaforma, o vuota se assente.

listings[].resolves_at

string (date-time) obbligatorio

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

listings[].result

string obbligatorio

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

listings[].revision

string obbligatorio

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

listings[].rules

string obbligatorio

Regole complete di risoluzione della piattaforma.

listings[].source_url

string obbligatorio

URL originale del listing sulla piattaforma.

listings[].status

string obbligatorio

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

listings[].volume

number (double) obbligatorio

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

listings[].volume_24h

number (double) obbligatorio

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

listings[].volume_unit

string obbligatorio

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

question

string obbligatorio

Domanda originale del contratto.

subjects

array<object> obbligatorio

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

subjects[].fallback_image_urls

array<string> obbligatorio

Candidati icona di fallback ordinati come risolti dal backend.

subjects[].image_url

string obbligatorio

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

subjects[].name

string obbligatorio

Nome visualizzato canonico del soggetto.

subjects[].role

string obbligatorio

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

subjects[].status

string obbligatorio

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

subjects[].subject_id

string obbligatorio

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

subjects[].types

array<string> obbligatorio

Tipi canonici del soggetto dal resolver di identità esistente.

{
  "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": [
        {
          "ask": 0.66,
          "bid": 0.64,
          "id": "polymarket:123",
          "label": "Yes",
          "position": 0,
          "price": 0.65,
          "price_basis": "provider"
        }
      ],
      "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": [
        "string"
      ],
      "image_url": "https://example.com/nvda.png",
      "name": "NVIDIA",
      "role": "entity",
      "status": "open",
      "subject_id": "eq:NVDA",
      "types": [
        "string"
      ]
    }
  ]
}