Llamadas long/short

GET /calls

GetCalls

Cuántas llamadas largas y cortas hace la gente sobre un activo, o en todos los mercados, a lo largo del tiempo. Una llamada afirma que un activo subirá o bajará, revela una posición o indica a otros que tomen una; una opinión sin más no cuenta. Envía clusters para contar las llamadas de un grupo.

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. 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

hours integer QUERY

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

Default:720

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' \
  --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[].long_calls

integer (int64) obligatorio

Número de llamadas largas en el intervalo.

series[].short_calls

integer (int64) obligatorio

Número de llamadas cortas en el intervalo.

series[].timestamp

string obligatorio

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

{
  "series": [
    {
      "long_calls": 184,
      "short_calls": 71,
      "timestamp": "2026-08-07T15:00:00Z"
    }
  ]
}