{"openapi":"3.1.0","info":{"title":"Stock Quotes API","version":"1.0.0","description":"Live stock quotes as an API — the current price of any listed equity or ETF, served from Yahoo Finance. For any ticker it returns the current price, the previous close, the absolute and percentage change on the day, the day's high and low, the 52-week high and low, the trading volume and the listing exchange and currency. Look a stock up by ticker or by company name, pull a batch of tickers in a single call for a watchlist, or search for a company to find its symbol. Works for US and international equities and ETFs. The live equity-quote layer for trading, portfolio and dashboard apps. Live, no key, no cache. Distinct from index constituent-directory APIs (which list the members of an index) — this returns the live quote, not the member list.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/stocks-api","description":"oanor gateway"}],"tags":[{"name":"Quote"},{"name":"Quotes"},{"name":"Search"},{"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/quote":{"get":{"operationId":"get_v1_quote","tags":["Quote"],"summary":"One stock quote by ticker or name","description":"","parameters":[{"name":"symbol","in":"query","required":false,"description":"Ticker symbol","schema":{"type":"string"},"example":"AAPL"},{"name":"name","in":"query","required":false,"description":"Company name (resolved via search)","schema":{"type":"string"},"example":"Apple"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"name":"Apple Inc.","as_of":"2026-06-08T20:00:01.000Z","price":301.54,"change":-5.8,"symbol":"AAPL","volume":77764805,"day_low":301.17,"currency":"USD","day_high":317.4,"exchange":"NasdaqGS","change_pct":-1.89,"week52_low":195.07,"week52_high":317.4,"previous_close":307.34,"instrument_type":"EQUITY"},"meta":{"timestamp":"2026-06-09T03:02:23.222Z","request_id":"e69856de-ec02-4b90-8f69-d24d628e93ee"},"status":"ok","message":"Quote 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/quotes":{"get":{"operationId":"get_v1_quotes","tags":["Quotes"],"summary":"Batch quotes for a watchlist","description":"","parameters":[{"name":"symbols","in":"query","required":true,"description":"Comma-separated tickers (up to 15)","schema":{"type":"string"},"example":"AAPL,MSFT,TSLA"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":3,"quotes":[{"name":"Apple Inc.","as_of":"2026-06-08T20:00:01.000Z","price":301.54,"change":-5.8,"symbol":"AAPL","volume":77764805,"day_low":301.17,"currency":"USD","day_high":317.4,"exchange":"NasdaqGS","change_pct":-1.89,"week52_low":195.07,"week52_high":317.4,"previous_close":307.34,"instrument_type":"EQUITY"},{"name":"Microsoft Corporation","as_of":"2026-06-08T20:00:00.000Z","price":411.74,"change":-4.93,"symbol":"MSFT","volume":31980271,"day_low":408.56,"currency":"USD","day_high":417.16,"exchange":"NasdaqGS","change_pct":-1.18,"week52_low":356.28,"week52_high":555.45,"previous_close":416.67,"instrument_type":"EQUITY"},{"name":"Tesla, Inc.","as_of":"2026-06-08T20:00:00.000Z","price":408.95,"change":17.95,"symbol":"TSLA","volume":50178344,"day_low":394.72,"currency":"USD","day_high":412.94,"exchange":"NasdaqGS","change_pct":4.59,"week52_low":288.77,"week52_high":498.83,"previous_close":391,"instrument_type":"EQUITY"}],"requested":3},"meta":{"timestamp":"2026-06-09T03:02:23.360Z","request_id":"d7bfc3cf-668f-4bc2-900b-711c371b0f95"},"status":"ok","message":"Quotes 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/search":{"get":{"operationId":"get_v1_search","tags":["Search"],"summary":"Find a ticker by company name","description":"","parameters":[{"name":"q","in":"query","required":true,"description":"Company name query","schema":{"type":"string"},"example":"apple"},{"name":"limit","in":"query","required":false,"description":"Max results (1-20)","schema":{"type":"string"},"example":"10"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":7,"query":"apple","results":[{"name":"Apple Inc.","type":"EQUITY","symbol":"AAPL","exchange":"NMS"},{"name":"Apple Hospitality REIT, Inc.","type":"EQUITY","symbol":"APLE","exchange":"NYQ"},{"name":"Apple Inc.                    R","type":"EQUITY","symbol":"APC.DE","exchange":"GER"},{"name":"APPLE INTERNATIONAL CO LTD","type":"EQUITY","symbol":"2788.T","exchange":"JPX"},{"name":"HARVEST APPLE ENHNCD HIGH INCM ","type":"ETF","symbol":"APLE.TO","exchange":"TOR"},{"name":"Apple International Co. Ltd.  R","type":"EQUITY","symbol":"D90.F","exchange":"FRA"},{"name":"APPLE INC","type":"EQUITY","symbol":"AAPL.MX","exchange":"MEX"}]},"meta":{"timestamp":"2026-06-09T03:02:23.592Z","request_id":"1bc37d23-9ff4-494f-8ab1-e9f01352832b"},"status":"ok","message":"Search results 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":{"source":"Yahoo Finance public chart + search (live)","service":"stocks-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/quote":"One stock quote (symbol=AAPL or name=Apple).","GET /v1/quotes":"Batch quotes for a watchlist (symbols=AAPL,MSFT,TSLA — up to 15).","GET /v1/search":"Find a ticker by company name (q=apple)."},"description":"Live stock quotes from Yahoo Finance: for any ticker (or company name), the current price, previous close, day change (absolute and percent), day high/low, 52-week high/low, volume, exchange and currency. Look one up, pull a batch for a watchlist, or search for a company's symbol. US and international equities and ETFs. Live, no key. Distinct from index constituent-directory APIs — this returns the live quote, not the member list.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-09T03:02:23.706Z","request_id":"a41815d0-3a52-4829-93fd-d19b3f037be3"},"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":10000,"rps_limit":5,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1000,"monthly_call_quota":140000,"rps_limit":15,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2800,"monthly_call_quota":700000,"rps_limit":40,"hard_limit":true},{"slug":"desk","name":"Desk","price_cents_month":6600,"monthly_call_quota":3600000,"rps_limit":100,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/stocks-api"}