{"openapi":"3.1.0","info":{"title":"Stock Analyst Ratings & Price Targets API","version":"1.0.0","description":"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.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/analyst-api","description":"oanor gateway"}],"tags":[{"name":"Consensus"},{"name":"Target"},{"name":"History"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/consensus":{"get":{"operationId":"get_v1_consensus","tags":["Consensus"],"summary":"Analyst recommendation consensus","description":"","parameters":[{"name":"symbol","in":"query","required":true,"description":"Stock ticker","schema":{"type":"string"},"example":"AAPL"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/target":{"get":{"operationId":"get_v1_target","tags":["Target"],"summary":"Price target with implied upside","description":"","parameters":[{"name":"symbol","in":"query","required":true,"description":"Stock ticker","schema":{"type":"string"},"example":"AAPL"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/history":{"get":{"operationId":"get_v1_history","tags":["History"],"summary":"Consensus timeline over time","description":"","parameters":[{"name":"symbol","in":"query","required":true,"description":"Stock ticker","schema":{"type":"string"},"example":"AAPL"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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},{"buy":18,"date":"12/01/2025","hold":11,"sell":2,"consensus":"Buy","price_target":283.1},{"buy":16,"date":"01/01/2026","hold":11,"sell":2,"consensus":"Buy","price_target":271.86},{"buy":15,"date":"02/01/2026","hold":9,"sell":1,"consensus":"Buy","price_target":259.48},{"buy":13,"date":"03/01/2026","hold":9,"sell":1,"consensus":"Buy","price_target":264.18},{"buy":13,"date":"04/01/2026","hold":8,"sell":1,"consensus":"Buy","price_target":255.63},{"buy":15,"date":"05/01/2026","hold":9,"sell":1,"consensus":"Buy","price_target":280.14},{"buy":16,"date":"06/01/2026","hold":10,"sell":1,"consensus":"Buy","price_target":324.78}]},"meta":{"timestamp":"2026-06-12T01:42:27.580Z","request_id":"2d89f360-1f01-4ca4-95aa-6cb6ef9b5596"},"status":"ok","message":"History retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Service metadata","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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-4eb4-84c1-1969f05c81e6"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":11500,"rps_limit":3,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":890,"monthly_call_quota":180000,"rps_limit":10,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2640,"monthly_call_quota":770000,"rps_limit":28,"hard_limit":true},{"slug":"scale","name":"Scale","price_cents_month":5840,"monthly_call_quota":2800000,"rps_limit":60,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/analyst-api"}