Saltar al contenido principal
WSS
stream

Documentation Index

Fetch the complete documentation index at: https://docs.benzinga.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Descripción general

Suscríbase a calificaciones de consenso en tiempo real que consolidan múltiples opiniones de analistas en calificaciones unificadas y precios objetivo. Supervise el sentimiento general del mercado y los cambios en el consenso de los analistas.

​
Características clave

  • Consenso agregado: Vista combinada de todas las calificaciones de analistas para un valor
  • Consenso de precio objetivo: Objetivos de precio promedio, máximo y mínimo
  • Distribución de calificaciones: Desglose por “Strong Buy”, “Buy”, “Hold”, “Sell”, “Strong Sell”
  • Número de analistas: Seguimiento del número total de analistas y de los analistas únicos que cubren el valor
  • Agregación flexible: Visualización como recuentos o porcentajes

​
Casos de uso

  • Crear paneles y widgets de recomendaciones de consenso
  • Hacer seguimiento de cambios generales en el sentimiento de los analistas
  • Comparar recomendaciones individuales con el consenso
  • Monitorizar rangos de precio objetivo (alto, bajo, promedio)
  • Identificar valores con un consenso en mejora o deterioro

​
Inicio rápido

Usa la herramienta interactiva de prueba de WebSocket de arriba para conectarte y probar el flujo en tiempo real.

​
URL de conexión

wss://api.benzinga.com/api/v1/consensus-ratings/stream?token=YOUR_TOKEN

​
Parámetros de consulta

ParámetroObligatorioDescripción
tokenSíTu token de la API WebSocket de Benzinga (bz.production***)
tickersNoLista separada por comas de símbolos bursátiles (p. ej., AAPL,MSFT)
isinsNoLista separada por comas de códigos ISIN para filtrar
simplifyNoSimplifica las calificaciones a Buy, Hold, Sell
aggregate_typeNoTipo de agregación: number o percentage

​
Ejemplo de mensaje

{
  "id": "e9e75b31-604e-422c-a532-362725b2d59d",
  "api_version": "websocket/v1",
  "kind": "data/v2.1/calendar/ratings",
  "data": {
    "aggregate_ratings": {
      "strong_buy": 15,
      "buy": 25,
      "hold": 8,
      "sell": 2,
      "strong_sell": 0
    },
    "aggregate_type": "number",
    "consensus_rating": "BUY",
    "consensus_rating_val": 4.2,
    "consensus_price_target": 195.50,
    "high_price_target": 225.00,
    "low_price_target": 160.00,
    "total_analyst_count": 50,
    "unique_analyst_count": 48,
    "updated_at": "2024-10-04T19:21:06Z"
  }
}

​
Calificaciones de consenso

CalificaciónValor numéricoDescripción
STRONG_BUY5.0Consenso muy alcista
BUY4.0 - 4.9Consenso alcista
HOLD3.0 - 3.9Consenso neutro
SELL2.0 - 2.9Consenso bajista
STRONG_SELL1.0 - 1.9Consenso muy bajista

​
Métricas clave

CampoDescripción
consensus_ratingCalificación general (BUY, HOLD, SELL)
consensus_rating_valValor numérico de la calificación (1.0-5.0)
consensus_price_targetPrecio objetivo promedio entre todos los analistas
high_price_targetPrecio objetivo más alto
low_price_targetPrecio objetivo más bajo
total_analyst_countNúmero total de calificaciones
unique_analyst_countNúmero de analistas distintos

​
Comandos interactivos

ComandoDescripción
pingMantener la conexión activa (responde con pong)
replayReproducir hasta los últimos 100 mensajes almacenados en caché

​
Mejores prácticas

  • Cambios en el consenso: Supervisa los cambios en consensus_rating_val a lo largo del tiempo
  • Rango de precio objetivo: Compara el precio actual con los objetivos máximo y mínimo para obtener contexto de valoración
  • Profundidad de cobertura: Un mayor número de analistas indica un consenso más confiable
  • Análisis de distribución: Examina el desglose de aggregate_ratings para captar matices en el sentimiento
  • Vista porcentual: Usa aggregate_type=percentage para comparaciones normalizadas
Messages
token
type:httpApiKey

Benzinga WebSocket API token (bz.production***)

publish
type:string

Send action commands (ping, replay)

subscribe
type:object

Consensus ratings event