# Stock Analyst Ratings & Price Targets API
> Live Wall Street analyst coverage for US stocks from Nasdaq — no key, nothing stored. The "what do the analysts think" view of a stock: the consensus recommendation, the price target and how both have moved over time, distinct from the quote, movers, earnings and insider APIs in the catalogue. The consensus endpoint returns the recommendation picture — the number of analysts rating the stock buy, hold and sell, the total coverage and the mean rating (from Strong Buy to Strong Sell). The target endpoint returns the analyst price target — the low, mean and high targets, the current price and the implied upside to the mean target. The history endpoint returns the consensus timeline — the price target and the buy / hold / sell split month by month — so you can see whether sentiment is improving or deteriorating. Build research dashboards, price-target trackers, upgrade/downgrade alerts and valuation tools on top of real Nasdaq analyst data. Look up any US stock by its ticker symbol; targets and counts are returned as clean numbers and the implied upside is computed against the live price.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/analyst-api/..."
```

## Pricing
- **Free** (Free) — 11,500 calls/Mo, 3 req/s
- **Starter** ($9/Mo) — 180,000 calls/Mo, 10 req/s
- **Pro** ($26/Mo) — 770,000 calls/Mo, 28 req/s
- **Scale** ($58/Mo) — 2,800,000 calls/Mo, 60 req/s

## Endpoints

### Consensus

#### `GET /v1/consensus` — Analyst recommendation consensus

**Parameters:**
- `symbol` (query, required, string) — Stock ticker Example: `AAPL`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/analyst-api/v1/consensus?symbol=AAPL"
```

### Target

#### `GET /v1/target` — Price target with implied upside

**Parameters:**
- `symbol` (query, required, string) — Stock ticker Example: `AAPL`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/analyst-api/v1/target?symbol=AAPL"
```

### History

#### `GET /v1/history` — Consensus timeline over time

**Parameters:**
- `symbol` (query, required, string) — Stock ticker Example: `AAPL`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/analyst-api/v1/history?symbol=AAPL"
```

### Meta

#### `GET /v1/meta` — Service metadata

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/analyst-api/v1/meta"
```


---
Marketplace page: https://www.oanor.com/api/analyst-api
OpenAPI spec: https://www.oanor.com/api/analyst-api/openapi.json