{"uid":"cap_Q82DbkhV8Lsj6fr8_E5hn","slug":"sec-metric-screener-3f64207a","name":"SEC Metric Screener","description":"Rank every SEC filer by one reported metric for a period, straight from XBRL filings: revenue, net_income, operating_income, assets, cash, rnd, eps, stockholders_equity, long_term_debt, shares_outstanding or any us-gaap tag, for a year (CY2024) or quarter (CY2025Q2). Use for market-wide screens and league tables.","url":"https://bess-x402.onrender.com/v1/us-stocks/screen?utm_source=zero.xyz","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","required":[],"properties":{"limit":{"type":"integer","description":"Maximum number of results (1-500)"},"order":{"type":"string","description":"desc (largest first) or asc"},"metric":{"type":"string","description":"Metric alias or us-gaap tag"},"period":{"type":"string","description":"CY2024, CY2025Q2 or CY2024Q4I"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_S5OPLpBC2vWfzj0K_jRuH","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Ranks all SEC XBRL filers by a single reported financial metric (revenue, net income, EPS, assets, etc.) for a given annual or quarterly period, enabling market-wide screens and league tables.","exampleAgentPrompt":"Show me the top 25 US public companies ranked by revenue for full-year 2024, sorted largest first, pulled straight from SEC XBRL filings.","exampleUseCases":[{"title":"Revenue league table for equity research","prompt":"Give me a league table of the top 100 US public companies ranked by revenue for CY2024, largest first — I need this for a sector comparison report."},{"title":"Screening for cash-rich companies","prompt":"Screen all SEC filers and rank them by cash holdings as of Q2 2025, show me the top 50 descending — I'm looking for companies with the most dry powder."},{"title":"EPS ranking for quant factor model","prompt":"Pull the bottom 200 US-listed companies ranked by EPS for CY2024 in ascending order so I can identify the lowest earners for a short-side factor screen."}],"resultDescription":"An ordered list of SEC filers ranked by the requested metric for the specified period, with each entry including company identifiers (name, ticker), the reported metric value, and period metadata — up to 500 results, sorted ascending or descending.","failureModes":["Invalid metric alias or us-gaap tag returns an error or empty results","Period format not matching CY2024, CY2025Q2, or CY2024Q4I conventions returns a bad request","Limit exceeds 500 or is below 1 returns a validation error","Metric not reported by many filers results in a sparse or short list","Network timeout from the Render-hosted service under load"],"whenToPreferThis":"Use this endpoint when you need a cross-market ranking or screen of ALL SEC filers by a single fundamental metric for a specific period. It is ideal for building league tables, factor screens, or identifying market-wide outliers by financial fundamentals directly from XBRL source data. Prefer it over company-specific endpoints when the goal is comparative ranking rather than deep profiling of one company.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T18:25:50.035Z","isFirstParty":false,"canonicalSlug":"sec-metric-screener-3f64207a"}