# Vextorium SEC Company Rankings

> Vextorium SEC Company Rankings 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-13).

Ranks US-listed companies by a chosen SEC financial metric (revenue, net income, assets, cash, debt, R&D, dividends, or buybacks) for a given annual or quarterly period, returning ticker, exchange, and value.

## Facts

- Endpoint: POST https://api.vextorium.com/ranking-empresas-sec-pago?utm_source=zero.xyz
- Price: $0.006/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vextorium-sec-company-rankings-03262812
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_tDENdGFve6Vt5W7HYxer_

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 vextorium-sec-company-rankings-03262812 -d '<json body>'
```

Example prompt: Show me the top 15 US-listed companies by revenue for CY2025, ranked from highest to lowest, using SEC EDGAR data.

## When to prefer this

Choose this endpoint when you need to rank or compare US public companies by fundamental financial figures sourced directly from official SEC EDGAR XBRL filings. Ideal for financial research, screening, and benchmarking tasks where regulatory-grade accuracy matters. Prefer this over financial data aggregators when you want raw as-reported figures rather than normalized or estimated values, and when you need to cover the full universe of SEC-filing companies (4000+) rather than a curated index.

## Known failure modes

- Invalid metric enum value returns an error — must be one of: ingresos, beneficio_neto, activos, caja, deuda_largo_plazo, gasto_id, dividendos_pagados, recompras
- Invalid period string (not CY2025 or CY2026Q1) returns an error
- Limit out of range (must be 1–200) returns validation error
- Some companies may have null ticker or exchange if not currently listed on a major exchange
- Payment failure via x402 protocol returns 402 status before data is delivered

## 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

A JSON object containing the metric name, period, data source attribution (SEC EDGAR XBRL), total number of companies in the universe, and a ranked list of up to 200 companies each with: rank position, CIK, company name, ticker, exchange, reported metric value in USD, and period end date.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "orden": {
   "enum": [
    "mayor",
    "menor"
   ],
   "type": "string"
  },
  "limite": {
   "type": "integer",
   "description": "1-200 (default 20)"
  },
  "metrica": {
   "enum": [
    "ingresos",
    "beneficio_neto",
    "activos",
    "caja",
    "deuda_largo_plazo",
    "gasto_id",
    "dividendos_pagados",
    "recompras"
   ],
   "type": "string"
  },
  "periodo": {
   "type": "string",
   "description": "CY2025 or CY2026Q1"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "fuente": "SEC EDGAR, XBRL frames (cifras tal como las presentan las empresas)",
  "metrica": "ingresos",
  "periodo": "CY2025",
  "ranking": [
   {
    "cik": "0001018724",
    "bolsa": "Nasdaq",
    "ticker": "AMZN",
    "empresa": "AMAZON.COM, INC.",
    "posicion": 1,
    "valor_usd": 716924000000,
    "fin_periodo": "2025-12-31"
   },
   {
    "cik": "0000104169",
    "bolsa": "Nasdaq",
    "ticker": "WMT",
    "empresa": "Walmart Inc.",
    "posicion": 2,
    "valor_usd": 713163000000,
    "fin_periodo": "2026-01-31"
   },
   {
    "cik": "0000731766",
    "bolsa": "NYSE",
    "ticker": "UNH",
    "empresa": "UnitedHealth Group Incorporated",
    "posicion": 3,
    "valor_usd": 447567000000,
    "fin_periodo": "2025-12-31"
   },
   {
    "cik": "0000320193",
    "bolsa": "Nasdaq",
    "ticker": "AAPL",
    "empresa": "Apple Inc.",
    "posicion": 4,
    "valor_usd": 416161000000,
    "fin_periodo": "2025-09-27"
   },
   {
    "cik": "0000927653",
    "bolsa": "NYSE",
    "ticker": "MCK",
    "empresa": "McKESSON CORPORATION",
    "posicion": 5,
    "valor_usd": 403430000000,
    "fin_periodo": "2026-03-31"
   },
   {
    "cik": "0001652044",
    "bolsa": "Nasdaq",
    "ticker": "GOOGL",
    "empresa": "Alphabet Inc.",
    "posicion": 6,
    "valor_usd": 402836000000,
    "fin_periodo": "2025-12-31"
   },
   {
    "cik": "0000064803",
    "bolsa": "NYSE",
    "ticker": "CVS",
    "empresa": "CVS HEALTH CORPORATION",
    "posicion": 7,
    "valor_usd": 402067000000,
    "fin_periodo": "2025-12-31"
   },
   {
    "cik": "0001067983",
    "bolsa": "NYSE",
    "ticker": "BRK-B",
    "empresa": "BERKSHIRE HATHAWAY INC",
    "posicion": 8,
    "valor_usd": 371444000000,
    "fin_periodo": "2025-12-31"
   },
   {
    "cik": "0000034088",
    "bolsa": null,
    "ticker": null,
    "empresa": "Exxon Mobil Corporation",
    "posicion": 9,
    "valor_usd": 332238000000,
    "fin_periodo": "2025-12-31"
   },
   {
    "cik": "0001140859",
    "bolsa": "NYSE",
    "ticker": "COR",
    "empresa": "Cencora, Inc.",
    "posicion": 10,
    "valor_usd": 321332819000,
    "fin_periodo": "2025-09-30"
   }
  ],
  "empresas": 4377
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vextorium-sec-company-rankings-03262812/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)