レーティングストリーム - Benzinga API Documentation

概要

アナリストのレーティング変更および目標株価の更新をリアルタイムで購読できます。格上げ、格下げ、新規カバレッジ開始、目標株価の調整を、発生したタイミングで監視できます。

主な機能

リアルタイム・レーティング: アナリストのレーティング変更をリアルタイムに通知
目標株価: 現在および過去の目標株価とその調整履歴を追跡
アナリスト詳細: アナリスト名、所属機関、過去の的中率などの指標を提供
アクション分類: アップグレード、ダウングレード、維持、新規、再提示
銘柄でフィルタリング: 特定のティッカーまたはISINを購読

ユースケース

リアルタイムのレーティング変更アラートと通知を構築する
アナリスト・ファームのパフォーマンスと精度を追跡する
目標株価コンセンサスの変化を監視する
レーティングの格上げ／格下げダッシュボードを作成する
アナリストのアクションに基づく自動売買戦略を構築する

クイックスタート

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

接続URL

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

クエリパラメータ

パラメータ	必須	説明
`token`	Yes	お客様の Benzinga ウェブソケット API トークン（bz.production***）
`tickers`	No	ティッカーシンボルのカンマ区切りリスト（例: `AAPL,TSLA`）
`isins`	No	絞り込み対象の ISIN（国際証券識別番号）のカンマ区切りリスト

メッセージ例

{
  "id": "e9e75b31-604e-422c-a532-362725b2d59d",
  "api_version": "websocket/v1",
  "kind": "data/v2.1/calendar/ratings",
  "data": {
    "action": "created",
    "id": "66fffdc08f3f630001a2ea51",
    "timestamp": "2024-10-04T19:21:06Z",
    "content": {
      "ticker": "AAPL",
      "name": "Apple",
      "exchange": "NASDAQ",
      "date": "2024-10-04",
      "time": "10:37:52",
      "action_company": "Upgrades",
      "rating_current": "Buy",
      "rating_prior": "Neutral",
      "pt_current": "200.00",
      "pt_prior": "180.00",
      "analyst": "Goldman Sachs",
      "firm_id": "57f832ab6b87f600016fa383",
      "importance": 4
    }
  }
}

レーティングアクション

アクション	説明
`Upgrades`	レーティングが引き上げられた（例: Neutral → Buy）
`Downgrades`	レーティングが引き下げられた（例: Buy → Hold）
`Maintains`	レーティングは変更なし
`Initiates`	初めてのレーティング付与
`Reiterates`	既存レーティングの再表明

メッセージアクション

Action	説明
`created` / `Created`	新規レーティングが公開された
`updated` / `Updated`	レーティングが更新された
`deleted` / `Deleted`	レーティングが削除された

対話型コマンド

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

ベストプラクティス

変更の追跡: アップグレード/ダウングレードを検知するために rating_current と rating_prior を比較する
目標株価の変動: 目標株価の変更を把握するために pt_current と pt_prior を監視する
アナリストの信頼性: 証券会社（ファーム）の重要度と過去の予想精度を考慮する
重要度フィルター: インパクトの大きなケースでは重要度が高い (4〜5) レーティングに注目する

​概要

​主な機能

​ユースケース

​クイックスタート

​接続URL

​クエリパラメータ

​メッセージ例

​レーティングアクション

​メッセージアクション

​対話型コマンド

​ベストプラクティス

概要

主な機能

ユースケース

クイックスタート

接続URL

クエリパラメータ

メッセージ例

レーティングアクション

メッセージアクション

対話型コマンド

ベストプラクティス