アナリストレーティングのコンセンサスデータを返します

指定されたtickerシンボルに対するアナリスト・コンセンサスのレーティング集計データを返します。このエンドポイントは、コンセンサスの目標株価、レーティング区分別の集計分布、および直近のアナリスト・レーティングに基づくアナリスト数を提供します。

GET /api/v1/consensus-ratings

アナリストレーティングのコンセンサスデータを返します

cURL

curl --request GET \
  --url 'https://api.benzinga.com/api/v1/consensus-ratings?token=' \
  --header 'accept: <accept>'

200

{
  "aggregate_ratings": {
    "buy": 10,
    "hold": 3,
    "sell": 1,
    "strong_buy": 5,
    "strong_sell": 0
  },
  "aggregate_type": "90D",
  "consensus_price_target": 195.5,
  "consensus_rating": "Buy",
  "consensus_rating_val": 4.2,
  "high_price_target": 225,
  "low_price_target": 150,
  "total_analyst_count": 19,
  "unique_analyst_count": 15,
  "updated_at": "2024-01-09T16:00:00.000Z"
}

Authorizations

token · string · query · required

Headers

accept · enum<string> · default: application/json · required

返却形式を指定します。クエリパラメータはどちらの形式でも同様に動作します

Available options: application/json

Query Parameters

pagesize · integer

返される結果数。上限は1000件。

parameters[date_from] · string<YYYY-MM-DD>

クエリの起点となる日時

parameters[date_to] · string<YYYY-MM-DD>

ポイントインタイムのクエリ終了日

parameters[tickers] · string

集計対象とするtickerシンボルを1つ指定します。指定できるtickerは1つまでです。

simplify · boolean · default: false

総合レーティングを BUY・SELL・HOLD のみに簡略化したい場合でも、デフォルトではすべてのレーティング（STRONG_BUY、BUY、HOLD、SELL、STRONG_SELL）が返されます。

aggregate_type · enum<string> · default: number

格付けを件数または割合で集計するかを指定します

Available options: number, percentage

Response

200

application/json

成功

aggregate_ratings · object

Show child attributes

aggregate_type · string

Example:

"90D"

consensus_price_target · number

Example:

195.5

consensus_rating · string

Example:

"Buy"

consensus_rating_val · number

Example:

4.2

high_price_target · number

Example:

225

low_price_target · number

Example:

150

total_analyst_count · integer

Example:

19

unique_analyst_count · integer

Example:

15

updated_at · string

Example:

"2024-01-09T16:00:00.000Z"