# Return on Average Equity – Ordered Trend Analysis

> Return on Average Equity – Ordered Trend Analysis 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-14).

Fits a descriptive straight-line (OLS) trend to a sequence of up to 200 return-on-average-equity observations and returns the trend formula, units, and limitations as JSON.

## Facts

- Endpoint: POST https://market.datapackvibe.com/x402/assistant-finance-return-equity-trend?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/return-on-average-equity-ordered-trend-analysis-4664ca56
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_1KDydPQub5DpgnwuIWrQc

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-ordered-trend-analysis-4664ca56 -d '<json body>'
```

Example prompt: Fit a straight-line trend to my return on average equity data — I have 6 quarterly periods with net incomes of 3000, 3200, 3100, 3400, 3300, 3600 and average equities of 20000, 21000, 20500, 22000, 21500, 23000. Give me the trend formula and slope.

## When to prefer this

Choose this endpoint when you need a simple, bounded descriptive trend line (slope and intercept) fitted to a historical series of return-on-average-equity figures derived from net income and average equity inputs. It is ideal for summarizing historical ROAE direction without requiring a live data feed, forecasting model, or financial advice. Use it when you have 2–200 equally spaced observations and want a reproducible, formula-based summary suitable for reports or comparisons.

## Known failure modes

- Fewer than 2 observations provided — minimum of 2 rows required
- average_equity value of zero or below — field requires a strictly positive number
- net_income or average_equity values exceed the ±1,000,000,000,000 bounds
- More than 200 rows supplied — maximum array length exceeded
- Malformed JSON input or missing required fields returns a validation error

## How this service works

Return on average equity - Ordered trend analysis: Fit a descriptive straight-line trend to up to 200 equally spaced supplied observations; no forecast. 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 ordered trend analysis report.

## Output

A JSON object containing the fitted linear trend formula (slope and intercept), the metric name (return on average equity), the units of measurement, and stated limitations of the descriptive trend analysis. No forecast values or live data are included.

## 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-ordered-trend-analysis-4664ca56/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)