Compute standard financial ratios API

Profitability, liquidity, leverage, efficiency and valuation ratios from caller-supplied statements and an optional price. Missing fields yield null metrics; division by zero is reported.

The Compute standard financial ratios operation is part of the Equity Financial Ratios DCF Valuation API on BRAINIAC.software. Profitability, liquidity, leverage, efficiency and valuation ratios from caller-supplied statements and an optional price. Missing fields yield null metrics; division by zero is reported. It is exposed as POST /api/v1/equity-analytics/financial-ratios and priced at $0.03 USDC on Base. Payment uses the x402 exact scheme: an unpaid call returns HTTP 402 with payment requirements; after paying the exact USDC amount, retry the same request with a payment-signature header and Idempotency-Key. No account and no API key are required. Data sources for this product: Caller-supplied financial statements, prices, peer multiples and identifiers processed locally Altman Z-score (1968/1983/2000), Piotroski F-score (2000), Beneish M-score (1999) ISIN ISO 6166, CUSIP and SEDOL check digits; ISO 17442 LEI with ISO/IEC 7064 MOD 97-10 Limitations: Pure computation on caller input: no market data feed, statement database or identifier directory is called at request time. Identifier endpoints validate check digits and structure only; they do not confirm a security or LEI exists or is active. Screening scores (Altman, Piotroski, Beneish) and valuations are aids for human review, not investment advice or credit ratings. Money amounts on statements are decimals in one currency (often thousands); the unit string is echoed and is not converted. Outputs are compliance prechecks, drafts, or data lookups for human review. They are not official determinations, legal advice, identity confirmation, or certified filings. Related operations in this group include Two-stage discounted cash flow, Weighted average cost of capital, OLS equity beta vs a benchmark, Back-adjust prices for splits and dividends. Open the group documentation for the full request schema, field notes, and response examples before integrating.

POST$0.03 USDC
/api/v1/equity-analytics/financial-ratios

Example request

curl -i -X POST "https://www.brainiac.software/api/v1/equity-analytics/financial-ratios" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "statements": [
    {
      "period": "FY2025",
      "revenue": 1000,
      "cogs": 550,
      "ebit": 300,
      "interestExpense": 10,
      "netIncome": 250,
      "cfo": 280,
      "capex": 80,
      "totalAssets": 900,
      "currentAssets": 400,
      "currentLiabilities": 450,
      "totalLiabilities": 700,
      "longTermDebt": 250,
      "receivables": 82,
      "inventory": 40,
      "equity": 200,
      "sharesOutstanding": 38,
      "cash": 50
    }
  ],
  "price": 190.5,
  "unit": "USD thousands"
}
JSON

An unpaid probe returns HTTP 402 with x402 payment requirements. After paying the exact USDC amount on Base, retry the identical request with a payment-signature header.

FAQ

  • Do I need an API key? No. Pay the listed USDC amount with x402.
  • What network? Base (eip155:8453), USDC.
  • Is this an official determination? No. Results are for human review against the cited sources.

Related APIs

Equity Financial Ratios DCF Valuation APIFull docsHow it works