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

Mayor tendencia

GET /top-trending
GetTopTrending

Los activos o sujetos con mayor cuota de conversación durante las últimas 24 horas, ordenados de mayor a menor, con la variación respecto a las 24 horas anteriores.

La cuota es la fracción de todas las publicaciones del mismo mercado durante esas mismas 24 horas (acciones, cripto, o personas y temas), excluidos los bots; con clusters, es la cuota de lo que publicaron esos clusters.

Reglas de los parámetros:

  • asset_class se aplica solo a kind=asset.
  • Las comunidades de publicación como wallstreetbets solo se aceptan para kind=asset con asset_class equity, commodity o index.

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

kind string QUERY

Qué clasificar: asset (acciones, materias primas, índices o cripto) o subject (personas, cuentas y temas). Por defecto, asset.

Valores permitidos
assetsubject

Default:asset

asset_class string QUERY

Con kind=asset, el mercado que se va a clasificar: equity (el valor por defecto), commodity, index o crypto.

Valores permitidos
equitycommodityindexcrypto

Default:equity

clusters array<string> QUERY

Clusters de autores que se van a leer; repite para combinarlos, por ejemplo clusters=kols&clusters=media. Los clusters seleccionados se suman, y un autor puede pertenecer a varios.

  • Callers: smart_money (los de mejor rendimiento), dumb_money (los de peor rendimiento), top_degens (los mejores en cripto de pequeña capitalización)
  • Timing: early_movers (los primeros en hablar de un activo cuando la atención aumenta), late_movers (llegan al pico o después)
  • Builders: developers, founders, team_leaders, project_accounts
  • Instituciones: vcs, asset_managers, dao_guild_funds, incubators, exchanges
  • Influencia: kols, celebrities, media, marketer, shiller
  • Analistas: ta_analyst, fa_analyst, macro_analyst, onchain_analyst, investigators
  • Traders: position_trader, swing_trader, day_trader
  • Sesgo: perma_bull, doomer, tribalist
  • Otros: political, nft, bots, automated_ai
  • Comunidades, según dónde se hizo la publicación: wallstreetbets, reddit

Example:smart_money

limit integer QUERY

Número máximo de resultados devueltos.

Default:25

Ejemplo de cURL

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

asset_class
string opcional

El mercado cuyos activos se clasificaron; ausente para los subjects.

clusters
array<string> obligatorio

Los clústeres de autores cuyas publicaciones se contaron, canonicalizados; vacío cuando se contaron todos los autores excepto los bots.

from
string (date-time) obligatorio

Inicio en UTC de las 24 horas clasificadas. La ventana de comparación son las 24 horas anteriores a ese inicio.

kind
string obligatorio

Qué se clasificó: asset o subject, según lo solicitado.

Valores permitidos
assetsubject
previous_total_posts
integer (int64) obligatorio

Todas las publicaciones de la población clasificada durante las 24 horas anteriores.

results
array<object> obligatorio

Resultados clasificados, del mejor al primero.
results[].asset_class
string opcional

Clase del activo: equity (acciones y ETF), commodity, index o crypto. Envíala junto con asset_id en cada solicitud con alcance de asset.

Valores permitidos
equitycommodityindexcrypto
results[].asset_id
string opcional

Identificador público canónico del activo: el ticker o símbolo de mercado para acciones, commodities e índices, y el slug de CoinGecko (o, si no lo hay, un id numérico) para crypto.

results[].bearish_posts
integer (int64) obligatorio

Publicaciones clasificadas como bearish.

results[].bullish_posts
integer (int64) obligatorio

Publicaciones clasificadas como bullish.

results[].kind
string obligatorio

Qué es el resultado: asset (consúltalo con asset_id y asset_class) o subject (consúltalo con subject_id).

Valores permitidos
assetsubject
results[].name
string obligatorio

Nombre legible para personas.

results[].neutral_posts
integer (int64) obligatorio

Publicaciones clasificadas como neutral.

results[].posts
integer (int64) obligatorio

Las publicaciones de este resultado durante las 24 horas clasificadas.

results[].previous_posts
integer (int64) obligatorio

Las publicaciones de este resultado en la ventana inmediatamente anterior de igual duración.

results[].price_change_24h_pct
number (double) opcional

Cambio bruto del precio de mercado en 24 horas, en puntos porcentuales.

results[].share
number (double) obligatorio

Las publicaciones de este resultado como fracción de todas las publicaciones de la población clasificada durante las mismas 24 horas, de 0 a 1.

results[].share_change
number (double) opcional

Cambio de la cuota respecto a la ventana anterior, como fracción decimal: 0.01 es un punto porcentual. Ausente solo cuando la población no tenía publicaciones en la ventana anterior.

results[].share_change_pct
number (double) opcional

El cambio de la cuota con respecto a la cuota de la ventana anterior, en porcentaje. Ausente cuando el resultado no tenía publicaciones en la ventana anterior.

results[].subject_id
string opcional

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

results[].symbol
string opcional

Ticker o símbolo de mercado para mostrar.

to
string (date-time) obligatorio

Fin en UTC de las 24 horas clasificadas: cuándo se calculó la clasificación.

total_posts
integer (int64) obligatorio

Todas las publicaciones de la población clasificada durante las 24 horas: el denominador de la cuota.

{
  "asset_class": "equity",
  "clusters": [],
  "from": "2026-08-06T15:00:00Z",
  "kind": "asset",
  "previous_total_posts": 17205,
  "results": [
    {
      "asset_class": "equity",
      "asset_id": "NVDA",
      "bearish_posts": 61,
      "bullish_posts": 214,
      "kind": "asset",
      "name": "NVIDIA Corporation",
      "neutral_posts": 111,
      "posts": 386,
      "previous_posts": 273,
      "price_change_24h_pct": -2.48,
      "share": 0.025255,
      "share_change": 0.009388,
      "share_change_pct": 59.16,
      "symbol": "NVDA"
    },
    {
      "asset_class": "equity",
      "asset_id": "AMZN",
      "bearish_posts": 30,
      "bullish_posts": 92,
      "kind": "asset",
      "name": "Amazon.com, Inc.",
      "neutral_posts": 63,
      "posts": 185,
      "previous_posts": 165,
      "price_change_24h_pct": -0.32,
      "share": 0.012104,
      "share_change": 0.002516,
      "share_change_pct": 26.24,
      "symbol": "AMZN"
    }
  ],
  "to": "2026-08-07T15:00:00Z",
  "total_posts": 15284
}