# AnswerPool Peers Percentile > AnswerPool Peers Percentile is a paid API for AI agents from answerpool.io, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-14). Returns percentile rankings for a public company's key financial metrics (margin, revenue, assets) against a same-industry peer group derived from SEC EDGAR XBRL data. ## Facts - Endpoint: GET https://answerpool.io/v1/peers/percentile - Price: $0.05/call - Payment: x402 - Status: unknown - Last checked: 2026-09-14 - Activations on Zero: 0 - Tags: x402 - Canonical page: https://www.zero.xyz/c/answerpool-peers-percentile-54d5eb9c - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_oH7CMYi1cYgnqwJZiucPS 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-peers-percentile-54d5eb9c ``` Example prompt: How does NVIDIA rank among its semiconductor peers on profit margin? Pull the AnswerPool percentile analysis using ticker NVDA with a peer group of 20 companies. ## When to prefer this Choose this endpoint when you need quantitative peer-relative financial benchmarking for a US public company, grounded in official SEC EDGAR XBRL filings with full provenance. It is ideal for equity research, portfolio screening, due diligence, or any context where knowing where a company ranks within its SIC industry group matters more than absolute numbers. Prefer it over general financial data APIs when you need structured JSON with explicit peer methodology and percentile precision rather than raw financials. ## Known failure modes - Invalid or missing ticker/CIK returns a 4xx error - Company not found in SEC EDGAR XBRL data returns null metrics - Company has insufficient XBRL filings for frame year — metrics may be null rather than imputed - Providing both ticker and CIK simultaneously may cause validation error - peers value outside 3–50 range will be rejected - Non-US listed tickers not covered in SEC EDGAR may return no results ## 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 A JSON object containing the target company's name, ticker, CIK, SIC code, and key financial metrics (net margin, assets, revenue) alongside their computed percentile scores against the peer group. Each metric entry includes the percentile, peer median, peer min/max, number of peers compared, and a human-readable definition. The response also includes the frame year, methodology name, peer selection description, and a disclaimer about the data source. ## 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": "PercentileIn", "properties": { "cik": { "anyOf": [ { "type": "string", "pattern": "^\\d{1,10}$", "maxLength": 10 }, { "type": "null" } ], "title": "Cik", "default": null, "description": "SEC CIK of the company being ranked, 1-10 digits, zero padding optional (e.g. 320193). Provide exactly one of cik or ticker." }, "peers": { "type": "integer", "title": "Peers", "default": 20, "maximum": 50, "minimum": 3, "description": "How many same-industry peers form the comparison set the percentiles are computed against. Default 20." }, "ticker": { "anyOf": [ { "type": "string", "maxLength": 12 }, { "type": "null" } ], "title": "Ticker", "default": null, "description": "US exchange ticker of the company being ranked, case-insensitive (e.g. AAPL). 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": { "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.", "as_of": "2026-09-03T15:00:00Z", "method": "sec_peers_rules_v1", "target": { "cik": "0001045810", "sic": "3674", "name": "NVIDIA CORP", "margin": 0.5585, "ticker": "NVDA", "assets_usd": 111601000000, "revenue_usd": 130497000000, "sic_description": "Semiconductors & Related Devices" }, "metrics": [ { "rank": 1, "value": 0.5585, "metric": "margin", "peer_max": 0.5585, "peer_min": -0.42, "definition": "Net income / revenue", "percentile": 95, "peer_median": 0.081, "peers_compared": 20, "higher_is_better": true } ], "disclaimer": "Derived from public SEC EDGAR filings; not investment advice.", "frame_year": 2025, "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).", "peer_group_size": 20 } } ``` ## More - Live health (JSON, refreshed every minute): https://www.zero.xyz/c/answerpool-peers-percentile-54d5eb9c/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)