# CrushRewards Price Dispersion Analyzer

> CrushRewards Price Dispersion Analyzer is a paid API for AI agents from api.crushrewards.dev, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-15).

Analyzes price spread within a product category, returning mean, standard deviation, coefficient of variation, and p10–p90 percentiles with IQR-based outlier exclusion.

## Facts

- Endpoint: GET https://api.crushrewards.dev/v1/analyst/price-dispersion
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-crushrewards-dev-e139c1da
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_9ea7OlRU2tf0wUT9Uwfc4

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 api-crushrewards-dev-e139c1da
```

Example prompt: Can you pull the price dispersion stats for the electronics category on Amazon in the US — I want to see mean, standard deviation, and the p10 through p90 percentiles?

## When to prefer this

Use this endpoint when you need statistical distribution metrics for prices within a product category — specifically when you need percentiles, standard deviation, or coefficient of variation rather than just a simple average. Prefer this over the category overview endpoint when the goal is to understand price spread and variability, not just central tendency. Ideal for competitive pricing analysis, identifying price clustering, or flagging categories with high price volatility.

## Known failure modes

- Missing required 'category' parameter returns a validation error
- Unknown or unsupported category string may return empty/null statistical fields with zero product count
- Unsupported retailer enum value returns a 400 or validation error
- No products found for the specified category/retailer/country combination results in null stats fields
- Network or upstream data source unavailability may return 5xx errors

## How this service works

Real-time pricing, promotions, and competitive intelligence across US and Canadian retailers — exposed as paid API endpoints and MCP tools that AI agents can call directly, with x402 and MPP micropayments per query.

## Output

Returns a JSON object containing the product category, country, currency, product count, number of outliers excluded via IQR, average price, min/max prices, standard deviation, coefficient of variation, and a full set of percentile breakpoints (p10, p25, p50, p75, p90).

## Example request

```json
{
 "country": "us",
 "category": "electronics",
 "retailer": "amazon"
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-crushrewards-dev-e139c1da/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.crushrewards.dev](https://www.zero.xyz/host/api.crushrewards.dev/llms.txt)