# x402 Freshness-Priced Data (lab.paidapis.net)

> x402 Freshness-Priced Data (lab.paidapis.net) is a paid API for AI agents from lab.paidapis.net, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-15).

Returns ETH/USD price and Base gas price, with a choice between cached (cheaper) or live (fresh) data fetch.

## Facts

- Endpoint: GET https://lab.paidapis.net/api/freshness-priced-data
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-freshness-priced-data-lab-paidapis-net-2094c8e6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_5ScqBeiKj0Yi2nhOCW8A1

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 x402-freshness-priced-data-lab-paidapis-net-2094c8e6
```

Example prompt: Can you fetch the live ETH/USD price and current Base gas price right now — I need fresh data, not cached.

## When to prefer this

Use this endpoint when you need a quick, cheap ($0.002 USDC) ETH/USD price or Base gas estimate and are comfortable with either cached or live data. Choose 'live' when freshness matters (e.g., transaction decisions); choose 'cached' for dashboards or informational use. Prefer over heavier oracle APIs when minimal latency and minimal cost matter and Base mainnet data is sufficient.

## Known failure modes

- Live oracle fetch may return null for ethUsdPrice or gasPriceGwei if the upstream data source is temporarily unavailable
- Invalid freshness enum value returns a validation error
- Network timeout on live mode may result in partial nulls in response
- Stale cached data may not reflect very recent market movements

## How this service works

Freshness-tiered pricing: gas price + ETH/USD price, same data either way. ?freshness=cached ($0.002) serves the last known values with no network call; ?freshness=live ($0.02) forces a guaranteed-current fetch right now.

## Output

A JSON object containing the ETH/USD price (number or null), Base gas price in Gwei (number or null), number of gas samples used, the timestamp when the response was served, the timestamp when the ETH price was last cached, and the freshness mode that was applied (cached or live).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "freshness": {
   "enum": [
    "cached",
    "live"
   ],
   "type": "string",
   "description": "Either \"cached\" (default) or \"live\"."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "servedAt": {
   "type": "string"
  },
  "freshness": {
   "enum": [
    "cached",
    "live"
   ],
   "type": "string"
  },
  "ethUsdPrice": {
   "type": [
    "number",
    "null"
   ]
  },
  "gasPriceGwei": {
   "type": [
    "number",
    "null"
   ]
  },
  "gasSampleCount": {
   "type": "integer"
  },
  "ethPriceCachedAt": {
   "type": [
    "string",
    "null"
   ]
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-freshness-priced-data-lab-paidapis-net-2094c8e6/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from lab.paidapis.net](https://www.zero.xyz/host/lab.paidapis.net/llms.txt)