XBRL Compare API: Compare one XBRL metric across up to 10 tickers — SEC XBRL

Compare one XBRL metric across up to 10 tickers — latest reported value per company, ranked, with period ends and tags. Use instead of N companyfacts downloads and a fiscal-alignment headache.

$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/compare — product id sec_xbrl_compare. Over MCP, call answerpool_get with product_id=sec_xbrl_compare.

curl "https://answerpool.io/v1/sec/xbrl/compare?tickers=NVDA%2CAAPL&metric=revenue"

# with a prepaid credit key
curl -H "Authorization: Bearer ck_live_..." "https://answerpool.io/v1/sec/xbrl/compare?tickers=NVDA%2CAAPL&metric=revenue"

Live call: https://answerpool.io/v1/sec/xbrl/compare?tickers=NVDA%2CAAPL&metric=revenue · JSON sample: /v1/samples/sec_xbrl_compare

What does the answer look like?

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

latest

{
 "as_of": "2026-08-31T14:00:00Z",
 "metric": "revenue",
 "count": 2,
 "latest": [
  {
   "ticker": "AAPL",
   "cik": "0000320193",
   "tag": "Revenues",
   "end": "2026-06-28",
   "value": 94000000000.0
  },
  {
   "ticker": "NVDA",
   "cik": "0001045810",
   "tag": "Revenues",
   "end": "2026-07-27",
   "value": 46700000000.0
  }
 ],
 "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?

Peer comparisons on one metric.

What you skip building

• N per-company downloads
• tag mapping
• ranking code

When should you not use it?

Whole-market ranking — the frame view covers every filer.

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