What it returns
Daily Reg SHO threshold securities lists from Nasdaq, NYSE, NYSE American and NYSE Arca, from January 2021 to today. A stock lands on its exchange's threshold list after five consecutive settlement days of large fails to deliver (at least 10,000 shares and 0.5% of shares outstanding); 13 consecutive days triggers the Rule 203(b)(3) mandatory close-out. Ask whether a symbol was on a list on any date, get its streaks over a range, or pull every security on the lists for a given day.
| field | meaning |
|---|---|
| date, symbol, securityName | A day the security was on the list |
| listingMarket | Exchange whose list it appeared on |
| marketCategory, rule3210 | Nasdaq only: market tier (Q Global Select, G Global Market, S Capital Market) and the FINRA Rule 3210 flag |
| daysOnList, firstDate, lastDate | Summary mode: count and span within your range |
| longestStreak, currentStreak, tradingDaysInRange | Summary mode: consecutive trading days on the list |
Common uses
- Hard-to-borrow and squeeze screens, and historical backtests of them
- Short-sale compliance checks before locating or lending
- Research on fails to deliver around corporate events
Request
POST https://api.pushbuild.com/reg-sho-threshold-list/run with a JSON body. Send your key in the X-API-Key header.
| Field | Type | Description |
|---|---|---|
symbols | list of strings | Tickers to check, e.g. GME, AMC. Empty: every security on the lists (range limited to 31 days). |
startDate | string | YYYY-MM-DD, from 2021-01-01. Default: 30 days before the end date with symbols, else the end date only. |
endDate | string | YYYY-MM-DD. Default: today. Up to one year per run. |
markets | list of strings | Which threshold lists to read. Default: all four. |
summarize | boolean | One row per symbol: days on the list, first and last date, longest and current consecutive streak (13+ consecutive days triggers the Reg SHO close-out rule). Default: false. |
maxItems | integer | Maximum items to return (1-500). Default: 100. |
Example
curl -X POST https://api.pushbuild.com/reg-sho-threshold-list/run \
-H "X-API-Key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"symbols": ["GME", "AMC"], "maxItems": 20}'Response
{"count": 20, "truncated": false, "seconds": 1.4, "items": [ { ... } ]}Each call returns up to 500 items. Records that fail validation or are not found are flagged in the items and not charged.
Pricing
Pay only for results returned: $0.16 per 1,000 rows. No charge for errors or empty searches.
Related APIs
Australian Bureau of Statistics API: CPI, Jobs, GDP, Any Data API
Australian Bureau of Statistics data from the official ABS Data API: monthly CPI and trimmed mean, unemployment by state, GDP, wage price index and household spending presets, any ABS dataflow by SDMX key, and dataflow search.
Banco de Portugal API: Portugal Rates, Yields, HICP & GDP API
Banco de Portugal BPstat data from the official API: coincident indicators, HICP, GDP, house prices, confidence, Portuguese government bond yields, money-market, loan and deposit rates, banking ratios, or any BPstat dataset or series id..
Bank of Canada API: Policy Rate, CORRA, Bonds, CPI & CAD FX API
Bank of Canada statistics from its official Valet API: policy rate, CORRA, prime, T-bills, benchmark bond yields, mortgage and GIC rates, CPI and core CPI, commodity prices and daily CAD exchange rates.
Bank of England API: Bank Rate, SONIA, Gilts & Mortgages API
Bank of England statistics from its official database: Bank Rate, SONIA, gilt yields, implied inflation, mortgage rates and approvals, M4 money, lending and sterling FX.
Bank of Israel API: BOI Rate, SHIR & Shekel Exchange Rates API
Bank of Israel statistics from its official SDMX API: the BOI interest rate, SHIR overnight rate and standing facility rates, daily representative shekel exchange rates (USD, EUR, GBP, JPY, CHF, CAD, AUD), or any series of any BOI dataflow..
Bank of Japan API: Call Rate, USD/JPY, Money Stock & Tankan API
Bank of Japan statistics from its official Time-Series Data Search API: overnight call rate, basic loan rate, USD/JPY, monetary base, M2, producer prices and Tankan business conditions presets, any series by database and code, and series search..
Tell us what you need built.
Questions about this API, higher volumes, or a data source you need that we don't cover yet.
hello@pushbuild.com