# Return on Average Equity Distribution Histogram

> Return on Average Equity Distribution Histogram 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).

Bins up to 200 return-on-average-equity (ROAE) observations into equal-width histogram buckets with edge definitions, formula, units, and limitations.

## Facts

- Endpoint: POST https://market.datapackvibe.com/x402/assistant-finance-return-equity-histogram?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-distribution-histogram-a660ddf1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_W8gigd4-eVxmEfSVM_4aQ

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-distribution-histogram-a660ddf1 -d '<json body>'
```

Example prompt: Bin these 12 company ROAE observations into 8 equal-width histogram buckets — net incomes are [3000, 3500, 2800, 4100, 3900, 2500, 4500, 3200, 3700, 2900, 4200, 3100] and average equities are [20000, 22000, 18000, 25000, 24000, 17000, 27000, 21000, 23000, 19000, 26000, 20500] — and give me the bin edges, counts, the formula used, and any limitations.

## When to prefer this

Choose this endpoint when you need a bounded frequency distribution (histogram) of return-on-average-equity values across multiple observations — companies, periods, or funds. It is ideal when you have pre-collected net income and average equity figures and want binned distribution output with metadata (formula, units, limitations) rather than a single-point ratio calculation. Prefer it over a simple ROAE calculator when you need statistical spread insight across a dataset of 2–200 observations.

## Known failure modes

- Fewer than 2 rows supplied — minimum 2 observations required
- average_equity value of zero or below — field requires exclusiveMinimum > 0
- More than 200 rows submitted — exceeds maximum item count
- Bins parameter outside 1–30 range — clamped or rejected
- Missing required fields net_income or average_equity on any row — validation error
- Payment of 0.01 USDC not completed — 402 Payment Required response

## How this service works

Return on average equity - Distribution histogram: Bin up to 200 calculated observations into equal-width bins, including edge definitions. 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 distribution histogram report.

## Output

Returns a JSON object containing the histogram bin definitions (edges and counts) for the calculated ROAE observations, along with the formula used (net income / average equity), units, and stated limitations of the calculation. Up to 30 bins can be specified across up to 200 input rows.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "bins": {
   "type": "integer",
   "default": 5,
   "maximum": 30,
   "minimum": 1
  },
  "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-distribution-histogram-a660ddf1/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)