Descripción general

Una guía de alto nivel sobre los flujos de datos en tiempo real mediante WebSocket de Benzinga.

La API WebSocket de Benzinga entrega datos financieros de baja latencia mediante push directamente a tu aplicación. En lugar de consultar repetidamente un endpoint REST, abres una única conexión persistente y recibes eventos en el momento en que están disponibles: calificaciones de analistas, resultados de ganancias, noticias, transcripciones y más.

Todos los flujos comparten el mismo endpoint base, modelo de autenticación y envoltura de mensajes, por lo que los patrones que aprendes en un flujo se aplican en todas partes.

​

Cómo funciona

1. Autenticar

   Obtén un token de la API de Benzinga desde la Benzinga Console y añádelo como parámetro de consulta token al abrir la conexión.

2. Conectar

   Abre una conexión WebSocket a la URL de streaming de los datos que necesitas — por ejemplo, wss://api.benzinga.com/api/v1/analyst/insights/stream?token=YOUR_TOKEN.

3. Recibir eventos

   Los mensajes llegan como objetos JSON con una envoltura coherente: un id, api_version, kind y un bloque data que incluye la acción (created, updated o deleted) y el payload (carga útil).

4. Mantener viva la conexión

   Envía periódicamente un frame de texto plano ping (cada 30–60 segundos). El servidor responde con pong. El servidor también envía su propio ping cada 10 segundos — la mayoría de las bibliotecas WebSocket manejan esto automáticamente.

​

Streams disponibles

Perspectivas de analistas

Calificaciones de analistas en tiempo real, precios objetivo y recomendaciones detalladas a medida que se publican.

Calificaciones

Cambios en las calificaciones de analistas y actualizaciones de precios objetivo de las principales firmas.

Calificaciones de consenso

Calificaciones de consenso agregadas y precios objetivo de todos los analistas seguidos.

Resultados

Anuncios de resultados con EPS (beneficio por acción), ingresos, estimaciones y métricas de sorpresa.

Bulls/Bears Say

Escenarios alcistas y bajistas para valores, publicados en tiempo real.

Noticias

Noticias de última hora y actualizaciones del mercado del equipo editorial de Benzinga.

Transcripciones de conferencias de resultados

Transcripciones en vivo de conferencias de resultados proporcionadas frase por frase a medida que se pronuncian.

​

Envoltorio del mensaje

Cada mensaje de streaming sigue la misma estructura de nivel superior:

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "api_version": "websocket/v1",
  "kind": "<stream-type>",
  "data": {
    "action": "created",
    "id": "<record-id>",
    "timestamp": "2024-10-08T10:00:00Z",
    "content": { ... }
  }
}

Field	Description
id	ID de mensaje único; úsalo para eliminar duplicados al reconectar
api_version	Versión de protocolo del mensaje
kind	Identifica desde qué flujo proviene el mensaje
data.action	Es uno de created, updated o deleted
data.content	Carga útil específica del flujo

​

Páginas de referencia

Autenticación

Cómo obtener y usar tu token de la API.

Acciones compatibles

Comandos ping y replay que puedes enviar en cualquier flujo.

Errores

Códigos de error y cómo gestionar errores de conexión.