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

Distribución de resultados de las llamadas

GET /calls/returns
GetCallReturns

Cómo se han comportado las llamadas recientes: tasa de acierto, rentabilidad mediana y media, y la distribución de las rentabilidades. Cada llamada se puntúa según el movimiento del precio durante las 24 horas posteriores, desde el lado de quien la hace, de modo que una llamada corta ante una caída del 10% es +10%. Envía clusters para comparar grupos, por ejemplo smart_money frente a dumb_money.

Reglas de los parámetros:

  • Envía asset_class y asset_id juntos, o ninguno de los dos.

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

resolved_days integer QUERY

Cuántos días de llamadas resueltas incluir: llamadas cuyo hito de 24 horas se cumplió dentro de este número de días. Los planes gratuitos llegan hasta 90 días atrás; más allá se devuelve 403.

Default:7

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

average_return_pct
number (double) obligatorio

Rentabilidad media alineada con la dirección en las llamadas resueltas, en puntos porcentuales.

buckets
array<object> obligatorio

Intervalos de la distribución de rentabilidades en orden ascendente.
buckets[].call_count
integer (int64) obligatorio

Llamadas resueltas en este intervalo de rentabilidad.

buckets[].capped_total_aligned_return_pct
number (double) obligatorio

Suma de los retornos alineados con la dirección, con cada llamada limitada a ±100%, en puntos porcentuales.

buckets[].label
string obligatorio

Etiqueta legible del bucket o del índice.

buckets[].lower_bound_pct
number (double) obligatorio

Límite inferior inclusivo del retorno, en puntos porcentuales; null para el primer bucket, que es abierto.

buckets[].total_aligned_return_pct
number (double) obligatorio

Suma de los retornos alineados con la dirección en este bucket, en puntos porcentuales.

buckets[].upper_bound_pct
number (double) obligatorio

Límite superior exclusivo del retorno, en puntos porcentuales; null para el último bucket, que es abierto.

losses
integer (int64) obligatorio

Llamadas resueltas con un retorno alineado con la dirección negativo.

median_return_pct
number (double) obligatorio

Retorno alineado con la dirección mediano entre las llamadas resueltas, en puntos porcentuales.

resolved_calls
integer (int64) obligatorio

Número de llamadas con un resultado resuelto.

resolved_days
integer obligatorio

Cuántos días de llamadas resueltas incluyen las estadísticas.

win_rate_pct
number (double) obligatorio

Llamadas resueltas ganadoras como porcentaje de 0 a 100.

wins
integer (int64) obligatorio

Llamadas resueltas con un retorno alineado con la dirección positivo.

{
  "average_return_pct": 4.1,
  "buckets": [
    {
      "call_count": 91,
      "capped_total_aligned_return_pct": -228,
      "label": "-10% to 0%",
      "lower_bound_pct": -10,
      "total_aligned_return_pct": -342.5,
      "upper_bound_pct": 0
    }
  ],
  "losses": 174,
  "median_return_pct": 2.8,
  "resolved_calls": 412,
  "resolved_days": 7,
  "win_rate_pct": 57.77,
  "wins": 238
}