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

Documentation Index

Fetch the complete documentation index at: https://benzinga-2-locadex-parallel-main.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

​
概要

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

​
主な機能

  • リアルタイム・レーティング: アナリストのレーティング変更をリアルタイムに通知
  • 目標株価: 現在および過去の目標株価とその調整履歴を追跡
  • アナリスト詳細: アナリスト名、所属機関、過去の的中率などの指標を提供
  • アクション分類: アップグレード、ダウングレード、維持、新規、再提示
  • 銘柄でフィルタリング: 特定のティッカーまたは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_current と rating_prior を比較する
  • 目標株価の変動: 目標株価の変更を把握するために pt_current と pt_prior を監視する
  • アナリストの信頼性: 証券会社（ファーム）の重要度と過去の予想精度を考慮する
  • 重要度フィルター: インパクトの大きなケースでは重要度が高い (4〜5) レーティングに注目する
Messages
token
type:httpApiKey

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

publish
type:string

Send action commands (ping, replay)

subscribe
type:object

Analyst ratings event