{"openapi":"3.1.0","info":{"title":"Stock Short Interest API","version":"1.0.0","description":"Live short-interest data for US stocks from Nasdaq — no key, nothing stored. The \"how heavily is it shorted, and is a squeeze building\" view of a stock: the number of shares sold short, the average daily volume and the resulting days-to-cover, reported each settlement period, distinct from the quote, movers, insider and analyst APIs in the catalogue. The current endpoint returns the latest short-interest reading together with the change from the prior period — a rising or falling short position with the share delta and percent change. The history endpoint returns the full settlement-by-settlement timeline so you can see how the short position has trended over the year. Days-to-cover — short interest divided by average daily volume — is the headline squeeze metric: the higher it is, the longer shorts would need to buy back their position. Build short-squeeze scanners, bearish-positioning dashboards, risk overlays and contrarian-signal bots on top of real Nasdaq short-interest data. Look up any US stock by its ticker; share counts are returned as clean numbers. Note that short interest is reported about twice a month and a few non-Nasdaq listings may not be covered.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/shortinterest-api","description":"oanor gateway"}],"tags":[{"name":"Current"},{"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/current":{"get":{"operationId":"get_v1_current","tags":["Current"],"summary":"Latest short interest with change vs prior period","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":{"trend":"rising","market":"US","source":"Nasdaq","symbol":"AAPL","change_pct":12.32,"shares_short":155886024,"change_shares":17103306,"days_to_cover":3.3841,"settlement_date":"05/29/2026","avg_daily_volume":46064146,"prior_shares_short":138782718,"prior_settlement_date":"05/15/2026"},"meta":{"timestamp":"2026-06-12T01:42:20.683Z","request_id":"4e7419af-3bff-4c36-9c34-0bc796a9fceb"},"status":"ok","message":"Short interest 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":"Full settlement-by-settlement timeline","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":24,"market":"US","source":"Nasdaq","symbol":"AAPL","history":[{"shares_short":155886024,"days_to_cover":3.3841,"settlement_date":"05/29/2026","avg_daily_volume":46064146},{"shares_short":138782718,"days_to_cover":2.7446,"settlement_date":"05/15/2026","avg_daily_volume":50565316},{"shares_short":134675274,"days_to_cover":2.9313,"settlement_date":"04/30/2026","avg_daily_volume":45944025},{"shares_short":134422787,"days_to_cover":3.3882,"settlement_date":"04/15/2026","avg_daily_volume":39674165},{"shares_short":126771284,"days_to_cover":2.9569,"settlement_date":"03/31/2026","avg_daily_volume":42873045},{"shares_short":124192030,"days_to_cover":3.2578,"settlement_date":"03/13/2026","avg_daily_volume":38121907},{"shares_short":129553812,"days_to_cover":3.2556,"settlement_date":"02/27/2026","avg_daily_volume":39794651},{"shares_short":133373267,"days_to_cover":2.2549,"settlement_date":"02/13/2026","avg_daily_volume":59148111},{"shares_short":116854414,"days_to_cover":1.9999,"settlement_date":"01/30/2026","avg_daily_volume":58429082},{"shares_short":113576032,"days_to_cover":2.5947,"settlement_date":"01/15/2026","avg_daily_volume":43772789},{"shares_short":112732788,"days_to_cover":2.7078,"settlement_date":"12/31/2025","avg_daily_volume":41632615},{"shares_short":122035714,"days_to_cover":2.9497,"settlement_date":"12/15/2025","avg_daily_volume":41372302},{"shares_short":129458559,"days_to_cover":2.9398,"settlement_date":"11/28/2025","avg_daily_volume":44036020},{"shares_short":114913396,"days_to_cover":2.4422,"settlement_date":"11/14/2025","avg_daily_volume":47053455},{"shares_short":115557836,"days_to_cover":2.1988,"settlement_date":"10/31/2025","avg_daily_volume":52555048},{"shares_short":109135657,"days_to_cover":2.6285,"settlement_date":"10/15/2025","avg_daily_volume":41519913},{"shares_short":110777598,"days_to_cover":1.7448,"settlement_date":"09/30/2025","avg_daily_volume":63489777},{"shares_short":118199377,"days_to_cover":2.1274,"settlement_date":"09/15/2025","avg_daily_volume":55559339},{"shares_short":113582365,"days_to_cover":2.9652,"settlement_date":"08/29/2025","avg_daily_volume":38304785},{"shares_short":127079143,"days_to_cover":1.6982,"settlement_date":"08/15/2025","avg_daily_volume":74832635},{"shares_short":104634941,"days_to_cover":2.1393,"settlement_date":"07/31/2025","avg_daily_volume":48911215},{"shares_short":93946599,"days_to_cover":1.936,"settlement_date":"07/15/2025","avg_daily_volume":48526568},{"shares_short":110101153,"days_to_cover":1.888,"settlement_date":"06/30/2025","avg_daily_volume":58315896},{"shares_short":100226522,"days_to_cover":1.9809,"settlement_date":"06/13/2025","avg_daily_volume":50596046}]},"meta":{"timestamp":"2026-06-12T01:42:20.774Z","request_id":"5a49d2d7-053f-4245-a505-95a36b80c04f"},"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). US short interest is reported around the 15th and the end of each month; share counts are numbers and days-to-cover is shares-short over average daily volume.","source":"Nasdaq public short-interest feed (api.nasdaq.com/api/quote/{symbol}/short-interest, live)","service":"shortinterest-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/current":"Latest short interest with change from the prior period (symbol=AAPL).","GET /v1/history":"Full settlement-by-settlement short-interest timeline (symbol=AAPL)."},"description":"Live short-interest data for US stocks from Nasdaq — the 'how heavily is it shorted, and is a squeeze building' view. current = the latest short-interest reading (shares sold short, average daily volume, days-to-cover) with the change from the prior period; history = the full settlement-by-settlement timeline. Live, no key, nothing stored. Days-to-cover (short interest divided by average daily volume) is the headline squeeze metric. Distinct from the quote, movers, insider and analyst APIs.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-12T01:42:20.855Z","request_id":"cd66441a-7dc3-4be9-871c-4858077b7b13"},"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":11800,"rps_limit":3,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":790,"monthly_call_quota":178000,"rps_limit":10,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2360,"monthly_call_quota":765000,"rps_limit":28,"hard_limit":true},{"slug":"scale","name":"Scale","price_cents_month":5420,"monthly_call_quota":2780000,"rps_limit":60,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/shortinterest-api"}