# Return on Average Equity – Record Ranking

> Return on Average Equity – Record Ranking is a paid API for AI agents from market.datapackvibe.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-23).

Ranks up to 200 supplied company records by their calculated Return on Average Equity (ROAE), preserving original row indices and returning formula, units, and limitations in JSON.

## Facts

- Endpoint: POST https://market.datapackvibe.com/x402/assistant-finance-return-equity-rank?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-23
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/return-on-average-equity-record-ranking-925ce963
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_-HrcfupHjr4ZRroVTl4ph

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 return-on-average-equity-record-ranking-925ce963 -d '<json body>'
```

Example prompt: I have a list of 6 companies with their net income and average equity figures — can you rank them all by return on average equity and tell me the formula and units used? Here are the rows: [{net_income: 5000, average_equity: 40000}, {net_income: 8000, average_equity: 50000}, {net_income: 3000, average_equity: 60000}, {net_income: 12000, average_equity: 70000}, {net_income: 4500, average_equity: 30000}, {net_income: 9000, average_equity: 45000}].

## When to prefer this

Choose this endpoint when you need to rank multiple financial records (2–200) by Return on Average Equity in a single call using your own supplied figures, without requiring a live data feed. It is ideal for portfolio screening, peer benchmarking, or any analytical workflow where you already have net income and average equity data and want a structured, formula-documented ranking with row indices preserved. Prefer it over generic spreadsheet sorting when you need machine-readable JSON output with formula provenance for downstream agent workflows.

## Known failure modes

- Fewer than 2 rows supplied — minimum 2 records required
- average_equity value of 0 or negative — field requires exclusiveMinimum > 0
- More than 200 rows supplied — maximum batch size exceeded
- net_income or average_equity outside allowed range (-1T to +1T)
- Missing required fields net_income or average_equity in any row — request rejected
- Malformed JSON array body — parsing error returned

## How this service works

Return on average equity - Record ranking: Rank up to 200 supplied records by calculated value, preserving row indices; higher is not necessarily better. Metric: Return on average equity. Supplied figures only; returns JSON with formula, units and limitations. One of 50 calculators with 20 analysis modes. No live feed, financial advice or trade execution. 0.01 USDC includes one bounded record ranking report.

## Output

A JSON response containing: the ranked list of input records ordered by computed ROAE (net_income / average_equity), original row indices preserved, the ROAE formula used, units, and any stated limitations of the calculation. Does not include live market data, financial advice, or trade signals.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "rows": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "net_income",
     "average_equity"
    ],
    "properties": {
     "net_income": {
      "type": "number",
      "default": 3000,
      "maximum": 1000000000000,
      "minimum": -1000000000000,
      "description": "Amount in a consistent supplied currency and reporting period"
     },
     "average_equity": {
      "type": "number",
      "default": 20000,
      "maximum": 1000000000000,
      "minimum": 0,
      "description": "Amount in a consistent supplied currency and reporting period",
      "exclusiveMinimum": 0
     }
    },
    "additionalProperties": false
   },
   "default": [
    {
     "net_income": 3000,
     "average_equity": 20000
    },
    {
     "net_income": 3300.0000000000005,
     "average_equity": 22000
    },
    {
     "net_income": 3000,
     "average_equity": 20000
    },
    {
     "net_income": 3300.0000000000005,
     "average_equity": 22000
    }
   ],
   "maxItems": 200,
   "minItems": 2
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/return-on-average-equity-record-ranking-925ce963/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from market.datapackvibe.com](https://www.zero.xyz/host/market.datapackvibe.com/llms.txt)