メインコンテンツへスキップ
WSS
wss://api.benzinga.com/api/v2.1/calendar/ratings
stream
Messages
token
type:httpApiKey

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

publish
type:string

Send action commands (ping, replay)

subscribe
type:object

Analyst ratings event

概要

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

主な機能

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

ユースケース

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

クイックスタート

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

接続URL

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

クエリパラメータ

パラメータ必須説明
tokenYesお客様の Benzinga ウェブソケット API トークン(bz.production***)
tickersNoティッカーシンボルのカンマ区切りリスト(例: AAPL,TSLA
isinsNo絞り込み対象の 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_currentrating_prior を比較する
  • 目標株価の変動: 目標株価の変更を把握するために pt_currentpt_prior を監視する
  • アナリストの信頼性: 証券会社(ファーム)の重要度と過去の予想精度を考慮する
  • 重要度フィルター: インパクトの大きなケースでは重要度が高い (4〜5) レーティングに注目する