All docs Nebula docs All endpoints Interactive docs Markdown OpenAPI JSON
  1. REST API
  2. Other

Prediction market detail

GET /predictions/market
GetPredictionMarket

Contract rules, outcomes, venue observations and linked subjects. Pending subjects await the existing resolver. No combined market sentiment is inferred.

Wallet payment available at https://nebula-api.hiddensystems.ai/api/v1/x402/predictions/market. No Nebula account or API key required; check the payment offer before signing. x402 payment guide.

Parameters

market_id string QUERY required

Stable market or listing ID from /predictions

Example:polymarket:123

cURL Example

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'

Responses

200 OK
400 Bad Request
401 Unauthorized
402 Credits used up; response includes renewal timing and purchased credit balance
403 Forbidden
404 Not Found
405 Method not allowed; the Allow header lists the supported method
429 Too Many Requests
500 Internal Server Error
503 Service Unavailable

Media type application/json

id
string required

Stable identity within this object type.

listings
array<object> required

Venue listings with separately retained rules and quotes.
listings[].closes_at
string (date-time) required

Venue trading close in UTC; not necessarily event occurrence or settlement.

listings[].event_id
string required

Venue event identifier, or empty if absent.

listings[].id
string required

Stable identity within this object type.

listings[].liquidity_usd
number (double) required

Venue-reported liquidity in US dollars; null when unavailable.

listings[].market_id
string required

Canonical market identity; equivalent venue listings share it.

listings[].observed_at
string (date-time) required

UTC time Nebula fetched this quote. Inspect freshness before comparing.

listings[].open_interest
number (double) required

Venue open contracts; null when unavailable.

listings[].opens_at
string (date-time) required

Venue opening time in UTC; null when unavailable.

listings[].outcomes
array<object> required

Ordered native outcomes with independent price evidence.
listings[].outcomes[].ask
number (double) required

Venue ask as a fraction from 0 to 1; null when unavailable.

listings[].outcomes[].bid
number (double) required

Venue bid as a fraction from 0 to 1; null when unavailable.

listings[].outcomes[].id
string required

Stable identity within this object type.

listings[].outcomes[].label
string required

Venue outcome label.

listings[].outcomes[].position
integer required

Zero-based native outcome position.

listings[].outcomes[].price
number (double) required

Outcome quote as a fraction from 0 to 1; null when unavailable. Not subject sentiment.

listings[].outcomes[].price_basis
string required

provider, last_trade, midpoint or unavailable.

listings[].provider
string required

Venue: polymarket or kalshi.

listings[].provider_id
string required

Native venue market identifier.

listings[].provider_updated_at
string (date-time) required

Venue metadata update time; null when unavailable.

listings[].question
string required

Original contract question.

listings[].resolution_source
string required

Venue resolution source, or empty if absent.

listings[].resolves_at
string (date-time) required

Venue expected resolution time in UTC; null when unavailable.

listings[].result
string required

Venue settlement result; empty before a known result.

listings[].revision
string required

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

listings[].rules
string required

Full venue resolution rules.

listings[].source_url
string required

Original venue listing URL.

listings[].status
string required

Listing lifecycle: open, closed, resolved or disputed. For subjects: resolved or pending.

listings[].volume
number (double) required

Cumulative venue volume in volume_unit; null when unavailable.

listings[].volume_24h
number (double) required

Last 24-hour venue volume in volume_unit; null when unavailable.

listings[].volume_unit
string required

usd for Polymarket, contracts for Kalshi. These quantities cannot be added.

question
string required

Original contract question.

subjects
array<object> required

Linked subjects. Use their existing analytics endpoints separately; no market sentiment is inferred.
subjects[].fallback_image_urls
array<string> required

Ordered backend-resolved fallback icon candidates.

subjects[].image_url
string required

First backend-resolved subject icon candidate; empty uses fallbacks.

subjects[].name
string required

Canonical subject display name.

subjects[].role
string required

Question attachment role: entity, topic or place.

subjects[].status
string required

Listing lifecycle: open, closed, resolved or disputed. For subjects: resolved or pending.

subjects[].subject_id
string required

Canonical registry subject identifier; preserves existing asset or topic eligibility.

subjects[].types
array<string> required

Canonical subject types from the existing identity resolver.

{
  "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"
      ]
    }
  ]
}