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

Mindshare

GET /mindshare
GetMindshare

La cuota de conversación de un activo o sujeto: sus publicaciones en las últimas 24 horas como fracción de todas las publicaciones de su mercado (acciones, cripto, o personas y temas), de 0 a 1. Envía clusters para medir la cuota dentro de uno o más grupos de autores.

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/mindshare. 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:720

granularity string QUERY

Tamaño de bucket de serie temporal solicitado. Si se omite, el servicio elige un tamaño de bucket adecuado para la ventana de lookback.

Valores permitidos
1h2h4h12h1d

Example:1h

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

Example:smart_money

Ejemplo de cURL

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

series
array<object> obligatorio

Observaciones ordenadas cronológicamente.
series[].share
number (double) obligatorio

Cuota de atención social elegible como fracción decimal de 0 a 1.

series[].timestamp
string (date-time) obligatorio

Marca de tiempo UTC en formato RFC 3339 para la observación o el inicio del bucket.

{
  "series": [
    {
      "share": 0.148,
      "timestamp": "2026-08-07T15:00:00Z"
    }
  ]
}