> ## 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.
# 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` |
## メッセージ例
```json theme={null}
{
"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` を使用する
## AsyncAPI
````yaml asyncapi/consensus-ratings-stream.yml consensusRatings
id: consensusRatings
title: Consensus ratings
description: Send action commands; receive real-time consensus ratings updates
servers:
- id: production
protocol: wss
host: api.benzinga.com/api/v1/consensus-ratings
bindings: []
variables: []
address: stream
parameters: []
bindings: []
operations:
- &ref_2
id: consensusRatings.publish
title: Consensus ratings.publish
description: Send commands to the server
type: receive
messages:
- &ref_4
id: publish
contentType: text/plain
payload:
- type: string
enum: &ref_0
- ping
- replay
description: Send action commands (ping, replay)
x-parser-schema-id:
name: publish
headers: []
jsonPayloadSchema:
type: string
enum: *ref_0
description: Action to perform (ping for heartbeat, replay for message history)
x-parser-schema-id:
title: Publish
description: Send action commands (ping, replay)
example: '{}'
bindings: []
extensions:
- id: x-parser-unique-object-id
value: publish
- id: x-parser-message-name
value: ActionRequest
bindings: []
extensions: &ref_1
- id: x-parser-unique-object-id
value: consensusRatings
- &ref_3
id: consensusRatings.subscribe
title: Consensus ratings.subscribe
description: Receive real-time consensus ratings data
type: send
messages:
- &ref_5
id: subscribe
contentType: application/json
payload:
- name: subscribe
description: Consensus ratings event
type: object
properties:
- name: id
type: string
description: Unique UUID for the websocket response
required: true
- name: api_version
type: string
description: Websocket API version
enumValues:
- websocket/v1
required: true
- name: kind
type: string
description: Websocket connection stream type
enumValues:
- data/v2.1/calendar/ratings
required: true
- name: data
type: object
required: true
properties:
- name: aggregate_ratings
type: object
description: Contains all the ratings categorized by SELL, HOLD, BUY
required: true
properties:
- name: strong_buy
type: integer
description: Total strong_buy count/percentage
required: false
- name: buy
type: integer
description: Total buy count/percentage
required: false
- name: hold
type: integer
description: Total hold count/percentage
required: false
- name: sell
type: integer
description: Total sell count/percentage
required: false
- name: strong_sell
type: integer
description: Total strong_sell count/percentage
required: false
- name: aggregate_type
type: string
description: Type of aggregation, Number or Percentage
enumValues:
- number
- percentage
required: true
- name: consensus_price_target
type: number
description: Average price target
required: false
- name: consensus_rating
type: string
description: Scale value, SELL, HOLD, BUY
enumValues:
- SELL
- HOLD
- BUY
required: true
- name: consensus_rating_val
type: number
description: Value in float
required: false
- name: high_price_target
type: number
description: Highest price target in the specific timeline
required: false
- name: low_price_target
type: number
description: Lowest price target in the specific timeline
required: false
- name: total_analyst_count
type: integer
description: Total analyst ratings in the timeline
required: false
- name: unique_analyst_count
type: integer
description: Unique analyst count in the timeline
required: false
- name: updated_at
type: string
description: Last updated timestamp in UTC
required: false
headers: []
jsonPayloadSchema:
type: object
required:
- id
- api_version
- kind
- data
properties:
id:
type: string
format: uuid
description: Unique UUID for the websocket response
x-parser-schema-id:
api_version:
type: string
enum:
- websocket/v1
description: Websocket API version
x-parser-schema-id:
kind:
type: string
enum:
- data/v2.1/calendar/ratings
description: Websocket connection stream type
x-parser-schema-id:
data:
type: object
required:
- aggregate_ratings
- aggregate_type
- consensus_rating
properties:
aggregate_ratings:
type: object
description: Contains all the ratings categorized by SELL, HOLD, BUY
properties:
strong_buy:
type: integer
description: Total strong_buy count/percentage
x-parser-schema-id:
buy:
type: integer
description: Total buy count/percentage
x-parser-schema-id:
hold:
type: integer
description: Total hold count/percentage
x-parser-schema-id:
sell:
type: integer
description: Total sell count/percentage
x-parser-schema-id:
strong_sell:
type: integer
description: Total strong_sell count/percentage
x-parser-schema-id:
x-parser-schema-id:
aggregate_type:
type: string
enum:
- number
- percentage
description: Type of aggregation, Number or Percentage
x-parser-schema-id:
consensus_price_target:
type: number
description: Average price target
x-parser-schema-id:
consensus_rating:
type: string
enum:
- SELL
- HOLD
- BUY
description: Scale value, SELL, HOLD, BUY
x-parser-schema-id:
consensus_rating_val:
type: number
description: Value in float
x-parser-schema-id:
high_price_target:
type: number
description: Highest price target in the specific timeline
x-parser-schema-id:
low_price_target:
type: number
description: Lowest price target in the specific timeline
x-parser-schema-id:
total_analyst_count:
type: integer
description: Total analyst ratings in the timeline
x-parser-schema-id:
unique_analyst_count:
type: integer
description: Unique analyst count in the timeline
x-parser-schema-id:
updated_at:
type: string
format: date-time
description: Last updated timestamp in UTC
x-parser-schema-id:
x-parser-schema-id:
x-parser-schema-id:
title: Subscribe
description: Consensus ratings event
example: No examples found
bindings: []
extensions:
- id: x-parser-unique-object-id
value: subscribe
- id: x-parser-message-name
value: ConsensusRatingsMessage
bindings: []
extensions: *ref_1
sendOperations:
- *ref_2
receiveOperations:
- *ref_3
sendMessages:
- *ref_4
receiveMessages:
- *ref_5
extensions:
- id: x-parser-unique-object-id
value: consensusRatings
securitySchemes:
- id: tokenAuth
name: token
type: httpApiKey
description: Benzinga WebSocket API token (bz.production***)
in: query
extensions: []
````