# 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" ``` **Response:** ```json { "data": { "buy": 17, "hold": 10, "sell": 1, "market": "US", "source": "Nasdaq", "symbol": "AAPL", "buy_pct": 60.7, "analysts": 28, "mean_rating": "Buy" }, "meta": { "timestamp": "2026-06-12T01:42:27.261Z", "request_id": "0b8c68b7-cfdf-4417-aafb-43e7bbee6fba" }, "status": "ok", "message": "Consensus retrieved successfully", "success": true } ``` ### 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" ``` **Response:** ```json { "data": { "market": "US", "source": "Nasdaq", "symbol": "AAPL", "current_price": 295.63, "price_target_low": 250, "price_target_high": 400, "price_target_mean": 324.78, "implied_upside_pct": 9.86 }, "meta": { "timestamp": "2026-06-12T01:42:27.482Z", "request_id": "495e3da1-b18e-466a-a14f-385e0b5aa3e5" }, "status": "ok", "message": "Target retrieved successfully", "success": true } ``` ### 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" ``` **Response:** ```json { "data": { "count": 13, "market": "US", "source": "Nasdaq", "symbol": "AAPL", "history": [ { "buy": 14, "date": "06/01/2025", "hold": 9, "sell": 4, "consensus": "Buy", "price_target": 200.85 }, { "buy": 13, "date": "07/01/2025", "hold": 10, "sell": 2, "consensus": "Buy", "price_target": 207.82 }, { "buy": 13, "date": "08/01/2025", "hold": 12, "sell": 1, "consensus": "Buy", "price_target": 202.38 }, { "buy": 14, "date": "09/01/2025", "hold": 12, "sell": 1, "consensus": "Buy", "price_target": 232.14 }, { "buy": 17, "date": "10/01/2025", "hold": 13, "sell": 3, "consensus": "Buy", "price_target": 255.45 }, { "buy": 18, "date": "11/01/2025", "hold": 12, "sell": 2, "consensus": "Buy", "price_target": 270.37 }, { …(truncated, see openapi.json for full schema) ``` ### Meta #### `GET /v1/meta` — Service metadata **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/analyst-api/v1/meta" ``` **Response:** ```json { "data": { "note": "Look up a stock by its ticker (symbol=AAPL). The mean rating is the analyst consensus label; implied upside is the mean price target versus the last traded price. Targets and counts are numbers.", "source": "Nasdaq public analyst feed (api.nasdaq.com/api/analyst, live)", "service": "analyst-api", "endpoints": { "GET /v1/meta": "This document.", "GET /v1/target": "Price target — low/mean/high, current price and implied upside (symbol=AAPL).", "GET /v1/history": "Consensus timeline — price target and buy/hold/sell over time (symbol=AAPL).", "GET /v1/consensus": "Analyst recommendation consensus — buy/hold/sell counts and mean rating (symbol=AAPL)." }, "description": "Live Wall Street analyst coverage for US stocks from Nasdaq — the 'what do the analysts think' view. consensus = the recommendation picture (number of analysts rating it buy, hold and sell, total coverage and the mean rating from Strong Buy to Strong Sell); target = the analyst price target (low, mean and high targets, the current price and the implied upside to the mean target); history = the consensus timeline (price target and buy/hold/sell split over time). Live, no key, nothing stored. Distinct from the quote, movers, earnings and insider APIs.", "upstream_status": "ok" }, "meta": { "timestamp": "2026-06-12T01:42:27.670Z", "request_id": "deafe222-5adc- …(truncated, see openapi.json for full schema) ``` --- Marketplace page: https://www.oanor.com/api/analyst-api OpenAPI spec: https://www.oanor.com/api/analyst-api/openapi.json