Screen the stock universe by combining optional range filters across datasets: market cap and price, sector and industry, 13F filer count and its change, institutional ownership and the 13F holder signals of the newest computed closed quarter (conviction share, crowding, private-fund adviser ownership, active holders' share change, holder tenure, and price versus the holders' estimated average cost), short interest and days to cover, composite short-squeeze and insider-sentiment scores, net insider buying (90d), the going-concern doubt flag, and daily-refreshed derived metrics (trailing P/E, dividend yield from split-restated TTM cash dividends per share divided by share price, revenue growth YoY, gross margin, average daily dollar volume, TTM net income). A bound on a metric excludes stocks with no data on that axis. Sorted by the chosen metric (default market cap, descending); page walks past the first page and vintages state each dataset's freshness.
Request
- Base URLhttps://api.equibles.com
- AuthHTTP bearer
- TypeScriptA function with typed inputs. Its response is checked against the schema.
Query parameters
Minimum market capitalization in USD.
Maximum market capitalization in USD.
Minimum share price in USD.
Maximum share price in USD.
Minimum number of 13F institutional filers.
Maximum number of 13F institutional filers.
Minimum quarter-over-quarter change in filer count.
Maximum quarter-over-quarter change in filer count.
Minimum short interest as a percent of shares outstanding (0-100).
Maximum short interest as a percent of shares outstanding (0-100).
Minimum days to cover.
Maximum days to cover.
Minimum composite short-squeeze score (0-100).
Maximum composite short-squeeze score (0-100).
Minimum composite insider-sentiment score (0-100).
Maximum composite insider-sentiment score (0-100).
Minimum net open-market insider buying by officers and directors in USD over the trailing 90 days.
Maximum net open-market insider buying by officers and directors in USD over the trailing 90 days.
True keeps only companies with unalleviated going-concern doubt; false keeps only companies without it.
Exact sector name (e.g. Technology, Healthcare). An unknown name is a 400 listing the accepted sectors.
Exact industry name (e.g. Semiconductors). Prefer sector for broad groups; an unknown name is a 400.
Restrict to members of a covered index, by slug or name (e.g. sp-500, "S&P 500", SPX). A name matching no covered index is a 400 listing the covered ones.
Listing markets to screen, as comma-separated ISO country codes (for example GB,FR), or all for every market. Omitted means US. A non-US row's ticker is the qualified MIC:TICKER symbol (for example XPAR:AIR) and its price and market cap are converted to USD at the official rate; localPrice and currency carry the traded close. An unknown code is a 400 listing the covered markets.
Minimum trailing-twelve-month price-to-earnings ratio.
Maximum trailing-twelve-month price-to-earnings ratio (e.g. 15 for value screens).
Minimum trailing dividend yield in percent (e.g. 3 = 3%).
Maximum trailing dividend yield in percent.
Minimum revenue growth in percent, latest quarter vs the same quarter a year earlier.
Maximum revenue growth in percent, latest quarter vs the same quarter a year earlier.
Minimum gross margin in percent (0-100).
Maximum gross margin in percent (0-100).
Minimum trailing-3-month average daily dollar volume in USD (e.g. 5000000 = $5M/day).
Maximum trailing-3-month average daily dollar volume in USD.
Minimum trailing-twelve-month net income in USD (0 keeps profitable companies only).
Maximum trailing-twelve-month net income in USD.
Minimum institutional ownership: 13F shares over shares outstanding, in percent.
Maximum institutional ownership in percent.
Minimum percent of the stock's 13F filers holding it among their ten largest positions.
Maximum conviction share in percent.
Minimum crowding: shares held by high-turnover 13F filers and private-fund advisers, in percent of shares outstanding.
Maximum crowding in percent of shares outstanding.
Minimum ownership by 13F filers that advise private funds (Form ADV), in percent of shares outstanding.
Maximum private-fund adviser ownership in percent of shares outstanding.
Minimum like-for-like share change of actively managed 13F holders over the quarter, in percent.
Maximum like-for-like share change of actively managed 13F holders, in percent.
Minimum value-weighted holder tenure in quarters.
Maximum value-weighted holder tenure in quarters.
Minimum quarter-end price versus the holders' estimated average cost, in percent (negative means an estimated loss).
Maximum quarter-end price versus the holders' estimated average cost, in percent.
Sort key: marketcap, ticker, name, price, filers, filerdelta, sipct, dtc, squeeze, sentiment, insiderbuy, pe, divyield, revgrowth, grossmargin, dollarvol, netincome, instown, conv, crowd, pfown, actlfl, tenure, or costgap (default marketcap). An unknown key is a 400, never silently ignored.
Sort ascending instead of descending.
Maximum rows to return (default 50, max 200; zero or negative values are rejected, values above the maximum are clamped).
Result page, 1-based (default 1) — combine with limit to walk past the first page. A page past the end returns the last real page (see the response's page field).
Comma-separated list of up to 200 tickers to restrict the screen to, so a caller can score stocks they already hold instead of searching the market. Every other bound still applies. Class-share dots (BRK.B) resolve to the listed form and a secondary listing resolves to its issuer; symbols outside the universe come back in the response's notFound array.
Response format: omit or json for the JSON envelope, csv for a flat CSV file. CSV headers are the stable cols keys rather than display labels, and the envelope's paging metadata rides on the X-Screener-Total-Count, X-Screener-Page, X-Screener-Total-Pages, X-Screener-Not-Found and X-Screener-Not-Found-Count response headers. Any other value is a 400.
Comma-separated CSV column keys (for example pe,de,roic,volatility), applying only with format=csv; passing it without CSV is a 400 rather than a silently ignored parameter. An unknown or empty key list is a 400. Omitted means the default column set, and none means the pinned columns only. Every file starts with four pinned fields, ticker, name, price and marketcap, then one column per key passed; there is no ticker key of its own because the pinned company column emits ticker and name together.
Response
OK
Changes
No recorded changes to this operation across all 1 revision of this API.