Toda la documentación Documentación de Nebula Todos los endpoints Documentación interactiva Markdown JSON de OpenAPI
  1. API REST
  2. Otros

Mercados de predicción

GET /predictions
ListPredictionMarkets

Explora los contratos de Polymarket y Kalshi. Los precios son probabilidades de resultado de cada plataforma, no sentimiento social. El volumen conserva su unidad de plataforma. Los contratos equivalentes comparten un mercado; los contratos relacionados permanecen separados. Las métricas de sujetos usan los endpoints de sujetos y activos existentes.

Pago con wallet disponible en https://nebula-api.hiddensystems.ai/api/v1/x402/predictions. 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

query string QUERY

Búsqueda sin distinción de mayúsculas y minúsculas en identificadores públicos y nombres.

Example:NVIDIA

provider string QUERY

Plataforma opcional

Valores permitidos
polymarketkalshi

Example:polymarket

status string QUERY

El valor predeterminado es open

Valores permitidos
openclosedresolveddisputedall

Default:open

subject_id string QUERY

Identificador canónico que no corresponde a un activo y que devuelven /subjects o /search, como text:jensen huang o handle:elonmusk. Se acepta en cualquier combinación de mayúsculas y minúsculas. No puede combinarse con asset_id ni con asset_class.

Example:text:jensen huang

limit integer QUERY

Número máximo de resultados devueltos.

Default:25

offset integer QUERY

Desplazamiento de paginación

Default:0

Ejemplo de cURL

curl --request GET \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/predictions' \
  --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

has_more
boolean obligatorio

True cuando hay otra página disponible después de los registros devueltos.

limit
integer obligatorio

Número máximo de registros solicitados.

markets
array<object> obligatorio

Mercados canónicos, ordenados por el mejor rango de actividad dentro de cada plataforma. Los volúmenes de las plataformas no se suman.
markets[].id
string obligatorio

Identidad estable dentro de este tipo de objeto.

markets[].listings
array<object> obligatorio

Listados de plataforma con reglas y cotizaciones conservadas por separado.
markets[].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.

markets[].listings[].event_id
string obligatorio

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

markets[].listings[].id
string obligatorio

Identidad estable dentro de este tipo de objeto.

markets[].listings[].liquidity_usd
number (double) obligatorio

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

markets[].listings[].market_id
string obligatorio

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

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

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

markets[].listings[].open_interest
number (double) obligatorio

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

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

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

markets[].listings[].outcomes
array<object> obligatorio

Resultados nativos ordenados con evidencia de precio independiente.

markets[].listings[].provider
string obligatorio

Plataforma: polymarket o kalshi.

markets[].listings[].provider_id
string obligatorio

Identificador nativo del mercado de la plataforma.

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

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

markets[].listings[].question
string obligatorio

Pregunta original del contrato.

markets[].listings[].resolution_source
string obligatorio

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

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

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

markets[].listings[].result
string obligatorio

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

markets[].listings[].revision
string obligatorio

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

markets[].listings[].rules
string obligatorio

Reglas completas de resolución de la plataforma.

markets[].listings[].source_url
string obligatorio

URL original de la plataforma.

markets[].listings[].status
string obligatorio

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

markets[].listings[].volume
number (double) obligatorio

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

markets[].listings[].volume_24h
number (double) obligatorio

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

markets[].listings[].volume_unit
string obligatorio

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

markets[].question
string obligatorio

Pregunta original del contrato.

markets[].subjects
array<object> obligatorio

Sujetos vinculados. Usa sus endpoints de análisis existentes por separado; no se infiere sentimiento de mercado.
markets[].subjects[].fallback_image_urls
array<string> obligatorio

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

markets[].subjects[].image_url
string obligatorio

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

markets[].subjects[].name
string obligatorio

Nombre canónico de visualización del sujeto.

markets[].subjects[].role
string obligatorio

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

markets[].subjects[].status
string obligatorio

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

markets[].subjects[].subject_id
string obligatorio

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

markets[].subjects[].types
array<string> obligatorio

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

offset
integer obligatorio

Número de registros coincidentes omitidos.

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