{"uid":"cap_7jbljZRwB3mIgLTF8B1XK","slug":"sec-fundamentals-api-industry-benchmark-aggregates-by-metric-5b83a8cd","name":"SEC Fundamentals API — Industry Benchmark Aggregates by Metric","description":"Pay-per-call API for normalized SEC EDGAR financial data: company financials, XBRL facts, filings, industry benchmarks, peer comparison and stock screening. USDC via x402 or API keys. 20,000+ US public companies, refreshed nightly.","url":"https://sec.multyplylabs.com/aggregate/%7Bmetric%7D","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"},"pathParams":{"type":"object","required":["metric"],"properties":{"metric":{"type":"string","description":"e.g. gross_margin, operating_margin, rd_intensity, roe"}}},"queryParams":{"type":"object","properties":{}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"metric":"gross_margin","cohorts":[{"n":214,"median":0.67,"size_bucket":"large","industry_group":"73"}]}},"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_c0iq6Gz5Yh41DeSqs0uvU","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 industry-level benchmark percentiles (median, cohort sizes, and breakdown by company size and SIC industry group) for a specified financial metric across US public companies.","exampleAgentPrompt":"What's the median gross margin for large US public companies in SIC industry group 73, based on SEC filings? Pull the industry benchmark aggregate for gross_margin.","exampleUseCases":[{"title":"Benchmarking startup's gross margin","prompt":"Our SaaS startup has a 58% gross margin — how does that stack up against large public software companies? Pull the industry benchmark aggregate for gross_margin in SIC group 73 so I can compare."},{"title":"Equity analyst industry comparison","prompt":"I'm writing a research note on industrial manufacturing. Can you get me the median operating margin across different company size buckets for that industry using SEC fundamentals data?"},{"title":"PE firm due diligence screening","prompt":"We're evaluating an acquisition target with 12% ROE — what's the median return on equity across large-cap companies in their sector based on SEC filings? Get the aggregate benchmark for roe."}],"resultDescription":"A JSON object containing the metric name and an array of cohort objects, each with: the number of companies (n), the median value of the metric, a size bucket label (e.g. 'large'), and the SIC industry group code. Enables direct benchmarking of a company's financial ratio against its industry peers segmented by size.","failureModes":["Invalid metric name returns an error or empty cohort array","Unknown or unsupported SIC industry group yields no results","Metric with sparse data may return cohorts with very low n values, reducing statistical reliability","Network or payment authorization failure (x402) blocks the call","Nightly refresh lag may mean very recent filings are not yet reflected"],"whenToPreferThis":"Use this endpoint when you need industry-level aggregate benchmarks (median by size bucket and SIC group) for a specific financial metric across the entire US public company universe. Prefer this over the peer comparison endpoint when you want sector-wide statistics rather than a specific company's metrics vs. its peers, and over the stock screener when you want distribution statistics rather than a filtered list of companies.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:44:06.286Z","isFirstParty":false}