# AnswerPool SEC XBRL Financial Ratios

> AnswerPool SEC XBRL Financial Ratios is a paid API for AI agents from answerpool.io, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-15).

Computes key financial ratios (net margin, debt-to-equity, etc.) from SEC EDGAR XBRL filings for any public US company, returned as structured JSON with full provenance.

## Facts

- Endpoint: GET https://answerpool.io/v1/sec/xbrl/ratios
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/answerpool-sec-xbrl-financial-ratios-c844c1a8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Bd3muDf9Y4vP8PL_gz3_k

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 answerpool-sec-xbrl-financial-ratios-c844c1a8
```

Example prompt: Pull the latest financial ratios for NVIDIA — net margin, debt-to-equity, and anything else computed from their most recent 10-K SEC filing.

## When to prefer this

Choose this endpoint when you need structured, computation-ready financial ratios derived directly from SEC EDGAR XBRL data with full provenance and per-metric sourcing. Prefer it over scraping financial data sites when you need machine-readable JSON with numerator/denominator transparency, or when building automated pipelines that require traceable, as-filed figures rather than third-party-adjusted numbers.

## Known failure modes

- Unknown ticker returns HTTP 422 with error detail
- CIK not found in EDGAR returns 422
- Both cik and ticker provided simultaneously returns 422 (provide exactly one)
- Company has not filed XBRL data — ratios return null for affected fields
- Fiscal period mismatch causes individual ratio values to be null rather than cross-year mixed
- Payment failure or insufficient credits returns 402 Payment Required

## How this service works

AnswerPool turns SEC EDGAR, the Federal Register, USAspending, NIH, BLS and OpenAlex into structured JSON answers that AI agents and developers fetch in one call. 69 endpoints free, no account; derived analyses $0.02–$0.05 per call by card credits or USDC (x402). MCP server, full provenance.

## Output

Returns a JSON object containing an array of computed financial ratios (e.g. net_margin_pct, debt_to_equity) each with the ratio name, numeric value, definition, and the underlying numerator/denominator metric names and values. Also includes the company CIK, fiscal period end date, computation method identifier, as-of timestamp, a disclaimer, and a list of any missing inputs that caused nulls.

## 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",
     "title": "RatiosIn",
     "properties": {
      "cik": {
       "anyOf": [
        {
         "type": "string",
         "pattern": "^\\d{1,10}$",
         "maxLength": 10
        },
        {
         "type": "null"
        }
       ],
       "title": "Cik",
       "default": null,
       "description": "SEC CIK, 1-10 digits, zero padding optional (e.g. 320193 or 0000320193). Provide exactly one of cik or ticker."
      },
      "ticker": {
       "anyOf": [
        {
         "type": "string",
         "maxLength": 12
        },
        {
         "type": "null"
        }
       ],
       "title": "Ticker",
       "default": null,
       "description": "US exchange ticker, case-insensitive (e.g. AAPL); resolved through the EDGAR ticker map, and an unknown ticker returns 422. Provide exactly one of ticker or cik."
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "cik": "0001045810",
  "note": "Every ratio is computed from values sharing one fiscal period end, so a ratio is null when either input was not reported for that period rather than mixed across years. Percentages are percent, debt_to_equity is a multiple. Figures as filed.",
  "as_of": "2026-09-03T14:30:00Z",
  "method": "sec_xbrl_ratios_rules_v1",
  "ratios": [
   {
    "ratio": "net_margin_pct",
    "value": 55.85,
    "definition": "Net income / revenue",
    "as_multiple": false,
    "numerator_value": 72880000000,
    "numerator_metric": "net_income",
    "denominator_value": 130497000000,
    "denominator_metric": "revenue"
   }
  ],
  "disclaimer": "Derived from public SEC EDGAR filings; not investment advice.",
  "period_end": "2025-01-26",
  "period_source": "latest fiscal year end reported on Form 10-K for every input used",
  "inputs_missing": []
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/answerpool-sec-xbrl-financial-ratios-c844c1a8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from answerpool.io](https://www.zero.xyz/host/answerpool.io/llms.txt)