Detalle del mercado de predicción

GET /predictions/market
GetPredictionMarket

Reglas del contrato, resultados, observaciones de la sede y sujetos vinculados. Los sujetos pendientes esperan al resolvedor existente. No se infiere sentimiento de mercado combinado.

Pago con wallet disponible en https://nebula-api.hiddensystems.ai/api/v1/x402/predictions/market. No se requiere cuenta de Nebula ni clave de API; consulta la oferta de pago antes de firmar. Guía de pago x402.

Parámetros

market_id string QUERY obligatorio

ID de mercado o listado estable de /predictions

Example:polymarket:123

Ejemplo de 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'

Respuestas

200 OK
400 Solicitud incorrecta
401 No autorizado
402 Créditos agotados; la respuesta incluye el momento de renovación y el saldo de créditos comprados
403 Prohibido
404 No encontrado
405 Método no permitido; el encabezado Allow enumera el método admitido
429 Demasiadas solicitudes
500 Error interno del servidor
503 Servicio no disponible

Tipo de medio application/json

id
string obligatorio

Identidad estable dentro de este tipo de objeto.

listings
array<object> obligatorio

Listados de plataforma con reglas y cotizaciones conservadas por separado.

listings[].closes_at
string (date-time) obligatorio

Cierre de negociación de la plataforma en UTC; no implica necesariamente la ocurrencia del evento ni su liquidación.

listings[].event_id
string obligatorio

Identificador del evento de la plataforma, o vacío si no existe.

listings[].id
string obligatorio

Identidad estable dentro de este tipo de objeto.

listings[].liquidity_usd
number (double) obligatorio

Liquidez reportada por la plataforma en dólares estadounidenses; null cuando no está disponible.

listings[].market_id
string obligatorio

Identidad canónica del mercado; los listados equivalentes de plataforma la comparten.

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

Hora UTC en que Nebula obtuvo esta cotización. Comprueba la frescura antes de comparar.

listings[].open_interest
number (double) obligatorio

Contratos abiertos de la plataforma; null cuando no está disponible.

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

Hora de apertura de la plataforma en UTC; null cuando no está disponible.

listings[].outcomes
array<object> obligatorio

Resultados nativos ordenados con evidencia de precio independiente.

listings[].outcomes[].ask
number (double) obligatorio

Ask de la plataforma como fracción de 0 a 1; null cuando no está disponible.

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

Bid de la plataforma como fracción de 0 a 1; null cuando no está disponible.

listings[].outcomes[].id
string obligatorio

Identidad estable dentro de este tipo de objeto.

listings[].outcomes[].label
string obligatorio

Etiqueta del resultado de la plataforma.

listings[].outcomes[].position
integer obligatorio

Posición del resultado nativo basada en cero.

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

Cotización del resultado como fracción de 0 a 1; null cuando no está disponible. No es sentimiento social.

listings[].outcomes[].price_basis
string obligatorio

provider, last_trade, midpoint o unavailable.

listings[].provider
string obligatorio

Plataforma: polymarket o kalshi.

listings[].provider_id
string obligatorio

Identificador nativo del mercado de la plataforma.

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

Hora de actualización de los metadatos de la plataforma; null cuando no está disponible.

listings[].question
string obligatorio

Pregunta original del contrato.

listings[].resolution_source
string obligatorio

Fuente de resolución de la plataforma, o vacío si no existe.

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

Hora prevista de resolución de la plataforma en UTC; null cuando no está disponible.

listings[].result
string obligatorio

Resultado de liquidación de la plataforma; vacío antes de un resultado conocido.

listings[].revision
string obligatorio

SHA-256 de la pregunta, las reglas, la fuente, el cierre y la orientación del resultado.

listings[].rules
string obligatorio

Reglas completas de resolución de la plataforma.

listings[].source_url
string obligatorio

URL original de la plataforma.

listings[].status
string obligatorio

Ciclo de vida del listado: open, closed, resolved o disputed. Para sujetos: resolved o pending.

listings[].volume
number (double) obligatorio

Volumen acumulado de la sede en volume_unit; null cuando no está disponible.

listings[].volume_24h
number (double) obligatorio

Volumen de la sede en las últimas 24 horas en volume_unit; null cuando no está disponible.

listings[].volume_unit
string obligatorio

usd para Polymarket, contracts para Kalshi. Estas cantidades no se pueden sumar.

question
string obligatorio

Pregunta original del contrato.

subjects
array<object> obligatorio

Sujetos vinculados. Usa sus endpoints de análisis existentes por separado; no se infiere sentimiento de mercado.

subjects[].fallback_image_urls
array<string> obligatorio

Candidatos de icono de respaldo resueltos por el backend, en orden.

subjects[].image_url
string obligatorio

Primer candidato de icono de sujeto resuelto por el backend; si está vacío, usa los de respaldo.

subjects[].name
string obligatorio

Nombre canónico de visualización del sujeto.

subjects[].role
string obligatorio

Rol del adjunto de la pregunta: entity, topic o place.

subjects[].status
string obligatorio

Ciclo de vida del listado: open, closed, resolved o disputed. Para sujetos: resolved o pending.

subjects[].subject_id
string obligatorio

Identificador canónico del sujeto en el registro; conserva la elegibilidad existente como asset o topic.

subjects[].types
array<string> obligatorio

Tipos canónicos de sujeto del resolvedor de identidad existente.

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