{"uid":"cap_oH7CMYi1cYgnqwJZiucPS","slug":"answerpool-peers-percentile-54d5eb9c","name":"AnswerPool Peers Percentile","description":"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.","url":"https://answerpool.io/v1/peers/percentile","method":"GET","headers":{},"bodySchema":{"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"}}}}},"responseSchema":{"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}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_LacW73OzvIriFYEsFJCig","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Equity research peer benchmarking","prompt":"I'm doing a quick competitive analysis on AMD — can you tell me what percentile AMD's net margin lands in compared to its semiconductor industry peers? Use a peer group of 20."},{"title":"Portfolio screening for margin leaders","prompt":"Which of these three chipmakers is highest ranked on margin among their SEC peers — NVDA, INTC, or QCOM? Pull the percentile rankings for all three so I can compare."},{"title":"Due diligence on acquisition target","prompt":"We're evaluating a mid-cap pharma company with CIK 0000895655 — can you get their financial percentile rankings against their SIC peer group so I can see where they stand on margin and size?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:35:40.518Z","isFirstParty":false}