Earnings quality score (Piotroski, Sloan, Beneish)

GET

/api/v1/equities/{symbol}/earnings-quality

Last modified:2026-07-19 17:02:27

Maintainer:Not configured

OperationId:equities_symbol_earnings_quality

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.

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Path Params

Query Params

Header Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

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.

Bodyapplication/json

Example

🟠400Bad Request

🟠401Unauthorized

🟠404Record Not Found

🟠422Parameter Error

🟠429

🔴502Bad Gateway

🔴503Service Unavailable

Modified at 2026-07-19 17:02:27

Two-stage DCF intrinsic value + sensitivity

Fundamental-ratio percentiles within the S&P 500 GICS sector