Cheap freshness oracle for AI agents
Cheap freshness oracle for AI agents. Register a baseline for free, then check whether scoped HTML, JSON, or text changed. Supports caller hashes, deterministic diffs, shared freshness cache, noise filtering, and HTTP revalidation.
by fresh402.kirilllabs.workers.dev · discovered, not yet claimed by its owner · updated 2026-10-08
Mirrored from Coinbase's public x402 Bazaar. The description is the provider's own text and has not been reviewed here; the payment requirements are copied as published.
What it does
Cheap freshness oracle for AI agents. Register a baseline for free, then check whether scoped HTML, JSON, or text changed. Supports caller hashes, deterministic diffs, shared freshness cache, noise filtering, and HTTP revalidation.
Tags: url-freshness · page-change-detection · website-monitoring · json-monitoring · semantic-diff · bazaar
Call contract
- Method
- POST
- Input
- json
- Output
- json
- Last paid call
- 2026-10-08
{
"include_diff": true,
"max_age_seconds": 300,
"watch_id": "w_0123456789abcdef0123456789abcdef"
}{
"cache_status": "miss",
"cached": false,
"changed": true,
"comparison_source": "stored_watch",
"content_kind": "html",
"diff": {
"added_excerpt": "Pro $29/month",
"available": true,
"change_ratio": 0.12,
"changed": true,
"removed_excerpt": "Pro $25/month"
},
"hash": "0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef",
"network_fetched": true,
"normalizer_version": 2,
"snapshot_saved": true,
"url": "https://example.com/",
"watch_id": "w_0123456789abcdef0123456789abcdef"
}Use with an agent
- Discover. Agents find this listing with
GET https://bazaar.saylorinnovations.com/discovery/search?query=…, the MCP toolsearch_resources, or/discovery/resources. - Inspect. Fetch
/resources/37822.jsonfor the price and payment options. - Pay. Call
GET https://fresh402.kirilllabs.workers.dev/v1/check. The provider answers402with its payment requirements. An x402 client signs one of the options below and retries withPAYMENT-SIGNATURE. - Execute. The provider returns
200with the data. Agent Bazaar is not in the request path and never sees your payment.
For humans
You don't need an account or an API key; you need a wallet holding a small amount of USDC on Base, and an x402-capable client (see the examples below). Call the endpoint unpaid first to see exactly what it asks for.
Pricing & payment
- Price
- $0.005 / request
- Protocol
- x402 v2
- Auth
- No account or API key. Pay per request.
- Networks
- Base
- Demand
- 4 calls · 2 unique payers in 30d (public x402 Bazaar data)
x402 payment requirements
| Scheme | Network | Asset | Amount | Pay to | Timeout |
|---|---|---|---|---|---|
| exact | Base eip155:8453 | USDC | $0.005 | 0x58B4b483fBE31860335eCeB12CCCF4338b251085 | 300s |
accepts[] (raw JSON)
[
{
"scheme": "exact",
"network": "eip155:8453",
"payTo": "0x58B4b483fBE31860335eCeB12CCCF4338b251085",
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"amount": "5000",
"amountUsd": 0.005,
"maxTimeoutSeconds": 300
}
]Schemas
Output schema (JSON Schema)
{
"properties": {
"example": {
"properties": {
"cache_status": {
"type": "string"
},
"cached": {
"type": "boolean"
},
"changed": {
"type": "boolean"
},
"content_kind": {
"type": "string"
},
"diff": {
"type": "object"
},
"hash": {
"type": "string"
},
"network_fetched": {
"type": "boolean"
},
"normalizer_version": {
"type": "integer"
},
"snapshot_saved": {
"type": "boolean"
},
"url": {
"type": "string"
},
"watch_id": {
"type": "string"
}
},
"type": "object"
},
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}Example shape — generated from the schema, not a captured live response
{
"example": {
"cache_status": "string",
"cached": true,
"changed": true,
"content_kind": "string",
"diff": {},
"hash": "string",
"network_fetched": true,
"normalizer_version": 0,
"snapshot_saved": true,
"url": "string",
"watch_id": "string"
},
"type": "string"
}Examples
curl "https://fresh402.kirilllabs.workers.dev/v1/check"
# -> 402 Payment Required, accepts[] lists how to pay
# retry with a PAYMENT-SIGNATURE (or PAYMENT header) once paidconst res = await fetch("https://fresh402.kirilllabs.workers.dev/v1/check");
if (res.status === 402) {
const { accepts } = await res.json();
// pay one of accepts[] via an x402 client, then retry with the payment header
}import httpx
res = httpx.get("https://fresh402.kirilllabs.workers.dev/v1/check")
if res.status_code == 402:
accepts = res.json()["accepts"]
# pay one of accepts[] via an x402 client, then retry with the payment headerDetails
- Provider
- fresh402.kirilllabs.workers.dev
- Endpoint
- https://fresh402.kirilllabs.workers.dev/v1/check
- Machine-readable
/resources/37822.json