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

Temas relacionados

GET /related-subjects
GetRelatedSubjects

Las personas, cuentas y temas que se mencionan con más frecuencia en las mismas publicaciones que un activo o asunto. share son las publicaciones compartidas como fracción de las publicaciones del ancla; los campos de sentimiento son el sentimiento del ancla dentro de esas publicaciones compartidas.

Reglas de los parámetros:

  • Envía asset_id o subject_id.
  • asset_id debe enviarse junto con asset_class.
  • subject_id no puede combinarse con asset_id ni con asset_class.

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

asset_id string QUERY

ID del activo de /assets o /search, como NVDA, GLD, SPX o bitcoin. Envíalo junto con el asset_class que se devolvió con él.

Example:NVDA

asset_class string QUERY

Clase del activo nombrado por asset_id: equity (acciones y ETF), commodity, index o crypto. Envía el asset_class que /assets o /search devolvió junto con el asset_id.

Valores permitidos
equitycommodityindexcrypto

Example:equity

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

hours integer QUERY

Ventana de retroceso en horas. Los planes gratuitos llegan hasta 90 días; más allá devuelve 403.

Default:168

limit integer QUERY

Número máximo de resultados devueltos.

Default:25

Ejemplo de cURL

curl --get \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/related-subjects' \
  --data-urlencode 'asset_id=NVDA' \
  --data-urlencode 'asset_class=equity' \
  --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

authors
integer (int64) obligatorio

Autores distintos representados por las publicaciones coincidentes.

average_sentiment_score
number (double) obligatorio

Puntuación de sentimiento media de todas las publicaciones del ancla en la ventana solicitada.

from
string (date-time) obligatorio

Inicio inclusivo en UTC de la ventana medida.

hours
integer obligatorio

Ventana de lookback representada por la respuesta, en horas.

posts
integer (int64) obligatorio

Recuento de publicaciones coincidentes en la ventana solicitada.

subjects
array<object> obligatorio

Asuntos que no son activos devueltos por la operación de descubrimiento.
subjects[].authors
integer (int64) obligatorio

Autores distintos representados por las publicaciones coincidentes.

subjects[].bearish_posts
integer (int64) obligatorio

Publicaciones clasificadas como bearish.

subjects[].bullish_posts
integer (int64) obligatorio

Publicaciones clasificadas como bullish.

subjects[].first_post_at
string (date-time) opcional

Hora UTC de la primera publicación coincidente en la ventana solicitada.

subjects[].last_post_at
string (date-time) opcional

Hora UTC de la publicación coincidente más reciente en la ventana solicitada.

subjects[].name
string obligatorio

Nombre legible para personas.

subjects[].neutral_posts
integer (int64) obligatorio

Publicaciones clasificadas como neutral.

subjects[].posts
integer (int64) obligatorio

Recuento de publicaciones coincidentes en la ventana solicitada.

subjects[].posts_delta
number (double) obligatorio

Cambio fraccional de posts_prior a posts_recent; los valores positivos indican crecimiento.

subjects[].posts_prior
integer (int64) obligatorio

Publicaciones coincidentes en la primera mitad de la ventana solicitada.

subjects[].posts_recent
integer (int64) obligatorio

Publicaciones coincidentes en la segunda mitad de la ventana solicitada.

subjects[].sentiment_delta
number (double) obligatorio

Diferencia entre sentiment_score para la conversación compartida y la media de la ventana completa del ancla.

subjects[].sentiment_score
number (double) obligatorio

Puntuación de sentimiento con signo; positivo es alcista y negativo es bajista.

subjects[].share
number (double) obligatorio

Publicaciones del ancla que también mencionan este asunto como fracción decimal de todas las publicaciones del ancla en la ventana.

subjects[].subject_id
string obligatorio

Identificador canónico de una persona, cuenta o tema que no es un activo.

to
string (date-time) obligatorio

Fin exclusivo en UTC de la ventana medida.

{
  "authors": 241,
  "average_sentiment_score": 36.2,
  "from": "2026-08-15T09:00:00Z",
  "hours": 168,
  "posts": 684,
  "subjects": [
    {
      "authors": 73,
      "bearish_posts": 41,
      "bullish_posts": 112,
      "first_post_at": "2026-08-15T09:00:00Z",
      "last_post_at": "2026-08-22T08:45:00Z",
      "name": "Artificial Intelligence",
      "neutral_posts": 31,
      "posts": 184,
      "posts_delta": 0.556,
      "posts_prior": 72,
      "posts_recent": 112,
      "sentiment_delta": 8.4,
      "sentiment_score": 42.6,
      "share": 0.148,
      "subject_id": "text:artificial intelligence"
    }
  ],
  "to": "2026-08-22T09:00:00Z"
}