# Unit Return Rate – Benchmark Correlation

> Unit Return Rate – Benchmark Correlation 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-27).

Calculates the Pearson (or similar) correlation between a series of unit return rates and a supplied benchmark series for retail scenario analysis.

## Facts

- Endpoint: POST https://market.datapackvibe.com/x402/assistant-sector-retail-unit-return-correlation?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-27
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/unit-return-rate-benchmark-correlation-463e450f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_WQDzAn3CwiYu2uuQZGUW9

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 unit-return-rate-benchmark-correlation-463e450f -d '<json body>'
```

Example prompt: Can you calculate the benchmark correlation for our unit return rates? Here's our data: 100 sold with 5 returned, 110 sold with 5.5 returned, 95 sold with 4.8 returned — and compare it against this benchmark series: 10, 20, 30.

## When to prefer this

Choose this endpoint when you need a quick, local statistical correlation between a retail unit return rate time series and a supplied benchmark series — particularly for scenario analysis without needing live inventory data, account access, or order execution. It is ideal for offline benchmarking, hypothesis testing, and comparing internal return rate trends against external or synthetic reference series.

## Known failure modes

- Fewer than 2 rows provided — minimum minItems:2 validation error
- Fewer than 2 benchmark values provided — validation error
- sold_units value of 0 triggers exclusiveMinimum violation
- Mismatched array lengths between rows and benchmarks may produce unexpected correlation results
- Extremely large values near the maximum boundary may cause precision issues
- Missing required fields (sold_units or returned_units) in any row object causes schema rejection

## How this service works

Unit return rate - Benchmark correlation: Benchmark correlation for Unit return rate. Supplied retail figures only. Local calculation and scenario analysis; no live inventory, account access, platform fee lookup or order execution. One of 25 profiles or calculations across 20 shared operations in this sector. 0.01 USDC includes one bounded benchmark correlation deliverable.

## Output

Returns a bounded benchmark correlation deliverable — a scalar correlation value (likely Pearson r) between the computed unit return rates (returned_units/sold_units) derived from the supplied rows and the provided benchmark series, enabling retail teams to understand how closely their return performance tracks a reference benchmark.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "rows": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "returned_units",
     "sold_units"
    ],
    "properties": {
     "sold_units": {
      "type": "number",
      "default": 100,
      "maximum": 1000000000000,
      "minimum": 0,
      "exclusiveMinimum": 0
     },
     "returned_units": {
      "type": "number",
      "default": 5,
      "maximum": 1000000000000,
      "minimum": 0
     }
    },
    "additionalProperties": false
   },
   "default": [
    {
     "sold_units": 100,
     "returned_units": 5
    },
    {
     "sold_units": 110.00000000000001,
     "returned_units": 5.5
    },
    {
     "sold_units": 100,
     "returned_units": 5
    },
    {
     "sold_units": 110.00000000000001,
     "returned_units": 5.5
    }
   ],
   "maxItems": 200,
   "minItems": 2
  },
  "benchmarks": {
   "type": "array",
   "items": {
    "type": "number",
    "default": 1,
    "maximum": 1000000000000000000,
    "minimum": -1000000000000000000
   },
   "default": [
    10,
    20,
    30,
    40
   ],
   "maxItems": 200,
   "minItems": 2
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/unit-return-rate-benchmark-correlation-463e450f/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)