Short Interest (FINRA biweekly panel — shares short, days to cover, squeeze/spike flags)
short_interestFINRA short interest history for a ticker — biweekly settlement-date panel since 2021-06-15. Returns shares short, days to cover, and mars's own pre-computed signal flags (squeeze_setup, short_spike, short_covering, short_extreme, short_zscore_high) per settlement, newest first.
Ticker is the join key (CIK resolves on only ~37% of rows in the source panel) — the tool tries the ticker as given, then with punctuation stripped (BRK.B / BRK-B -> BRKB), since FINRA's own ticker spelling in this feed doesn't always match ours.
NOT YET computed: % of shares outstanding / % of float (the source panel has raw shares short + avg daily volume but not a shares-outstanding join — days_to_cover and the flag fields are the best available signal today; a %OS/%float enrichment is a follow-up, not silently guessed here).
Known limitation: ticker symbol reuse (e.g. a delisted company's old ticker reassigned to a new one, as happened with META) is not detected — a long history pull may silently splice two different companies' data if the ticker was reused. Cross-check against the company's known listing history if the early history looks inconsistent with the company you mean.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"ticker": "<ticker>"
},
"name": "short_interest"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max settlement rows to return, newest first (default 60, max 300). | |
| since | No | Earliest settlement_date YYYY-MM-DD (default: full history since 2021-06-15). | |
| ticker | Yes | Stock ticker (required — this panel is ticker-keyed, not reliably CIK-keyed). |