---
title: "Get the consensus analyst rating for one symbol"
method: GET
path: "/v1/analyst-grades/"
tags: ["analyst-grades"]
---

# Get the consensus analyst rating for one symbol

`GET /v1/analyst-grades/`

## Request

- Base URL: `https://mcp.wisesheets.io`
- URL: `https://mcp.wisesheets.io/v1/analyst-grades/`
- Auth: HTTP bearer

Returns the current consensus of analyst ratings for one symbol as a snapshot: at most one row,
or an empty data array when no ratings are on file (unknown symbols and most ETFs). strongBuy,
buy, hold, sell and strongSell are the number of analysts at each rating. consensus is the
provider's summary label as published; observed values are Buy, Hold and Sell, but the set is
not guaranteed exhaustive, so treat it as a free string. Access is granted per account; keys
without it receive 403 POLICY_DENIED.

## Query parameters

- `ticker` string, required

## Response `200`

Default Response

- object
  - `data` object[], required
    - `symbol` string, required
    - `strongBuy` integer, nullable, required
    - `buy` integer, nullable, required
    - `hold` integer, nullable, required
    - `sell` integer, nullable, required
    - `strongSell` integer, nullable, required
    - `consensus` string, nullable, required
  - `meta` object, required
    - `requested` object, required
      - `ticker` string, required
    - `returned` integer, required

---

[API](https://skmtc.dev/wisesheets/apis/sec-edgar-financial-data-api.md) · [All operations](https://skmtc.dev/wisesheets/apis/sec-edgar-financial-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/wisesheets/apis/sec-edgar-financial-data-api/revisions/101907077f28?raw)