Financial health scores chart

GET/api/financials/chart/scores

Returns chart-ready data for financial health scores over time: Piotroski F-Score (0–9) and Altman Z-Score. Annual periods only. Each period requires a prior year for Piotroski YoY comparisons, so internally fetches limit + 1 periods. Altman Z-Score may be null for periods with insufficient balance sheet data.

Get API key Try it live in the API explorer

Query parameters

symbol string optional min length 1 · max length 10

Stock ticker symbol. Identify the entity by exactly one of: symbol, cik, cusip, composite_figi, or share_class_figi. At least one is required.

Example: AAPL
cik integer optional

SEC Central Index Key (CIK).

Example: 320193
cusip string optional min length 9 · max length 9

CUSIP identifier (9 characters).

Example: 037833100
composite_figi string optional

Composite OpenFIGI identifier.

Example: BBG000B9XRY4
share_class_figi string optional

Share-class OpenFIGI identifier.

Example: BBG001S5N8V8
limit integer optional min 1 · max 80 · default 4

Maximum number of periods (may be clamped by subscription tier)

Example request

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

Responses

200 OK

Series-oriented chart data with periods sorted ascending

Response schema

periods array of string (date)
Reporting period end dates (YYYY-MM-DD), sorted ascending. Each entry corresponds index-wise to the values in every `series.data` array. Annual periods only.
series array of object
Always returns two entries — `Piotroski F-Score` (integer 0–9, higher is better) and `Altman Z-Score` (decimal; >2.99 = safe zone, 1.81–2.99 = grey zone, <1.81 = distress zone) — in that order. Altman Z-Score may be `null` for periods where required balance sheet items aren't tagged. Piotroski may be `null` only when the prior-year comparison values are missing.
array of:
- name string (enum)
  Allowed values: Piotroski F-Score, Altman Z-Score
- data array of number | null

Example response

{
  "periods": [
    "2016-09-26",
    "2017-09-26",
    "2018-09-26",
    "2019-09-26",
    "2020-09-26",
    "2021-09-26",
    "2022-09-26",
    "2023-09-26",
    "2024-09-26",
    "2025-09-26"
  ],
  "series": [
    {
      "name": "Piotroski F-Score",
      "data": [
        5,
        4,
        6,
        6,
        7,
        7,
        8,
        7,
        6,
        8
      ]
    },
    {
      "name": "Altman Z-Score",
      "data": [
        2.19,
        1.94,
        1.93,
        2.01,
        1.88,
        2.25,
        2.26,
        2.27,
        null,
        null
      ]
    }
  ]
}

400 Bad Request

Invalid parameters or symbol not found

Response schema

error string
Human-readable error message

Example response

{}

403 Forbidden

Feature not available on current plan

Response schema

error string
Human-readable error message

Example response

{}