# Return on Average Equity - Single Calculation

> Return on Average Equity - Single Calculation 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).

Calculates Return on Average Equity (ROAE) for a single supplied record given net income and average equity values, returning the formula, result, units, and limitations.

## Facts

- Endpoint: POST https://market.datapackvibe.com/x402/assistant-finance-return-equity-calculate?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-single-calculation-401e00ea
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_TDh08Y4e1WRdFu16miYy9

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-single-calculation-401e00ea -d '<json body>'
```

Example prompt: Calculate the return on average equity for a company with a net income of $3,500,000 and average equity of $22,000,000 — give me the result along with the formula and any limitations.

## When to prefer this

Choose this endpoint when you need a quick, single-record ROAE calculation with formula documentation and unit clarity, rather than building the formula manually or pulling from a financial data feed. It is ideal for agents that need to explain the metric alongside the result, or when validating a single company's equity efficiency in a bounded, auditable way.

## Known failure modes

- average_equity is zero or negative — rejected by schema (exclusiveMinimum: 0)
- net_income or average_equity exceeds ±1,000,000,000,000 — rejected by schema bounds
- Missing required fields (net_income or average_equity) — validation error
- Malformed JSON body — 400 bad request
- Payment not included or insufficient — x402 payment required error

## How this service works

Return on average equity - Single calculation: Calculate one supplied record with the formula and units. 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 single calculation report.

## Output

A JSON object containing the computed Return on Average Equity value, the formula used, the units of measurement, and noted limitations of the metric based on the supplied figures.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "values": {
   "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
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/return-on-average-equity-single-calculation-401e00ea/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)