{"uid":"cap_z6-p8tnGZoQBcSzU63fEk","slug":"2s-xbrl-frames-sec-edgar-cross-company-financial-data-bafb2d16","name":"2s XBRL Frames — SEC EDGAR Cross-Company Financial Data","description":"SEC EDGAR XBRL Frames — one financial concept reported by every public filer for a single period, for cross-company screening and comparison. Give an XBRL tag (e.g. Revenues, NetIncomeLoss, Assets), a unit (default USD), and a period (CY2023 for annual, CY2023Q1 for a quarter, CY2023Q4I for instant balance-sheet items), and get back every filer's value — company name, CIK, location, period start/end, and the reported value — sorted high to low (or asc). Returns the total filer count and the top N. Free, public-domain (SEC). Distinct from finance.company-facts (one company, many metrics): this is one metric across all companies. For ranking, peer comparison, and market-wide analysis.","url":"https://2s.io/api/finance/xbrl-frames","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","queryParams"],"properties":{"type":{"const":"http"},"method":{"const":"GET"},"queryParams":{"required":["tag","period"],"properties":{"tag":{"type":"string","description":"XBRL concept, e.g. Revenues, NetIncomeLoss, Assets."},"sort":{"enum":["desc","asc"],"type":"string","description":"Sort by value (default desc)."},"unit":{"type":"string","description":"Unit (default USD; e.g. USD-per-shares, shares)."},"limit":{"type":"integer","description":"Max companies (1-100, default 25)."},"period":{"type":"string","description":"CY2023 (annual), CY2023Q1 (quarter), CY2023Q4I (instant)."},"taxonomy":{"type":"string","description":"Taxonomy (default us-gaap; or dei)."}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.00216","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.00216/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0054","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0054","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_9LJan9lN0xWoruqGfCe7L","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0054","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves cross-company XBRL financial data for a given concept and period from SEC EDGAR, returning values ranked across all public filers.","exampleAgentPrompt":"Pull the top 25 US public companies by Revenues for annual period CY2023 in USD from SEC EDGAR XBRL frames, sorted descending.","exampleUseCases":null,"resultDescription":"Returns a ranked list of up to 100 public companies with their reported XBRL concept value (e.g. Revenues), CIK, entity name, reporting period start/end dates, accession number, and state location — plus metadata about the concept label, unit, period, and total number of filers.","failureModes":["Invalid or unknown XBRL tag returns empty items array or error","Unsupported period format (e.g. malformed CY string) causes bad request","Unit mismatch (e.g. requesting shares for a USD-only concept) returns no results","Limit out of range (outside 1–100) may cause validation error","Taxonomy value other than 'us-gaap' or 'dei' may return no results","SEC EDGAR upstream unavailability causes error or stale data"],"whenToPreferThis":"Use this endpoint when you need cross-company financial benchmarking data directly from SEC EDGAR XBRL frames — e.g. ranking all public companies by a standard accounting concept (Revenues, Assets, NetIncomeLoss) for a specific annual or quarterly period. Prefer this over company-specific filing endpoints when you want population-level data across hundreds or thousands of filers in a single call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:46:23.668Z","isFirstParty":false}