# SEC EDGAR TTM Financial Ratio Engine

> SEC EDGAR TTM Financial Ratio Engine is a paid API for AI agents from mtbandy--sec-ratio-engine-serve-app.modal.run, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-15).

Calculates 9 trailing-twelve-month (TTM) financial ratios for a US-listed stock from live SEC EDGAR XBRL filings, given a ticker and current stock price.

## Facts

- Endpoint: GET https://mtbandy--sec-ratio-engine-serve-app.modal.run/ratios
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/sec-edgar-ttm-financial-ratio-engine-727b30be
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_egVpuxx1w6eWnnvmgWFh9

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability sec-edgar-ttm-financial-ratio-engine-727b30be
```

Example prompt: Pull the 9 TTM financial ratios for NVDA from SEC EDGAR filings — the current stock price is $134.50.

## When to prefer this

Choose this endpoint when you need TTM financial ratios sourced directly from official SEC EDGAR XBRL filings with full accession audit trails, rather than scraped or third-party-aggregated data. It is ideal for US-listed equities with US-GAAP reporting. Prefer it over generic financial data APIs when auditability, regulatory-grade sourcing, and trailing-twelve-month accuracy are required. Not suitable for financial institutions (banks, insurers) or foreign IFRS filers where taxonomy coverage is limited.

## Known failure modes

- Null returned for specific ratios when balance sheet items are unclassified (common for banks and insurance companies)
- Null returned for IFRS ADRs that lack US-GAAP XBRL taxonomy tags
- Invalid or unrecognized ticker symbol returns an error or empty result
- Stock price not provided causes computation of price-dependent ratios to fail
- EDGAR XBRL data may lag a few days after a new filing is published

## How this service works

Calculates 9 TTM financial ratios (P/E, P/OCF, P/FCF, P/B, EV/EBITDA, ROIC %, Debt/Equity, Current Ratio, Interest Coverage) directly from official SEC EDGAR XBRL filings with accession audit trails. Disclosures: Financial institutions and IFRS ADRs return null for unclassified balance sheet or missing US-GAAP taxonomy tags.

## Output

Returns a JSON object containing up to 9 TTM financial ratios (P/E, P/OCF, P/FCF, P/B, EV/EBITDA, ROIC %, Debt/Equity, Current Ratio, Interest Coverage), each linked to the underlying SEC EDGAR accession numbers used in the calculation. Null values are returned for ratios that cannot be computed due to missing US-GAAP taxonomy tags (common for financial institutions and IFRS ADRs).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "method": {
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "ticker",
      "price"
     ],
     "properties": {
      "price": {
       "type": "number",
       "description": "Required: Current stock price in USD"
      },
      "ticker": {
       "type": "string",
       "description": "Required: Stock ticker symbol (e.g. AAPL, MSFT, NVDA)"
      }
     }
    }
   }
  },
  "output": {
   "type": "object",
   "properties": {
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/sec-edgar-ttm-financial-ratio-engine-727b30be/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from mtbandy--sec-ratio-engine-serve-app.modal.run](https://www.zero.xyz/host/mtbandy--sec-ratio-engine-serve-app.modal.run/llms.txt)