メインコンテンツへスキップ
WSS
stream

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.

​
概要

リアルタイムの決算発表をサブスクライブし、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

​
クエリパラメータ

ParameterRequiredDescription
tokenYesBenzinga ウェブソケット API のトークン（bz.production***）
tickersNoティッカーシンボルのカンマ区切りリスト（例: AAPL,MSFT）
isinsNoフィルタに使用する 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決算発表が削除された

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

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

​
ベストプラクティス

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

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

publish
type:string

Send action commands (ping, replay)

subscribe
type:object

Earnings event