> ## 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.
# 컨센서스 투자 의견 스트림
> 실시간으로 집계된 컨센서스 투자 의견과 목표가.
## 개요
여러 애널리스트의 의견을 집계해 단일 레이팅과 목표가로 제공하는 실시간 컨센서스 데이터를 구독할 수 있습니다. 이를 통해 전체 시장 심리와 애널리스트 컨센서스의 변화를 추적할 수 있습니다.
### 주요 기능
* **집계 컨센서스**: 특정 종목에 대한 전체 애널리스트 투자의견을 통합한 보기
* **목표가 컨센서스**: 평균, 최고, 최저 목표 주가
* **투자의견 분포**: Strong Buy, Buy, Hold, Sell, Strong Sell 별 분포
* **애널리스트 수**: 전체 애널리스트 수와 중복을 제거한 고유 애널리스트 수 추적
* **유연한 집계 방식**: 개수 또는 비율(%)로 표시
### 사용 사례
* 컨센서스 투자의견 대시보드와 위젯 구축
* 전체 애널리스트 심리 변화 추적
* 개별 투자의견을 컨센서스와 비교
* 목표주가 범위(최고, 최저, 평균) 모니터링
* 컨센서스가 개선되거나 악화되고 있는 종목 식별
## 빠른 시작
위의 대화형 웹소켓 테스터를 사용해 실시간 스트림에 연결하고 테스트하세요.
### 연결 URL
```
wss://api.benzinga.com/api/v1/consensus-ratings/stream?token=YOUR_API_KEY
```
### 쿼리 매개변수
| Parameter | Required | Description |
| ---------------- | -------- | ----------------------------------------- |
| `token` | Yes | Benzinga 웹소켓 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 | 설명 |
| ------------------------ | ------------------------- |
| `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 | Description |
| -------- | -------------------------- |
| `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: []
````