{"insights":[{"name":"top_companies","path":"/insight/top_companies","price":"$0.15","description":"Rank US public companies by any metric for a fiscal year, optionally within an industry.","params":{"metric":"revenue","fy":"optional integer; defaults to the current fiscal year, selected from the data (the newest year with enough filers). The year used is returned as fiscal_year in the response. A year with no data is a 422 listing the available years.","industry":"73 (optional, 2-digit SIC)","limit":25}},{"name":"movers","path":"/insight/movers","price":"$0.15","description":"Companies with the largest change in a metric between two fiscal years (min revenue filter). The years compared are returned as fiscal_year_from and fiscal_year_to; a year with no data for the metric is a 422 listing the available years.","params":{"metric":"gross_margin","fy":"optional integer; the default for fy_to (and fy_from = fy - 2). Defaults to the current fiscal year, selected from the data","fy_from":"optional integer; defaults to fy - 2","fy_to":"optional integer; defaults to fy","min_revenue":1000000000.0,"limit":20}},{"name":"sector_landscape","path":"/insight/sector_landscape","price":"$0.15","description":"Median gross/operating/net margins and company counts per 2-digit SIC industry group (groups with fewer than 5 companies above min_revenue are omitted).","params":{"fy":"optional integer; defaults to the current fiscal year, selected from the data (the newest year with enough filers). The year used is returned as fiscal_year in the response. A year with no data is a 422 listing the available years.","min_revenue":100000000.0}},{"name":"metric_trend","path":"/insight/metric_trend","price":"$0.15","description":"Yearly time series of a metric aggregated across all filers (sum, median or mean). The range is returned as fiscal_year_from and fiscal_year_to; a range with no data for the metric is a 422 listing the available years.","params":{"metric":"research_development","agg":"sum","fy":"optional integer; the default for fy_to. Defaults to the current fiscal year, selected from the data","fy_from":"optional integer; defaults to 2015, or to fy_to when that is earlier. fy_from after fy_to is a 422","fy_to":"optional integer; defaults to fy"}},{"name":"capital_returns","path":"/insight/capital_returns","price":"$0.15","description":"Buybacks vs dividends totals by company size bucket for a fiscal year.","params":{"fy":"optional integer; defaults to the current fiscal year, selected from the data (the newest year with enough filers). The year used is returned as fiscal_year in the response. A year with no data is a 422 listing the available years."}},{"name":"filing_velocity","path":"/insight/filing_velocity","price":"$0.15","description":"Monthly filing counts for a form type — news-flow and disclosure-activity proxy.","params":{"form":"8-K","months":18,"fy":"not applicable (ignored)"}},{"name":"buffett_scan","path":"/insight/buffett_scan","price":"$0.25","description":"Quality Score (0-100) over a 10-year window: return on invested capital (30, blended 60/40 with the company's industry percentile), durability through the cycle (20), cash conversion (20), balance-sheet strength (15) and capital discipline (15). Continuous scoring, so results discriminate at the top instead of bunching. Every component is explainable from the returned row. Companies that stopped filing (4,313), have fewer than five fiscal years on file (1,702), lack the tags to measure returns on capital in enough of those years — missing EBIT tags, or an unclassified balance sheet, common among homebuilders and industrials with captive finance arms (1,612) — or are balance-sheet financials (1,539) are not scored and do not appear: 2,885 of 12,051 companies (roughly a quarter of all filers, ~37% of active ones) are scored today. Methodology v3; research signal, not investment advice.","params":{"fy":"optional, defaults to the published fiscal year (returned as fiscal_year in the response); a year that isn't published is a 422 listing the published years","min_score":60,"min_revenue":1000000000.0,"industry":"73 (optional)","exclude_foreign":"true (default; set false to include 20-F foreign private issuers)","limit":25}},{"name":"heavy_shorting","path":"/insight/heavy_shorting","price":"$0.15","description":"Companies under the heaviest short-selling pressure by FINRA daily short-volume ratio (short volume / total volume) over the trailing window — a bearish-sentiment / squeeze-setup proxy. This is daily short-sale VOLUME, not bi-monthly short interest / float. Not investment advice.","params":{"min_total_volume":50000000.0,"limit":25,"fy":"not applicable (ignored)"}},{"name":"top_signals","path":"/insight/top_signals","price":"$0.25","description":"Composite factor scorecard across all US public companies, fusing five independent evidence sources: quality (Piotroski/Altman/accruals), value (owner-earnings DCF), insider conviction (Form 4 open-market buying as bps of market cap), institutional positioning (13F holder change), and short sentiment (FINRA short-volume percentile within industry). Scored only on the factors available per company and renormalized, so missing data does not drag results down; `coverage` reports how much of the factor set was present. Weights are caller-overridable. RESEARCH SIGNAL, NOT INVESTMENT ADVICE.","params":{"min_coverage":0.6,"min_composite":0,"limit":25,"weights":"{\"quality\":0.2,\"value\":0.2,\"insider\":0.2,\"institutional\":0.2,\"sentiment\":0.2}","fy":"not applicable (ignored)"}},{"name":"institutional_accumulation","path":"/insight/institutional_accumulation","price":"$0.15","description":"Companies gaining (or, with direction=distributing, losing) the most 13F institutional holders quarter-over-quarter — net new institutions initiating or exiting positions. Ranked by holder_change (robust); aggregate share_change_pct is returned but noisy due to 13F filer-coverage drift. 45-day reporting lag; long-only. Not investment advice.","params":{"direction":"accumulating","min_holders":10,"limit":25,"fy":"not applicable (ignored)"}},{"name":"insider_buying","path":"/insight/insider_buying","price":"$0.15","description":"Companies with the strongest recent open-market insider buying: cluster purchases (transaction code P) by officers and directors, excluding 10%-owner funds and pre-planned 10b5-1 sales. Ranked by number of distinct buyers then dollar value. Insider cluster-buying is a well-studied positive signal; not investment advice.","params":{"months":6,"min_buyers":2,"limit":25,"fy":"not applicable (ignored)"}},{"name":"piotroski","path":"/insight/piotroski","price":"$0.15","description":"Piotroski F-Score (0-9): nine fundamental signals of financial strength (Piotroski 2000). High scores flag improving, high-quality companies. Returns ranked companies with each component. Not advice.","params":{"fy":"optional integer. Omit it to get every active company scored on its own latest fiscal year (these differ across companies: each row carries fiscal_year, and the response's fiscal_year is null). With fy: fy selects the cohort of companies whose latest scored fiscal year is fy; it does not re-score companies on an earlier year (the response's fiscal_year is fy). A year no company is scored on is a 422 listing the available years and their company counts.","min_score":7,"min_revenue":1000000000.0,"exclude_foreign":"true","limit":25}},{"name":"altman_z","path":"/insight/altman_z","price":"$0.15","description":"Altman Z-Score bankruptcy/distress screen (Altman 1968). Zones: >2.99 safe, 1.81-2.99 grey, <1.81 distress. Defaults to most distressed first. Requires market cap (price ETL). Classic form; banks/insurers flagged.","params":{"fy":"optional integer. Omit it to get every active company scored on its own latest fiscal year (these differ across companies: each row carries fiscal_year, and the response's fiscal_year is null). With fy: fy selects the cohort of companies whose latest scored fiscal year is fy; it does not re-score companies on an earlier year (the response's fiscal_year is fy). A year no company is scored on is a 422 listing the available years and their company counts.","zone":"distress (optional)","min_revenue":1000000000.0,"limit":25}},{"name":"beneish_m","path":"/insight/beneish_m","price":"$0.15","description":"Beneish M-Score (Beneish 1999): an accounting-quality signal. M above -1.78 is 'elevated' and warrants scrutiny, but most often reflects rapid growth, acquisitions or accounting changes — NOT manipulation. Returns elevated companies by default (level=all for every score). Ratio inputs winsorized; active filers only. A screening prompt, not an accusation and not investment advice.","params":{"fy":"optional integer. Omit it to get every active company scored on its own latest fiscal year (these differ across companies: each row carries fiscal_year, and the response's fiscal_year is null). With fy: fy selects the cohort of companies whose latest scored fiscal year is fy; it does not re-score companies on an earlier year (the response's fiscal_year is fy). A year no company is scored on is a 422 listing the available years and their company counts.","level":"elevated","min_revenue":1000000000.0,"limit":25}},{"name":"magic_formula","path":"/insight/magic_formula","price":"$0.15","description":"Greenblatt Magic Formula rank: combines earnings yield (EBIT/EV) and return on capital across the priced non-financial universe. Rank 1 = best. Companies tied on the combined rank are ordered by ascending CIK. Ranks are computed once across that whole universe (each company on its own latest scored fiscal year), so results filtered by fy keep those ranks and can skip numbers. Requires market cap (price ETL). Not advice.","params":{"fy":"optional integer. Omit it to get every active company scored on its own latest fiscal year (these differ across companies: each row carries fiscal_year, and the response's fiscal_year is null). With fy: fy selects the cohort of companies whose latest scored fiscal year is fy; it does not re-score companies on an earlier year (the response's fiscal_year is fy). A year no company is scored on is a 422 listing the available years and their company counts.","min_revenue":1000000000.0,"exclude_foreign":"true","limit":25}},{"name":"accruals","path":"/insight/accruals","price":"$0.15","description":"Sloan accrual ratio (earnings quality; Sloan 1996): (net income - operating cash flow) / assets. Lower = higher-quality earnings. Set worst=true for the highest-accrual (lowest-quality) companies.","params":{"fy":"optional integer. Omit it to get every active company scored on its own latest fiscal year (these differ across companies: each row carries fiscal_year, and the response's fiscal_year is null). With fy: fy selects the cohort of companies whose latest scored fiscal year is fy; it does not re-score companies on an earlier year (the response's fiscal_year is fy). A year no company is scored on is a 422 listing the available years and their company counts.","worst":"false","min_revenue":1000000000.0,"limit":25}},{"name":"buffett_value","path":"/insight/buffett_value","price":"$0.25","description":"Buffett Value Scan: Quality Score (0-100 over a 10-year window: return on invested capital, durability, cash conversion, balance-sheet strength, capital discipline — see buffett_scan) combined with previous-close valuation — market cap, FCF yield, owner-earnings yield, P/E, and a 10y owner-earnings DCF margin of safety. combined_score = mean of quality (0-100) and value (0-100); ties broken by revenue. Requires EOD price data. Foreign private issuers (20-F filers: Chinese ADRs etc) are excluded by default — they screen cheap for structural reasons fundamentals cannot see. Methodology v3; heuristic screen, not investment advice.","params":{"fy":"optional, defaults to the published fiscal year (returned as fiscal_year in the response); a year that isn't published is a 422 listing the published years","min_score":60,"min_revenue":1000000000.0,"min_margin_of_safety":0.15,"industry":"73 (optional)","exclude_foreign":"true (default; set false to include 20-F foreign private issuers)","limit":25}}]}