Free Short Interest API

FINRA consolidated short interest as clean JSON. Biweekly settlement data for every US-listed symbol: short quantity, average daily volume, days to cover, and the change from the prior report.

Endpoints

GET

/api/markets/short-interest?symbol=GME

Without symbol: latest settlement, top 100 by days to cover. With symbol: full biweekly history for that symbol.

GET

/api/markets/short-interest/csv

Latest settlement snapshot, all symbols, as CSV.

Example

import requests

r = requests.get("https://xoomar.com/api/markets/short-interest", params={"symbol": "TSLA"})
for report in r.json()["data"][:6]:
    print(report["settlementDate"], report["daysToCover"])

Response Shape

Every endpoint returns the same JSON envelope: { data, updatedAt, source, docs }. The data field is an array of records with these fields:

Field	Type	Description
settlementDate	string (date)	FINRA settlement date (~15th and month-end)
symbol	string	Ticker symbol
shortQty	number \| null	Total shares held short
avgDailyVol	number \| null	Average daily trading volume
daysToCover	string \| null	shortQty / avgDailyVol, FINRA-computed
changePct	string \| null	Change in short quantity vs the prior report

The hub endpoint filters for average daily volume above 100k to keep days-to-cover meaningful; per-symbol history is unfiltered.

Numeric values arrive as strings where precision matters (prices, rates); parse with your language's decimal type for accounting-grade math. Rate limiting is fair-use per IP; a 429 response includes a Retry-After header. No authentication or API key needed. Attribution is appreciated: xoomar.com/markets.

Need more headroom? A free account raises your limit to 120 requests a minute with an X-API-Key header.

Dashboard →Insiders API →8-K Events API →

Frequently Asked Questions

Where does the data come from?

FINRA's public consolidated short interest files, published twice a month on their CDN. We check daily and load each new file the day it appears.

How much history is available?

Five years of biweekly reports, growing every two weeks. Per-symbol history via the symbol parameter.

Why is short interest delayed?

FINRA publishes about a week after each settlement date. That lag is inherent to the source; every short interest product has it.

What are the rate limits?

30 requests per minute per IP keyless, 120 with a free account key.

Data on this page is provided for informational purposes only and is not financial advice. See our editorial policy.