Saltar al contenido principal
WSS
stream

Documentation Index

Fetch the complete documentation index at: https://benzinga-2-locadex-parallel-main.mintlify.app/llms.txt

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

​
Descripción general

Suscríbete para recibir actualizaciones de noticias en tiempo real y notificaciones instantáneas cuando se publiquen nuevos artículos o se actualicen los existentes.

​
Funcionalidades clave

  • Actualizaciones en tiempo real: Recibe notificaciones instantáneas cuando se publican o actualizan artículos de noticias
  • Filtrado por valor: Suscríbete a tickers o ISIN específicos para recibir solo noticias relevantes
  • Datos exhaustivos: Incluye el contenido del artículo, información del autor, imágenes y valores asociados
  • Seguimiento de eventos: Supervisa cuándo se crean, actualizan o eliminan artículos

​
Casos de uso

  • Crear feeds de noticias en tiempo real para valores específicos
  • Crear alertas para noticias de última hora sobre las posiciones de una cartera
  • Consolidar noticias de múltiples tickers
  • Monitorizar el sentimiento y el volumen de noticias para obtener señales de trading

​
Inicio rápido

Usa el probador interactivo de WebSocket de arriba para conectarte y probar el flujo en tiempo real.

​
URL de conexión

wss://api.benzinga.com/api/v1/news/stream?token=YOUR_TOKEN

​
Parámetros de consulta

ParámetroRequeridoDescripción
tokenSíTu token de la API WebSocket de Benzinga (bz.production***)
tickersNoLista de símbolos bursátiles separados por comas (por ejemplo, AAPL,MSFT)
channelsNoLista de canales de noticias separados por comas para filtrar

​
Ejemplo de mensaje

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "api_version": "websocket/v1",
  "kind": "news",
  "data": {
    "action": "created",
    "id": 36444586,
    "timestamp": "2024-01-01T13:35:14Z",
    "content": {
      "id": 36444586,
      "author": "Benzinga Insights",
      "created": "Mon, 01 Jan 2024 13:35:14 -0400",
      "updated": "Mon, 01 Jan 2024 13:35:15 -0400",
      "title": "10 acciones de tecnología de la información con alertas de ballena en la sesión de hoy",
      "teaser": "",
      "body": "Full article content...",
      "url": "https://www.benzinga.com/markets/options/24/01/36444586/...",
      "image": [
        {
          "size": "thumb",
          "url": "https://cdn.benzinga.com/files/imagecache/250x187xUP/..."
        }
      ],
      "channels": [
        {
          "name": "Options"
        }
      ],
      "stocks": [
        {
          "name": "AAPL",
          "cusip": "037833100",
          "isin": "US0378331005",
          "exchange": "NASDAQ"
        }
      ],
      "tags": [
        {
          "name": "BZI-AUOA"
        }
      ]
    }
  }
}

​
Acciones de los mensajes

AcciónDescripción
created / CreatedNuevo artículo publicado
updated / UpdatedArtículo existente modificado
deleted / DeletedArtículo eliminado

​
Comandos interactivos

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

​
Mejores prácticas

  • Eliminación de duplicados: Usa el campo id para evitar procesar mensajes duplicados
  • Heartbeat: Envía comandos ping cada 30-60 segundos para mantener la conexión
  • Manejo de errores: Implementa lógica de reconexión con backoff exponencial
  • Filtrado: Usa filtros de ticker/canal para reducir el ancho de banda
Messages
token
type:httpApiKey

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

publish
type:string

Send action commands (ping, replay)

News Update
type:object

A news article or update message