# GENESIS Agent Tools — Data Freshness Check

> GENESIS Agent Tools — Data Freshness Check is a paid API for AI agents from genesis-agent-tools.genesisagenttools.workers.dev, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-02).

Checks whether a given timestamp is fresh by computing its age in seconds against a configurable staleness threshold

## Facts

- Endpoint: POST https://genesis-agent-tools.genesisagenttools.workers.dev/api/tools/data-freshness-check?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/genesis-agent-tools-data-freshness-check-16e9a62e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_kqGhJPEiw-AXqDW_H1YpE

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 genesis-agent-tools-data-freshness-check-16e9a62e -d '<json body>'
```

Example prompt: Check if the timestamp '2024-06-10T14:23:00Z' is still fresh — flag it as stale if it's older than 300 seconds.

## When to prefer this

Use this endpoint when an agent needs a lightweight, pay-per-call check to determine whether a piece of data or a cached result is still recent enough to act on, without implementing custom time-difference logic. Ideal for agent pipelines that must gate downstream actions on data recency, especially in agentic workflows on Base USDC where x402 micropayments are already in use.

## Known failure modes

- Missing or malformed timestamp string returns a validation error
- Timestamp in an unrecognized format may cause parsing failure
- Threshold_seconds not provided defaults to some internal value which may not match caller expectations
- Future timestamps may return unexpected results or negative age_seconds

## How this service works

Pay-per-call x402 APIs for autonomous agents on Base USDC: API compatibility analysis, bounded HTTP/JSON workflows, URL evidence analysis, crypto price consensus, and agent/MCP readiness checks.

## Output

Returns a boolean 'fresh' indicating whether the timestamp falls within the acceptable age window, and 'age_seconds' giving the exact computed age of the timestamp in seconds relative to the current time.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "timestamp"
 ],
 "properties": {
  "timestamp": {
   "type": "string"
  },
  "threshold_seconds": {
   "type": "number"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "fresh": {
   "type": "boolean"
  },
  "age_seconds": {
   "type": "number"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/genesis-agent-tools-data-freshness-check-16e9a62e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from genesis-agent-tools.genesisagenttools.workers.dev](https://www.zero.xyz/host/genesis-agent-tools.genesisagenttools.workers.dev/llms.txt)