Piotroski F-Score (9 tests) API

Compute the Piotroski F-Score (2000), a 0-9 score from nine binary fundamentals tests across profitability (ROA, CFO, dROA, accruals), leverage/liquidity (dLeverage, dCurrentRatio, no new shares), and efficiency (dGrossMargin, dAssetTurnover), with a strong/moderate/weak rating and a per-test pass/points breakdown. Answers 'Piotroski F-Score for this stock','is this a financially strong value stock','9-point fundamentals score'.

Price$0.016per request

MethodPOST

Route/v1/score/credit-piotroski-f

StatusLive

MIME typeapplication/json

Rate limit120/minute

CacheNo cache

scorecreditpiotroskif-scorefundamentalsvalueprofitabilityequity

API URLhttps://x402.hexl.dev/v1/score/credit-piotroski-f

Integration docs

Example request

{
  "netIncome": 100,
  "totalAssets": 1000,
  "totalAssetsPrior": 950,
  "cashFlowOps": 150,
  "roaPrior": 0.08,
  "longTermDebt": 200,
  "longTermDebtPrior": 250,
  "currentRatio": 2,
  "currentRatioPrior": 1.8,
  "sharesOutstanding": 100,
  "sharesOutstandingPrior": 100,
  "grossMargin": 0.4,
  "grossMarginPrior": 0.38,
  "assetTurnover": 1.1,
  "assetTurnoverPrior": 1
}

Example response

{
  "model": "Piotroski F-Score (2000)",
  "fScore": 9,
  "maxScore": 9,
  "rating": "strong",
  "interpretation": "Financially strong; value signal",
  "breakdown": [
    {
      "test": "ROA > 0",
      "pass": true,
      "points": 1
    },
    {
      "test": "Operating cash flow > 0",
      "pass": true,
      "points": 1
    },
    {
      "test": "ROA improved YoY",
      "pass": true,
      "points": 1
    },
    {
      "test": "Accruals: CFO/TA > ROA",
      "pass": true,
      "points": 1
    },
    {
      "test": "Leverage (LTD/TA) decreased",
      "pass": true,
      "points": 1
    },
    {
      "test": "Current ratio improved",
      "pass": true,
      "points": 1
    },
    {
      "test": "No new shares issued",
      "pass": true,
      "points": 1
    },
    {
      "test": "Gross margin improved",
      "pass": true,
      "points": 1
    },
    {
      "test": "Asset turnover improved",
      "pass": true,
      "points": 1
    }
  ]
}

Input schema

{
  "type": "object",
  "required": [
    "netIncome",
    "totalAssets",
    "totalAssetsPrior",
    "cashFlowOps",
    "roaPrior",
    "longTermDebt",
    "longTermDebtPrior",
    "currentRatio",
    "currentRatioPrior",
    "sharesOutstanding",
    "sharesOutstandingPrior",
    "grossMargin",
    "grossMarginPrior",
    "assetTurnover",
    "assetTurnoverPrior"
  ],
  "properties": {
    "netIncome": {
      "type": "number",
      "examples": [
        100
      ]
    },
    "totalAssets": {
      "type": "number",
      "examples": [
        1000
      ]
    },
    "totalAssetsPrior": {
      "type": "number",
      "examples": [
        950
      ]
    },
    "cashFlowOps": {
      "type": "number",
      "description": "Cash flow from operations",
      "examples": [
        150
      ]
    },
    "roaPrior": {
      "type": "number",
      "description": "Prior-year ROA (decimal)",
      "examples": [
        0.08
      ]
    },
    "longTermDebt": {
      "type": "number",
      "examples": [
        200
      ]
    },
    "longTermDebtPrior": {
      "type": "number",
      "examples": [
        250
      ]
    },
    "currentRatio": {
      "type": "number",
      "examples": [
        2
      ]
    },
    "currentRatioPrior": {
      "type": "number",
      "examples": [
        1.8
      ]
    },
    "sharesOutstanding": {
      "type": "number",
      "examples": [
        100
      ]
    },
    "sharesOutstandingPrior": {
      "type": "number",
      "examples": [
        100
      ]
    },
    "grossMargin": {
      "type": "number",
      "description": "Gross margin (decimal)",
      "examples": [
        0.4
      ]
    },
    "grossMarginPrior": {
      "type": "number",
      "examples": [
        0.38
      ]
    },
    "assetTurnover": {
      "type": "number",
      "examples": [
        1.1
      ]
    },
    "assetTurnoverPrior": {
      "type": "number",
      "examples": [
        1
      ]
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}