Peer Percentiles API: A company's percentile and rank versus its same-industry XBRL peer — SEC XBRL

A company's percentile and rank versus its same-industry XBRL peer group on revenue, assets, net income and margin, with peer median/min/max. One call replaces a peer lookup plus a fundamentals fetch per peer.

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

curl "https://answerpool.io/v1/peers/percentile?ticker=NVDA"

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

Live call: https://answerpool.io/v1/peers/percentile?ticker=NVDA · JSON sample: /v1/samples/peers_percentile

What does the answer look like?

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

metrics

{
 "as_of": "2026-09-03T15:00:00Z",
 "target": {
  "cik": "0001045810",
  "ticker": "NVDA",
  "name": "NVIDIA CORP",
  "sic": "3674",
  "sic_description": "Semiconductors & Related Devices",
  "assets_usd": 111601000000.0,
  "revenue_usd": 130497000000.0,
  "margin": 0.5585
 },
 "frame_year": 2025,
 "peer_group_size": 20,
 "peer_selection": "Same-SIC registrants with XBRL frame data, ranked by size/margin distance; the nearest peers form the comparison set (same method as /v1/peers/similar).",
 "metrics": [
  {
   "metric": "margin",
   "definition": "Net income / revenue",
   "higher_is_better": true,
   "value": 0.5585,
   "percentile": 95.0,
   "rank": 1,
   "peers_compared": 20,
   "peer_median": 0.081,
   "peer_min": -0.42,
   "peer_max": 0.5585
  }
 ],
 "method": "sec_peers_rules_v1",
 "note": "Percentile is the share of the peer group at or below the target for that metric, so 50 is typical for the group and 100 is the highest. A metric is null when the target did not report it in the frame year rather than imputed.",
 "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 a company's standing relative to comparables, quantitatively.

What you skip building

• N peer fundamentals lookups
• hand-built percentile math
• mismatched frame years

When should you not use it?

Just the peer list (/v1/peers/similar) or the company's own figures (/v1/sec/xbrl/financials, /v1/sec/xbrl/ratios).

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