Dashboard

Financial health scores

GET/api/financials/scores

Starter Pro

Returns two well-known financial health scores computed from the company's most recent annual filings:

Piotroski F-Score (0-9): A composite score measuring financial strength across 9 binary criteria in three categories:

Category Criteria Signal
Profitability Positive net income +1
Profitability Positive operating cash flow +1
Profitability Rising return on assets (YoY) +1
Profitability Cash flow exceeds net income (earnings quality) +1
Leverage Declining debt-to-assets ratio (YoY) +1
Leverage Rising current ratio (YoY) +1
Leverage No share dilution (YoY) +1
Efficiency Rising gross margin (YoY) +1
Efficiency Rising asset turnover (YoY) +1

Scores 7-9 indicate strong financial health; 0-3 indicate weakness.

Altman Z-Score: A bankruptcy prediction model using 5 weighted ratios: Z = 1.2×(Working Capital/Assets) + 1.4×(Retained Earnings/Assets) + 3.3×(EBIT/Assets) + 0.6×(Equity/Liabilities) + 1.0×(Revenue/Assets)

Zone Z-Score Interpretation
Safe > 2.99 Low bankruptcy risk
Grey 1.81 - 2.99 Moderate risk, needs monitoring
Distress < 1.81 High bankruptcy risk

Note: The equity component uses book value of equity as a proxy (market capitalization is not available).

Get API key Try it live in the API explorer

Query parameters

Example request

curl 'https://api.stockfit.io/v1/api/financials/scores?symbol=AAPL&cik=320193&cusip=037833100&composite_figi=BBG000B9XRY4&share_class_figi=BBG001S5N8V8' \
  -H 'Authorization: Bearer YOUR_API_TOKEN'

Responses

200 OK

Financial health scores from the most recent annual filing

Response schema

  • period string

    The fiscal year end date used for computation

  • fiscalYear integer

    The company's fiscal year (handles non-December year-ends, AAPL FY ends Sep, COST FY ends Aug).

  • fiscalPeriod string (enum)

    Fiscal period of a reported value: `FY` (annual), `Q1`-`Q4` (quarterly), or `TTM` (trailing twelve months).

    Allowed values: FY, Q1, Q2, Q3, Q4, TTM
  • piotroskiFScore integer min 0 · max 9

    Piotroski F-Score (0-9)

  • piotroskiDetails object

    Individual Piotroski criteria results

    • positiveNetIncome boolean
    • positiveOperatingCashFlow boolean
    • risingRoa boolean
    • cashFlowExceedsNetIncome boolean
    • decliningLeverage boolean
    • risingCurrentRatio boolean
    • noShareDilution boolean
    • risingGrossMargin boolean
    • risingAssetTurnover boolean
  • altmanZScore number | null

    Altman Z-Score (null if insufficient data)

  • altmanZone string (enum) | null

    Altman Z-Score classification: `safe`, `grey`, or `distress`.

    Allowed values: safe, grey, distress

Example response

{
  "period": "2024-09-28",
  "fiscalYear": 2025,
  "fiscalPeriod": "FY",
  "piotroskiFScore": 7,
  "piotroskiDetails": {
    "positiveNetIncome": true,
    "positiveOperatingCashFlow": true,
    "risingRoa": true,
    "cashFlowExceedsNetIncome": true,
    "decliningLeverage": false,
    "risingCurrentRatio": true,
    "noShareDilution": true,
    "risingGrossMargin": true,
    "risingAssetTurnover": false
  },
  "altmanZScore": 4.12,
  "altmanZone": "safe"
}

400 Bad Request

Invalid parameters, symbol not found, or company has no annual financial filings (e.g. SPACs, shell companies, pre-revenue companies)

Response schema

  • error string

    Human-readable error message

Example response

{
  "error": "Error description goes here"
}

403 Forbidden

Feature not available on current plan

Response schema

  • error string

    Human-readable error message

Example response

{
  "error": "Error description goes here"
}