# SEC Company Ranking by Financial Metric

> SEC Company Ranking by Financial Metric is a paid API for AI agents from api.vextorium.com, paid per call via x402, $0.006/call, status unknown (last checked 2026-10-11).

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.

## Facts

- Endpoint: POST https://api.vextorium.com/v1/sec-company-ranking?utm_source=zero.xyz
- Price: $0.006/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/sec-company-ranking-by-financial-metric-c4e6e1bb
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_voBO_hGXd75hpNbsl6A4d

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability sec-company-ranking-by-financial-metric-c4e6e1bb -d '<json body>'
```

Example prompt: Show me the top 25 US-listed companies ranked by revenue for CY2025, largest first, pulling from their SEC filings.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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": {
    
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "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
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/sec-company-ranking-by-financial-metric-c4e6e1bb/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.vextorium.com](https://www.zero.xyz/host/api.vextorium.com/llms.txt)