> ## 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.
# Transmisión de calificaciones de consenso
> Calificaciones de consenso y precios objetivo agregados en tiempo real.
## 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ámetro | Obligatorio | Descripción |
| ---------------- | ----------- | --------------------------------------------------------------------- |
| `token` | Sí | Tu token de la API WebSocket de Benzinga (bz.production\*\*\*) |
| `tickers` | No | Lista separada por comas de símbolos bursátiles (p. ej., `AAPL,MSFT`) |
| `isins` | No | Lista separada por comas de códigos ISIN para filtrar |
| `simplify` | No | Simplifica las calificaciones a Buy, Hold, Sell |
| `aggregate_type` | No | Tipo de agregación: `number` o `percentage` |
## Ejemplo de mensaje
```json theme={null}
{
"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ón | Valor numérico | Descripción |
| ------------- | -------------- | -------------------- |
| `STRONG_BUY` | 5.0 | Consenso muy alcista |
| `BUY` | 4.0 - 4.9 | Consenso alcista |
| `HOLD` | 3.0 - 3.9 | Consenso neutro |
| `SELL` | 2.0 - 2.9 | Consenso bajista |
| `STRONG_SELL` | 1.0 - 1.9 | Consenso muy bajista |
### Métricas clave
| Campo | Descripción |
| ------------------------ | -------------------------------------------------- |
| `consensus_rating` | Calificación general (BUY, HOLD, SELL) |
| `consensus_rating_val` | Valor numérico de la calificación (1.0-5.0) |
| `consensus_price_target` | Precio objetivo promedio entre todos los analistas |
| `high_price_target` | Precio objetivo más alto |
| `low_price_target` | Precio objetivo más bajo |
| `total_analyst_count` | Número total de calificaciones |
| `unique_analyst_count` | Número de analistas distintos |
## Comandos interactivos
| Comando | Descripción |
| -------- | -------------------------------------------------------------- |
| `ping` | Mantener la conexión activa (responde con `pong`) |
| `replay` | Reproducir 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
## AsyncAPI
````yaml asyncapi/consensus-ratings-stream.yml consensusRatings
id: consensusRatings
title: Consensus ratings
description: Send action commands; receive real-time consensus ratings updates
servers:
- id: production
protocol: wss
host: api.benzinga.com/api/v1/consensus-ratings
bindings: []
variables: []
address: stream
parameters: []
bindings: []
operations:
- &ref_2
id: consensusRatings.publish
title: Consensus ratings.publish
description: Send commands to the server
type: receive
messages:
- &ref_4
id: publish
contentType: text/plain
payload:
- type: string
enum: &ref_0
- ping
- replay
description: Send action commands (ping, replay)
x-parser-schema-id:
name: publish
headers: []
jsonPayloadSchema:
type: string
enum: *ref_0
description: Action to perform (ping for heartbeat, replay for message history)
x-parser-schema-id:
title: Publish
description: Send action commands (ping, replay)
example: '{}'
bindings: []
extensions:
- id: x-parser-unique-object-id
value: publish
- id: x-parser-message-name
value: ActionRequest
bindings: []
extensions: &ref_1
- id: x-parser-unique-object-id
value: consensusRatings
- &ref_3
id: consensusRatings.subscribe
title: Consensus ratings.subscribe
description: Receive real-time consensus ratings data
type: send
messages:
- &ref_5
id: subscribe
contentType: application/json
payload:
- name: subscribe
description: Consensus ratings event
type: object
properties:
- name: id
type: string
description: Unique UUID for the websocket response
required: true
- name: api_version
type: string
description: Websocket API version
enumValues:
- websocket/v1
required: true
- name: kind
type: string
description: Websocket connection stream type
enumValues:
- data/v2.1/calendar/ratings
required: true
- name: data
type: object
required: true
properties:
- name: aggregate_ratings
type: object
description: Contains all the ratings categorized by SELL, HOLD, BUY
required: true
properties:
- name: strong_buy
type: integer
description: Total strong_buy count/percentage
required: false
- name: buy
type: integer
description: Total buy count/percentage
required: false
- name: hold
type: integer
description: Total hold count/percentage
required: false
- name: sell
type: integer
description: Total sell count/percentage
required: false
- name: strong_sell
type: integer
description: Total strong_sell count/percentage
required: false
- name: aggregate_type
type: string
description: Type of aggregation, Number or Percentage
enumValues:
- number
- percentage
required: true
- name: consensus_price_target
type: number
description: Average price target
required: false
- name: consensus_rating
type: string
description: Scale value, SELL, HOLD, BUY
enumValues:
- SELL
- HOLD
- BUY
required: true
- name: consensus_rating_val
type: number
description: Value in float
required: false
- name: high_price_target
type: number
description: Highest price target in the specific timeline
required: false
- name: low_price_target
type: number
description: Lowest price target in the specific timeline
required: false
- name: total_analyst_count
type: integer
description: Total analyst ratings in the timeline
required: false
- name: unique_analyst_count
type: integer
description: Unique analyst count in the timeline
required: false
- name: updated_at
type: string
description: Last updated timestamp in UTC
required: false
headers: []
jsonPayloadSchema:
type: object
required:
- id
- api_version
- kind
- data
properties:
id:
type: string
format: uuid
description: Unique UUID for the websocket response
x-parser-schema-id:
api_version:
type: string
enum:
- websocket/v1
description: Websocket API version
x-parser-schema-id:
kind:
type: string
enum:
- data/v2.1/calendar/ratings
description: Websocket connection stream type
x-parser-schema-id:
data:
type: object
required:
- aggregate_ratings
- aggregate_type
- consensus_rating
properties:
aggregate_ratings:
type: object
description: Contains all the ratings categorized by SELL, HOLD, BUY
properties:
strong_buy:
type: integer
description: Total strong_buy count/percentage
x-parser-schema-id:
buy:
type: integer
description: Total buy count/percentage
x-parser-schema-id:
hold:
type: integer
description: Total hold count/percentage
x-parser-schema-id:
sell:
type: integer
description: Total sell count/percentage
x-parser-schema-id:
strong_sell:
type: integer
description: Total strong_sell count/percentage
x-parser-schema-id:
x-parser-schema-id:
aggregate_type:
type: string
enum:
- number
- percentage
description: Type of aggregation, Number or Percentage
x-parser-schema-id:
consensus_price_target:
type: number
description: Average price target
x-parser-schema-id:
consensus_rating:
type: string
enum:
- SELL
- HOLD
- BUY
description: Scale value, SELL, HOLD, BUY
x-parser-schema-id:
consensus_rating_val:
type: number
description: Value in float
x-parser-schema-id:
high_price_target:
type: number
description: Highest price target in the specific timeline
x-parser-schema-id:
low_price_target:
type: number
description: Lowest price target in the specific timeline
x-parser-schema-id:
total_analyst_count:
type: integer
description: Total analyst ratings in the timeline
x-parser-schema-id:
unique_analyst_count:
type: integer
description: Unique analyst count in the timeline
x-parser-schema-id:
updated_at:
type: string
format: date-time
description: Last updated timestamp in UTC
x-parser-schema-id:
x-parser-schema-id:
x-parser-schema-id:
title: Subscribe
description: Consensus ratings event
example: No examples found
bindings: []
extensions:
- id: x-parser-unique-object-id
value: subscribe
- id: x-parser-message-name
value: ConsensusRatingsMessage
bindings: []
extensions: *ref_1
sendOperations:
- *ref_2
receiveOperations:
- *ref_3
sendMessages:
- *ref_4
receiveMessages:
- *ref_5
extensions:
- id: x-parser-unique-object-id
value: consensusRatings
securitySchemes:
- id: tokenAuth
name: token
type: httpApiKey
description: Benzinga WebSocket API token (bz.production***)
in: query
extensions: []
````