Consensus Ratings ストリーム

リアルタイムのコンセンサス・レーティングおよび目標株価の集約データ。

​

概要

複数アナリストの見解を集約したリアルタイムのコンセンサス・レーティングを購読し、統一されたレーティングと目標株価を取得できます。市場全体のセンチメントやアナリスト・コンセンサスの変化を追跡します。

​

主な機能

• コンセンサス集約: 特定銘柄に対するすべてのアナリスト・レーティングを統合したビュー
• 目標株価コンセンサス: 平均・高値・安値の目標株価
• レーティング分布: Strong Buy、Buy、Hold、Sell、Strong Sell ごとの内訳
• アナリスト数: アナリストの総数および重複を除いたカバレッジ数を追跡
• 柔軟な集計: 件数または割合として表示

​

ユースケース

• コンセンサス・レーティングのダッシュボードやウィジェットを構築する
• アナリスト全体のセンチメントの変化を追跡する
• 個別レーティングをコンセンサスと比較する
• 目標株価レンジ（高値・安値・平均）を監視する
• コンセンサスが改善／悪化している銘柄を特定する

​

クイックスタート

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

​

接続 URL

wss://api.benzinga.com/api/v1/consensus-ratings/stream?token=YOUR_TOKEN

​

クエリパラメータ

Parameter	Required	Description
token	Yes	Benzinga の WebSocket API トークン（bz.production***）
tickers	No	ティッカーシンボルのカンマ区切りリスト（例: AAPL,MSFT）
isins	No	フィルタ用の ISIN（国際証券識別番号）のカンマ区切りリスト
simplify	No	レーティングを Buy／Hold／Sell に簡略化
aggregate_type	No	集計種別: number または percentage

​

メッセージ例

{
  "id": "e9e75b31-604e-422c-a532-362725b2d59d",
  "api_version": "websocket/v1",
  "kind": "data/v2.1/calendar/ratings",
  "data": {
    "aggregate_ratings": {
      "strong_buy": 15,
      "buy": 25,
      "hold": 8,
      "sell": 2,
      "strong_sell": 0
    },
    "aggregate_type": "number",
    "consensus_rating": "BUY",
    "consensus_rating_val": 4.2,
    "consensus_price_target": 195.50,
    "high_price_target": 225.00,
    "low_price_target": 160.00,
    "total_analyst_count": 50,
    "unique_analyst_count": 48,
    "updated_at": "2024-10-04T19:21:06Z"
  }
}

​

コンセンサス・レーティング

Rating	Numeric Value	Description
STRONG_BUY	5.0	非常に強気のコンセンサス
BUY	4.0 - 4.9	強気のコンセンサス
HOLD	3.0 - 3.9	中立的なコンセンサス
SELL	2.0 - 2.9	弱気のコンセンサス
STRONG_SELL	1.0 - 1.9	非常に弱気のコンセンサス

​

主要指標

Field	Description
consensus_rating	総合レーティング（BUY、HOLD、SELL）
consensus_rating_val	レーティング値の数値表現（1.0〜5.0）
consensus_price_target	アナリスト全体の平均目標株価
high_price_target	目標株価の最高値
low_price_target	目標株価の最低値
total_analyst_count	レーティングの総数
unique_analyst_count	重複を除いたアナリスト数

​

対話型コマンド

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

​

ベストプラクティス

• コンセンサスの変化: 時系列で consensus_rating_val の変化を監視する
• 目標株価レンジ: 現在株価を高値/安値目標と比較してバリュエーションの判断材料とする
• カバレッジの深さ: アナリスト数が多いほどコンセンサスの信頼性が高いと判断できる
• 分布分析: センチメントのニュアンスを把握するために aggregate_ratings の内訳を確認する
• パーセンテージ表示: 正規化された比較には aggregate_type=percentage を使用する