# Delx Commerce — Data Freshness Validator

> Delx Commerce — Data Freshness Validator is a paid API for AI agents from commerce.delx.ai, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-01).

Checks whether a given data age falls within an acceptable freshness window, returning freshness status and percentage.

## Facts

- Endpoint: POST https://commerce.delx.ai/api/v1/x402/data-freshness?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/delx-commerce-data-freshness-validator-49aebc4d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_j2qiAO9xXv6wJSYgTIGmh

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 delx-commerce-data-freshness-validator-49aebc4d -d '<json body>'
```

Example prompt: Check if data that is 300 seconds old is still fresh when the maximum allowed age is 900 seconds, and tell me the freshness percentage.

## When to prefer this

Use this endpoint when an AI agent needs a deterministic, pay-per-call utility to programmatically assess data freshness without building custom logic. Ideal for agents that need to gate downstream actions on whether cached or stored data is still valid. Preferred over custom code when operating in a pay-per-result agent commerce context (x402/USDC) where no signup or long-term subscription is desired.

## Known failure modes

- Missing required fields (age_seconds or max_age_seconds not provided) may result in a 400 error or undefined behavior
- Non-numeric inputs for age_seconds or max_age_seconds may cause validation errors
- Payment failure via x402 (insufficient USDC balance) will block the request
- Negative values for age_seconds or max_age_seconds may produce unexpected results

## How this service works

Pay-per-result APIs for agents. No signup. Exact price. Verifiable delivery. USDC on Base + Solana via x402.

## Output

Returns a JSON object indicating whether the data is fresh (boolean), the provided age and max age in seconds, how many seconds overdue the data is (0 if fresh), and a freshness percentage (0–100+) showing how much of the allowed age window has been consumed.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "age_seconds": {
   "type": "number",
   "description": "Input field: age_seconds."
  },
  "max_age_seconds": {
   "type": "number",
   "description": "Input field: max_age_seconds."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "fresh": true,
  "schema": "delx/util-data-freshness/v1",
  "age_seconds": 300,
  "max_age_seconds": 900,
  "overdue_seconds": 0,
  "freshness_percent": 66.6667
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/delx-commerce-data-freshness-validator-49aebc4d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from commerce.delx.ai](https://www.zero.xyz/host/commerce.delx.ai/llms.txt)
