# OzDreamTools x402 Demand Analytics

> OzDreamTools x402 Demand Analytics is a paid API for AI agents from api.ozdreamtools.de, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Returns aggregated demand statistics for x402 monetized API routes — request counts, price requests, HTTP status outcomes, settled payments, conversion/repeat rates, caller classes, and country distribution per route per day.

## Facts

- Endpoint: POST https://api.ozdreamtools.de/api/x402-demand
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ozdreamtools-x402-demand-analytics-12cfb74f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_dapYjExnmvmBio-pwxCYP

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 ozdreamtools-x402-demand-analytics-12cfb74f -d '<json body>'
```

Example prompt: Pull the x402 demand analytics for my routes — I want to see daily request counts, settled payment rates, conversion and repeat rates, caller class breakdown, and country distribution since measurements started on 2026-07-23.

## When to prefer this

Use this endpoint when you need first-party, route-level x402 payment and demand analytics from the ozdreamtools provider — covering settlement rates, conversion, repeat usage, caller geography, and HTTP outcome distributions. This is not a market-wide sample; it reflects only this provider's own x402 routes. Prefer this over generic web analytics when you specifically need x402 payment metrics and caller class data tied to API route demand.

## Known failure modes

- Date range outside available data window (before 2026-07-23) returns empty or error response
- Invalid or missing route filter returns no data or error
- Payment failure for $0.01 USDC call results in 402 response with no data returned
- Request with malformed POST body returns validation error

## How this service works

Aggregated demand data from one provider's own paid x402 routes: requests and price requests per route and day, outcomes by HTTP status, settled payments with conversion and repeat rate, caller classes and country distribution. Not a market sample. Raw identifiers and payer addresses are never returned. Measurement started 2026-07-23.

## Output

Returns aggregated, anonymized metrics per x402 route per day: total request counts, price-request counts, HTTP status code outcome distributions, settled payment counts, payment conversion rate, repeat-caller rate, caller class categories, and caller country distribution. No raw identifiers or payer wallet addresses are included. Data coverage begins 2026-07-23.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "to": {
   "type": "string",
   "description": "Last day of the window, inclusive, YYYY-MM-DD"
  },
  "from": {
   "type": "string",
   "description": "First day of the window, YYYY-MM-DD"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ozdreamtools-x402-demand-analytics-12cfb74f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.ozdreamtools.de](https://www.zero.xyz/host/api.ozdreamtools.de/llms.txt)