{"uid":"cap_voBO_hGXd75hpNbsl6A4d","slug":"sec-company-ranking-by-financial-metric-c4e6e1bb","name":"SEC Company Ranking by Financial Metric","description":"Rank US listed companies by a figure from their SEC filings (revenue, net income, assets, cash, long-term debt, R&D, dividends paid or buybacks) for a year (CY2025) or quarter (CY2026Q1), with ticker and exchange.","url":"https://api.vextorium.com/v1/sec-company-ranking?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"required":[],"properties":{"limit":{"type":"integer","description":"1-200 (default 20)"},"order":{"enum":["largest","smallest"],"type":"string"},"metric":{"enum":["revenue","net_income","active","cash","long_term_debt","spend_id","dividends_paid","buybacks"],"type":"string"},"period":{"type":"string","description":"CY2025 or CY2026Q1"}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":["object","null"],"properties":{"metric":{"type":["string","null"]},"period":{"type":["string","null"]},"source":{"type":["string","null"]},"ranking":{"type":["array","null"],"items":{"type":["null","object"],"properties":{"cik":{"type":["null","string"]},"ticker":{"type":["null","string"]},"company":{"type":["null","string"]},"exchange":{"type":["null","string"]},"position":{"type":["null","number"]},"value_usd":{"type":["null","number"]},"period_end":{"type":["null","string"]}}}},"companies":{"type":["number","null"]}}}}}}},"responseSchema":{"type":"json","example":{"metric":"revenue","period":"CY2025","source":"SEC EDGAR, XBRL frames (figures as reported by the companies)","ranking":[{"cik":"0001018724","ticker":"AMZN","company":"AMAZON.COM, INC.","exchange":"Nasdaq","position":1,"value_usd":716924000000,"period_end":"2025-12-31"},{"cik":"0000104169","ticker":"WMT","company":"Walmart Inc.","exchange":"Nasdaq","position":2,"value_usd":713163000000,"period_end":"2026-01-31"}],"companies":4377}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.006","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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.006/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.006","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.006","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_MeEYGQmJrGa_mT0aPhYGA","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.006","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Ranks US-listed companies by a selected financial metric (revenue, net income, assets, cash, long-term debt, R&D, dividends, or buybacks) for a given fiscal year or quarter, sourced from SEC EDGAR XBRL filings.","exampleAgentPrompt":"Show me the top 25 US-listed companies ranked by revenue for CY2025, largest first, pulling from their SEC filings.","exampleUseCases":[{"title":"Top revenue companies for earnings research","prompt":"Give me the top 50 US public companies by revenue for CY2025, largest first — I'm building a watchlist for earnings season."},{"title":"Comparing R&D spenders by quarter","prompt":"Which 30 US-listed companies spent the most on R&D in CY2026Q1 according to their SEC filings? Rank them largest to smallest."},{"title":"Screening smallest firms by long-term debt","prompt":"Find the 20 US public companies with the smallest long-term debt for CY2025 — I want to screen for financially conservative small caps."}],"resultDescription":"Returns a ranked list of US-listed companies with their position, company name, ticker, exchange, CIK, reported value in USD, and period end date, along with the metric name, period, total number of companies in the dataset, and the SEC EDGAR source attribution.","failureModes":["Invalid or unsupported metric enum value returns an error","Unsupported period string (not CY2025 or CY2026Q1) returns an error","Limit out of range (above 200 or below 1) returns a validation error","Some companies may have missing or null values if they haven't filed XBRL data for the period","Payment failure or insufficient USDC balance prevents the call from completing"],"whenToPreferThis":"Use this endpoint when you need a pre-ranked list of US public companies by a specific financial metric directly from official SEC EDGAR XBRL filings, without needing to aggregate raw filings yourself. Prefer this over manual SEC API queries when you want clean, structured rankings with ticker and exchange data included. It covers annual (CY2025) and quarterly (CY2026Q1) periods and supports up to 200 results per call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T18:52:04.705Z","isFirstParty":false,"canonicalSlug":"sec-company-ranking-by-financial-metric-c4e6e1bb"}