Earnings quality score (Piotroski, Sloan, Beneish)
First-party earnings-quality analytics computed from SEC EDGAR XBRL companyfacts (annual filings 10-K/20-F/40-F). Three published academic models with the full methodology disclosed in the payload: Piotroski (2000) F-score with ROA and turnover scaled by beginning-of-year assets; Sloan (1996) accruals in the cash-flow-statement form (Hribar-Collins 2002); Beneish (1999) M-score M8 and M5 with simplified AQI and neutral-1.0 handling of uncomputable indices. Composite 0-100 = 0.40 Piotroski + 0.30 Sloan + 0.30 Beneish, weights renormalized over available components (2 of 3 required), letter bands A >= 80 / B / C / D / F < 35. The Beneish verdict additionally travels as a SEPARATE manipulation_flag (GREEN / GRAY / RED / UNKNOWN / NOT_APPLICABLE) so it is never diluted by a good F-score. ANNUAL only by construction. Financial issuers (SIC 6000-6999): Sloan and Beneish suppressed, Piotroski degrades to 5 defensible signals, no composite letter. MODEL ESTIMATE derived from public filings - DESCRIPTIVE analytics, not investment advice.
Path parameters
Ticker symbol.
Ticker symbol.
Query parameters
Fiscal years to score, newest first. Rows need a prior-year baseline, so years_available may be lower than requested.
Fiscal years to score, newest first. Rows need a prior-year baseline, so years_available may be lower than requested.
Response
Per fiscal year: Piotroski F-score (9 disclosed signals), Sloan accruals ratio, Beneish M-score (8 disclosed indices), an open 0.40/0.30/0.30 composite with letter grade, and a separate manipulation flag.
Example response
{
"data": {
"symbol": "AAPL",
"periods": [
{
"fiscal_year_end": "2025-12-31",
"piotroski": {
"status": "ok"
}
}
]
},
"meta": {
"endpoint": "/api/v1/fred/us/cpi",
"data_time": "2026-04-16T14:30:00Z",
"response_time": "2026-04-16T14:30:12Z",
"provider": "Sugra API v1.0.1",
"source": "sugra_crypto",
"attribution": "Short interest and Reg SHO daily short volume data is owned by and sourced from FINRA (Financial Industry Regulatory Authority).",
"fallback_chain": [
"sugra_crypto",
"sugra_finance"
]
}
}