Earnings Stream（決算ストリーム）

リアルタイムの決算発表および業績・財務結果。

​

概要

リアルタイムの決算発表をサブスクライブし、1株当たり利益（EPS）、売上高、サプライズ要因などを含む企業業績の更新情報を即時に受信できます。

​

主な機能

• リアルタイム決算: 決算発表が行われたタイミングで即時に通知を受け取ることができます
• 包括的なデータ: EPS、売上高、予想値、実績値、サプライズ指標を含みます
• 銘柄でのフィルタリング: 特定のティッカーまたは ISIN に購読できます
• 決算期間: Q1、Q2、Q3、Q4 および通期（FY）の結果を追跡します
• 重要度レーティング: 市場への重要度を 0〜5 段階のスケールで示します

​

ユースケース

• リアルタイムの決算カレンダーとアラートを構築する
• 決算サプライズや予想超過／未達のパターンを追跡する
• ポートフォリオ内の銘柄の決算をリアルタイムでモニタリングする
• 決算シーズン向けのダッシュボードを作成する
• 決算結果に基づく売買戦略を自動化する

​

クイックスタート

上部のインタラクティブなウェブソケットテスターを使って接続し、リアルタイムにストリームをテストしてください。

​

接続 URL

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

​

クエリパラメータ

Parameter	Required	Description
token	Yes	Benzinga ウェブソケット API のトークン（bz.production***）
tickers	No	ティッカーシンボルのカンマ区切りリスト（例: AAPL,MSFT）
isins	No	フィルタに使用する ISIN（国際証券識別番号）のカンマ区切りリスト

​

メッセージの例

{
  "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
    }
  }
}

​

主要フィールド

Field	説明
eps	報告された実際の1株当たり利益
eps_est	アナリストコンセンサスによるEPS予想
eps_surprise	実績値と予想値の差分
eps_surprise_percent	予想値に対するサプライズの割合（％）
revenue	報告された実際の売上高
revenue_est	アナリストコンセンサスによる売上高予想
importance	市場における重要度（0〜5、5が最大）

​

メッセージアクション

アクション	説明
created / Created	新しい決算発表が作成された
updated / Updated	決算データが更新された
deleted / Deleted	決算発表が削除された

​

インタラクティブコマンド

Command	Description
ping	接続を維持します（pong で応答します）
replay	最大 100 件までの直近のキャッシュ済みメッセージを再送します

​

ベストプラクティス

• 重複排除: 重複処理を防ぐために id フィールドを使用する
• 重要度フィルター: 市場インパクトの大きい決算では、重要度 4〜5 を重視する
• サプライズアラート: 大きな決算サプライズに対してアラートのしきい値を設定する
• 時刻: time フィールドは、EST/EDT における24時間表記である点に注意する