XBRL Financial Ratios API: Margins, returns, leverage and R&D/capex intensity for a company — SEC XBRL

Margins, returns, leverage and R&D/capex intensity for a company from filed XBRL, every ratio period-aligned with its inputs shown and nulled rather than mixed across fiscal years.

$0.05 per call — pay with prepaid card credits (Authorization: Bearer ck_live_…, packs from $1) or with USDC over x402: call it, get 402 with the price, retry signed. Failed calls are never charged.

How do you call it?

GET /v1/sec/xbrl/ratios — product id sec_xbrl_ratios. Over MCP, call answerpool_get with product_id=sec_xbrl_ratios.

curl "https://answerpool.io/v1/sec/xbrl/ratios?ticker=NVDA"

# with a prepaid credit key
curl -H "Authorization: Bearer ck_live_..." "https://answerpool.io/v1/sec/xbrl/ratios?ticker=NVDA"

Live call: https://answerpool.io/v1/sec/xbrl/ratios?ticker=NVDA · JSON sample: /v1/samples/sec_xbrl_ratios

What does the answer look like?

A representative response, the same static sample served at /v1/samples/sec_xbrl_ratios.

ratios

{
 "as_of": "2026-09-03T14:30:00Z",
 "cik": "0001045810",
 "period_end": "2025-01-26",
 "period_source": "latest fiscal year end reported on Form 10-K for every input used",
 "ratios": [
  {
   "ratio": "net_margin_pct",
   "value": 55.85,
   "as_multiple": false,
   "numerator_metric": "net_income",
   "denominator_metric": "revenue",
   "numerator_value": 72880000000.0,
   "denominator_value": 130497000000.0,
   "definition": "Net income / revenue"
  }
 ],
 "inputs_missing": [],
 "method": "sec_xbrl_ratios_rules_v1",
 "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.",
 "disclaimer": "Derived from public SEC EDGAR filings; not investment advice.",
 "refresh_after": "2026-09-17T11:15:00.000Z"
}

How fresh is it, and where does the data come from?

The fastest source behind this answer can change every 15 minutes, so every response carries a refresh_after timestamp — right now it would be 2026-09-17T11:15:00.000Z. Schedule the next call on that value rather than on a guess.

• SEC EDGAR (US federal public domain) — upstream: https://efts.sec.gov

Method version 0.1.0 · serving cache 1 day · every response carries a result_id you can resolve at /v1/provenance.

When should you use it?

You need ratios for one company from filed figures, with the inputs auditable.

What you skip building

• companyfacts wrangling
• period misalignment across fiscal years
• ratio arithmetic

When should you not use it?

Growth over time (/v1/sec/xbrl/growth) or raw facts (/v1/sec/xbrl/financials, /v1/sec/xbrl/concept).

Where else can you find this?

• Catalog entry (JSON, free)
• OpenAPI schema — input and output types, prices, the 402 flow
• llms.txt — every product in one plain-text document