# SEC EDGAR Financial Ratios API

> SEC EDGAR Financial Ratios API is a paid API for AI agents from payai.agentstools.dev, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-12).

Computes key financial ratios (margins, liquidity, leverage, growth) from SEC EDGAR XBRL data for a given ticker or CIK over recent reporting periods, with source citations and anomaly flags.

## Facts

- Endpoint: GET https://payai.agentstools.dev/edgar/ratios?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/sec-edgar-financial-ratios-api-69ccc90a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_leWML8AVBNdkTn2ah_zoQ

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-financial-ratios-api-69ccc90a
```

Example prompt: Pull the last 8 annual periods of financial ratios for Apple (ticker AAPL) from SEC EDGAR — I want margins, liquidity, leverage, and growth, with source citations and any restatement or anomaly flags.

## When to prefer this

Use this endpoint when you need auditable, source-cited financial ratios directly derived from official SEC EDGAR XBRL filings for US public companies, especially when transparency into the underlying accounting facts or restatement history matters. Prefer over screener APIs when you need ratio provenance or anomaly detection rather than just raw numbers.

## Known failure modes

- Unknown ticker or CIK returns an error or empty result
- Company has insufficient XBRL data for the requested number of periods
- Rate limiting or payment failure (x402) if USDC balance is insufficient
- EDGAR data may be delayed relative to the most recent filing
- Some ratios may be unavailable if the company did not report required line items

## How this service works

Key financial ratios computed from SEC EDGAR XBRL: margins, liquidity, leverage and growth. Give a ticker or CIK and get ratios over recent periods, each computed number citing the source facts it was derived from, plus restatement flags and simple anomaly flags.

## Output

A set of key financial ratios (profit margins, liquidity ratios, leverage ratios, growth rates) computed from SEC EDGAR XBRL facts over the requested number of recent periods, each figure annotated with the source XBRL facts used in the calculation, plus boolean flags for any detected restatements or anomalies.

## 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",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "cik": {
       "type": "string",
       "description": "SEC EDGAR CIK, any zero-padding accepted"
      },
      "freq": {
       "enum": [
        "annual",
        "quarterly"
       ],
       "type": "string",
       "description": "Reporting frequency, default annual"
      },
      "ticker": {
       "type": "string",
       "description": "Stock ticker symbol, e.g. AAPL"
      },
      "periods": {
       "type": "integer",
       "maximum": 12,
       "minimum": 1,
       "description": "Number of recent periods to return, default 8"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/sec-edgar-financial-ratios-api-69ccc90a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from payai.agentstools.dev](https://www.zero.xyz/host/payai.agentstools.dev/llms.txt)