EDGAR Fundamental Scores

Endpoints (30 live)

• GET /v1/batch — Answer-shaped financial-health verdicts for a portfolio or watchlist in one paid call: for each ticker (query tickers=AAPL,MSFT,..., 1-50, deduplicated) returns verdict healthy/watch/distress, a one-line reason, the source 10-K filing link at SEC EDGAR, fraud-risk flag and fiscal year, in your order. Priced $0.002 per ticker (10 tickers = $0.02, 50 = $0.1); the 402 quotes the exact total. All tickers are validated before payment; tickers SEC has no usable XBRL for are listed under failed. Errors (0.002 USDC on Base)
• GET /v1/verdict/:ticker — Answer in one line: healthy / watch / distress, plus an earnings-manipulation (fraud-risk) flag low/elevated/unknown and a short reason, for any US public company. Built from Piotroski F-Score, Altman Z (industry-appropriate variant) and Beneish M-Score on the latest 10-K XBRL data at SEC EDGAR. Use for due diligence, credit screens, supplier/counterparty checks and stock research. Errors are never charged (bad tickers rejected before payment; failed calls not settled). (0.003 USDC on Base)
• GET /v1/quick/:ticker — Headline accounting-quality numbers for a US public company from its latest 10-K XBRL data at SEC EDGAR: Piotroski F-Score (0-9), Altman Z (Z' or Z'' by industry) with safe/grey/distress zone, Beneish M-Score with low/elevated flag, one-line summary. Compact JSON. Errors are never charged (bad tickers rejected before payment; failed calls not settled). (0.005 USDC on Base)
• GET /v1/scores/:ticker — Full accounting-quality report for a US public company from SEC EDGAR XBRL 10-K facts: all 9 Piotroski tests with values, Altman Z'/Z'' ratios and zone, all 8 Beneish indices with reliability, normalized statement inputs for current and prior year, source filing links and data-quality flags. Errors are never charged (bad tickers rejected before payment; failed calls not settled). (0.007 USDC on Base)
• GET /v1/insiders/:ticker — One-line verdict on insider trading at a US public company from SEC Form 4 filings, last 90 days (days=7-365): bullish_cluster / neutral / heavy_selling. Net open-market buys vs sells (codes P/S) in shares and dollars, distinct insiders, cluster-buying flag (3+ buyers in 30 days), notable officer buys, 10b5-1 planned vs discretionary selling, largest trades with filing links. Errors are never charged (bad tickers rejected before payment; failed calls not settled). (0.003 USDC on Base)
• GET /v1/history/:ticker — Up to 10 fiscal years of Piotroski F, Altman Z and Beneish M for a US public company, plus revenue, net income, operating cash flow and total assets per year from SEC EDGAR XBRL, and a Piotroski trend (improving/flat/deteriorating). Query years=1-10 (default 5). Errors are never charged (bad tickers rejected before payment; failed calls not settled). (0.008 USDC on Base)
• GET /v1/redflags/:ticker — Scans a US public company's SEC filings, last 365 days (days=30-730), for red-flag events: auditor change (8-K 4.01), non-reliance/restatement (4.02), bankruptcy (1.03), delisting notice (3.01), debt acceleration (2.04), material impairment (2.06), executive departures (5.02), late filing (NT 10-K/10-Q), deregistration, going-concern language. Returns flags with dates and filing links plus a severity verdict clean/low/medium/high/critical. Errors are never charged (bad tickers rejected before pa (0.003 USDC on Base)
• GET /v1/read — Fetch a public http(s) web page and get its readable main content (boilerplate, nav and ads stripped via Mozilla Readability) as plain text and markdown, plus title, description, byline, site name, language, published time, word count and up to 200 absolute links. HTML and text pages up to 2 MB; 15 s timeout; follows up to 5 redirects. Honours robots.txt for User-Agent FundamentalScoresReader. No logins, paywalls or JavaScript rendering. Bad URLs (400), private/internal hosts (400) and robots.tx (0.002 USDC on Base)
• GET /v1/extract — Give a public page URL plus field names (fields=title,price,currency,author,date,description,image,rating,availability,tables,emails,... any name) and/or a CSS-selector map (selectors={"price":".price","img":"img.hero@src","bullets[]":"ul.features li"}; "@attr" reads an attribute, a name ending in [] returns all matches as an array under the name without []). Returns {fields, sources, missing}: values come from JSON-LD, OpenGraph/meta tags, microdata, your selectors, then heuristics. Up to 25 fi (0.005 USDC on Base)
• GET /v1/distress-list — Daily-refreshed ranking of US exchange-listed (NYSE/Nasdaq/CBOE) operating companies with the worst combined distress: Altman Z, Piotroski F and Beneish M verdict risk points plus red-flag severity from recent filings (going concern, auditor change, restatement, delisting notice, late filing). Each row: ticker, distress score, verdict, fraud-risk, top red flags, F/Z/M. Query limit=1-100 (default 25). For short ideas, credit watchlists, risk monitoring. Errors are never charged (bad tickers rejec (0.005 USDC on Base)
• GET /v1/sample — Cheapest way to test this API and your x402 wallet. Returns the same one-line healthy/watch/distress verdict + fraud-risk flag as /v1/verdict, for one of these sample tickers: AAPL, MSFT, NVDA, TSLA, META, BRK-B, JPM, CVX, KO, SMCI (query ticker=, default AAPL). Data: SEC EDGAR 10-K XBRL. Errors are never charged (bad tickers rejected before payment; failed calls not settled). (0.001 USDC on Base)
• GET /v1/history/1 — Up to 10 fiscal years of Piotroski F, Altman Z and Beneish M for a US public company, plus revenue, net income, operating cash flow and total assets per year from SEC EDGAR XBRL, and a Piotroski trend (improving/flat/deteriorating). Query years=1-10 (default 5). Errors are never charged (bad tickers rejected before payment; failed calls not settled). (0.008 USDC on Base)
• GET /v1/redflags/1 — Scans a US public company's SEC filings, last 365 days (days=30-730), for red-flag events: auditor change (8-K 4.01), non-reliance/restatement (4.02), bankruptcy (1.03), delisting notice (3.01), debt acceleration (2.04), material impairment (2.06), executive departures (5.02), late filing (NT 10-K/10-Q), deregistration, going-concern language. Returns flags with dates and filing links plus a severity verdict clean/low/medium/high/critical. Errors are never charged (bad tickers rejected before pa (0.003 USDC on Base)
• GET /v1/insiders/1 — One-line verdict on insider trading at a US public company from SEC Form 4 filings, last 90 days (days=7-365): bullish_cluster / neutral / heavy_selling. Net open-market buys vs sells (codes P/S) in shares and dollars, distinct insiders, cluster-buying flag (3+ buyers in 30 days), notable officer buys, 10b5-1 planned vs discretionary selling, largest trades with filing links. Errors are never charged (bad tickers rejected before payment; failed calls not settled). (0.003 USDC on Base)
• GET /v1/scores/1 — Full accounting-quality report for a US public company from SEC EDGAR XBRL 10-K facts: all 9 Piotroski tests with values, Altman Z'/Z'' ratios and zone, all 8 Beneish indices with reliability, normalized statement inputs for current and prior year, source filing links and data-quality flags. Errors are never charged (bad tickers rejected before payment; failed calls not settled). (0.007 USDC on Base)
• GET /v1/quick/1 — Headline accounting-quality numbers for a US public company from its latest 10-K XBRL data at SEC EDGAR: Piotroski F-Score (0-9), Altman Z (Z' or Z'' by industry) with safe/grey/distress zone, Beneish M-Score with low/elevated flag, one-line summary. Compact JSON. Errors are never charged (bad tickers rejected before payment; failed calls not settled). (0.005 USDC on Base)
• GET /v1/verdict/1 — Answer in one line: healthy / watch / distress, plus an earnings-manipulation (fraud-risk) flag low/elevated/unknown and a short reason, for any US public company. Built from Piotroski F-Score, Altman Z (industry-appropriate variant) and Beneish M-Score on the latest 10-K XBRL data at SEC EDGAR. Use for due diligence, credit screens, supplier/counterparty checks and stock research. Errors are never charged (bad tickers rejected before payment; failed calls not settled). (0.003 USDC on Base)
• POST /v1/extract — Give a public page URL plus field names (fields=title,price,currency,author,date,description,image,rating,availability,tables,emails,... any name) and/or a CSS-selector map (selectors={"price":".price","img":"img.hero@src","bullets[]":"ul.features li"}; "@attr" reads an attribute, a name ending in [] returns all matches as an array under the name without []). Returns {fields, sources, missing}: values come from JSON-LD, OpenGraph/meta tags, microdata, your selectors, then heuristics. Up to 25 fi (0.005 USDC on Base)
• GET /v1/history/AAPL (0.008 USDC on Base)
• GET /v1/extract (0.005 USDC on Base)

+10 more endpoints.