SEC financial-statement health diagnostic + Piotroski F-Score API

Financial-statement health diagnostic for a US public company, computed from its own SEC EDGAR XBRL 10-K filings (keyless, authoritative). Resolves a ticker or CIK, pulls the latest two annual periods, and returns the key financials (revenue, net income, assets, liabilities, equity, current assets/liabilities, long-term debt, operating cash flow, diluted EPS, diluted shares) plus derived ratios (net margin, gross margin, ROE, ROA, debt-to-equity, current ratio, accrual ratio, YoY revenue & earnings growth). The value-add over a raw numbers dump: it scores fundamental health into a 0-9 Piotroski F-Score with a per-signal breakdown, an earnings-quality call from the accrual ratio, machine-readable reason codes, and a STRONG / NEUTRAL / WEAK verdict with a narrative. Answers 'Is this company fundamentally improving or deteriorating?', 'What is AAPL's Piotroski F-Score?', 'Is this company's profit backed by cash?', 'Give me the financials and a health verdict for this ticker.'.

Price$0.2per request

MethodPOST

Route/v1/finance/sec-financials

StatusLive

MIME typeapplication/json

Rate limit60/minute

Cache86400s public

financesecedgarxbrlfundamentalspiotroskif-scorefinancial-healthratiosearnings-quality

API URLhttps://x402.hexl.dev/v1/finance/sec-financials

Integration docs

Example request

{
  "ticker": "AAPL"
}

Example response

{
  "ticker": "AAPL",
  "cik": "0000320193",
  "company": "Apple Inc.",
  "currency": "USD",
  "fiscalYear": 2025,
  "fiscalPeriodEnd": "2025-09-27",
  "form": "10-K",
  "priorFiscalYear": 2024,
  "financials": {
    "revenue": 416161000000,
    "grossProfit": 195201000000,
    "netIncome": 112010000000,
    "assets": 359241000000,
    "liabilities": 285508000000,
    "stockholdersEquity": 73733000000,
    "currentAssets": 147957000000,
    "currentLiabilities": 165631000000,
    "longTermDebt": 78328000000,
    "operatingCashFlow": 111482000000,
    "epsDiluted": 7.46,
    "sharesDiluted": 15004697000
  },
  "ratios": {
    "netMargin": 0.2692,
    "grossMargin": 0.4691,
    "returnOnEquity": 1.5191,
    "returnOnAssets": 0.3118,
    "debtToEquity": 3.8722,
    "currentRatio": 0.8933,
    "accrualRatio": 0.0015,
    "revenueGrowthYoY": 0.0643,
    "earningsGrowthYoY": 0.195
  },
  "fScore": 8,
  "fScoreMax": 9,
  "fScoreSignals": [
    {
      "code": "POSITIVE_ROA",
      "label": "Positive return on assets",
      "point": 1,
      "detail": "ROA 31.2%"
    },
    {
      "code": "ACCRUAL_QUALITY",
      "label": "Cash flow exceeds net income (low accruals)",
      "point": 0,
      "detail": "CFO 111482000000 vs NI 112010000000"
    },
    {
      "code": "NO_DILUTION",
      "label": "No share dilution YoY",
      "point": 1,
      "detail": "diluted shares 15408095000 -> 15004697000"
    }
  ],
  "earningsQuality": "moderate",
  "verdict": "STRONG",
  "reasonCodes": [
    "HIGH_LEVERAGE",
    "LIQUIDITY_STRAIN",
    "STRONG_FUNDAMENTALS"
  ],
  "narrative": "STRONG: solid fundamental health (F-Score 8/9). Net margin 26.9%, ROE 151.9%. Earnings quality: moderate.",
  "disclaimer": "Best-effort financial-health diagnostic computed from a company's own SEC 10-K XBRL filings. Ratios and the Piotroski F-Score are mechanical and backward-looking; missing XBRL tags are scored conservatively as 0. NOT investment advice and not a recommendation to buy or sell. Verify against the filing."
}

Input schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "US-listed ticker symbol (e.g. 'AAPL'). Either ticker or cik is required."
    },
    "cik": {
      "type": "string",
      "description": "SEC CIK number (1-10 digits, with or without leading zeros). Alternative to ticker."
    }
  },
  "examples": [
    {
      "ticker": "AAPL"
    },
    {
      "cik": "320193"
    }
  ]
}

Output schema

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