Earnings Stream

​

Overview

​

Key Features

• Real-time Earnings: Get instant notifications of earnings announcements as they happen
• Comprehensive Data: Includes EPS, revenue, estimates, actuals, and surprise metrics
• Filter by Security: Subscribe to specific tickers or ISINs
• Earnings Periods: Track Q1, Q2, Q3, Q4, and full-year (FY) results
• Importance Ratings: 0-5 scale indicating market significance

​

Use Cases

• Build real-time earnings calendars and alerts
• Track earnings surprises and beat/miss patterns
• Monitor portfolio company earnings in real-time
• Create earnings season dashboards
• Automate trading strategies based on earnings results

​

Quick Start

​

Connection URL

wss://api.benzinga.com/api/v2.1/calendar/earnings/stream?token=YOUR_TOKEN

​

Query Parameters

​

Message Example

{
  "id": "839f1f45-fffe-4801-9284-11dae5c5dae4",
  "api_version": "websocket/v1",
  "kind": "data/v2.1/calendar/earnings",
  "data": {
    "action": "created",
    "id": "66fffe978f3f630001a2ea56",
    "timestamp": "2024-10-04T14:42:27Z",
    "content": {
      "ticker": "AAPL",
      "name": "Apple Inc.",
      "exchange": "NASDAQ",
      "date": "2024-10-04",
      "time": "16:00:00",
      "period": "Q4",
      "period_year": 2024,
      "eps": "1.47",
      "eps_est": "1.39",
      "eps_surprise": "0.08",
      "eps_surprise_percent": "5.76",
      "revenue": "89500000000",
      "revenue_est": "89280000000",
      "importance": 5
    }
  }
}

​

Key Fields

​

Message Actions

​

Interactive Commands

​

Best Practices

• Deduplication: Use the id field to prevent duplicate processing
• Importance Filter: Focus on high-importance (4-5) earnings for major market impact
• Surprise Alerts: Set thresholds for significant earnings surprises
• Timing: Note that time field uses 24-hour format in EST/EDT