# Return on Average Equity – Named Scenario Comparison Calculator

> Return on Average Equity – Named Scenario Comparison Calculator 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-22).

Applies up to 20 named override scenarios to a baseline return-on-average-equity calculation and returns a side-by-side JSON comparison of metric differences.

## Facts

- Endpoint: POST https://market.datapackvibe.com/x402/assistant-finance-return-equity-scenario?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-22
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/return-on-average-equity-named-scenario-comparison-calculator-335ec5ff
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_70nDPTCx2ISpU-BLpNXIj

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-named-scenario-comparison-calculator-335ec5ff -d '<json body>'
```

Example prompt: Run a named scenario comparison for return on average equity with a baseline of $3,000 net income and $20,000 average equity — then compare two scenarios: one where net income rises to $3,500 and another where average equity drops to $18,000.

## When to prefer this

Choose this endpoint when you need to evaluate multiple explicit 'what-if' financial assumptions against a single ROAE baseline in one call, getting a labeled, structured comparison report. It is ideal for sensitivity analysis, board-level scenario planning, or automated financial modeling pipelines where you have concrete override figures rather than needing live market data or advice.

## Known failure modes

- Average equity must be strictly greater than zero — zero or negative values will be rejected
- Each scenario must include at least one override field (net_income or average_equity)
- Maximum of 20 scenarios per request — exceeding this limit returns a validation error
- Scenario labels must be between 1 and 80 characters
- Net income and average equity values must be within ±1 trillion — out-of-range figures will fail validation
- Missing required baseline fields (net_income or average_equity) will cause a 400-level error

## How this service works

Return on average equity - Named scenario comparison: Apply up to 20 explicit input-override scenarios to one baseline and report their differences. 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 named scenario comparison report.

## Output

A JSON report containing the baseline ROAE value, each named scenario's ROAE result, the differences versus baseline, the formula used, units, and applicable limitations of the metric.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "baseline": {
   "type": "object",
   "default": {
    "net_income": 3000,
    "average_equity": 20000
   },
   "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
  },
  "scenarios": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "label",
     "overrides"
    ],
    "properties": {
     "label": {
      "type": "string",
      "maxLength": 80,
      "minLength": 1
     },
     "overrides": {
      "type": "object",
      "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
       }
      },
      "minProperties": 1,
      "additionalProperties": false
     }
    },
    "additionalProperties": false
   },
   "default": [
    {
     "label": "Supplied alternative",
     "overrides": {
      "net_income": 3300.0000000000005
     }
    }
   ],
   "maxItems": 20,
   "minItems": 1
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/return-on-average-equity-named-scenario-comparison-calculator-335ec5ff/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)