{
  "format": "delx/intent-card/v1",
  "id": "cache-freshness-calculate-api",
  "intent": "Cache Freshness Calculate for an agent workflow",
  "title": "Cache Freshness Calculate API for agents",
  "description": "Cache Freshness Calculate: Cache Freshness Calculate calculates remaining freshness from response timing metadata from bounded caller-supplied values without an external provider. Call Cache Freshness Calculate before accepting, caching, redirecting, or retrying a caller-supplied web response. Returns normalized web evidence, the computed finding, and an explicit pass or advisory status for Cache Freshness Calculate as versioned deterministic JSON. Price: $0.001 USDC via x402 on Base. First-party, stateless, memory-only execution with no paid upstream, live RPC, web search, credentials, custody, signing, media generator, or input retention. Honest limit: Evaluates only caller-supplied metadata; it performs no DNS lookup, HTTP request, web search, credential use, or persistent storage. Advisory output only; the buyer owns authorization, payment policy, and production decisions.",
  "keywords": [
    "Cache Freshness Calculate API",
    "Cache Freshness Calculate for agents",
    "pay per result API",
    "x402 API",
    "no API key"
  ],
  "updated_at": "2026-08-23",
  "canonical_url": "https://commerce.delx.ai/intents/cache-freshness-calculate-api",
  "machine_url": "https://commerce.delx.ai/intents/cache-freshness-calculate-api.json",
  "recommendation": {
    "tool_name": "util_cache_freshness_calculate",
    "service_name": "Cache Freshness Calculate",
    "method": "POST",
    "resource": "https://api.delx.ai/api/v1/x402/cache-freshness-calculate",
    "price_usdc": "0.001",
    "payment_protocols": [
      "x402",
      "mpp"
    ],
    "input_schema": {
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "type": "object",
      "properties": {
        "date_epoch": {
          "type": "integer",
          "description": "Date Epoch supplied to Cache Freshness Calculate; used only for this bounded calculation and processed in memory without retention."
        },
        "age_seconds": {
          "type": "integer",
          "description": "Age Seconds supplied to Cache Freshness Calculate; used only for this bounded calculation and processed in memory without retention."
        },
        "max_age_seconds": {
          "type": "integer",
          "description": "Max Age Seconds supplied to Cache Freshness Calculate; used only for this bounded calculation and processed in memory without retention."
        },
        "now_epoch": {
          "type": "integer",
          "description": "Now Epoch supplied to Cache Freshness Calculate; used only for this bounded calculation and processed in memory without retention."
        }
      },
      "required": [
        "date_epoch",
        "age_seconds",
        "max_age_seconds",
        "now_epoch"
      ],
      "additionalProperties": false
    },
    "example_input": {
      "date_epoch": 1720000000,
      "age_seconds": 20,
      "max_age_seconds": 300,
      "now_epoch": 1720000100
    },
    "example_output": {
      "schema": "delx/util-cache-freshness-calculate/v1",
      "operation": "web_reliability:cache_freshness_calculate",
      "status": "pass",
      "result": {
        "current_age_seconds": 100,
        "remaining_seconds": 200,
        "fresh": true
      },
      "evidence": {
        "input_sha256": "dc06e6971edff08aae19366d5c94d9ebd945645757a1dda826dc3e155bb227dc",
        "retained": false,
        "external_calls": 0
      }
    },
    "agentcash": {
      "buy": "npx agentcash@latest fetch https://api.delx.ai/api/v1/x402/cache-freshness-calculate -m POST -H 'x-delx-source: intent-card-cache-freshness-calculate-api' --max-amount 0.001 -b '{\"date_epoch\":1720000000,\"age_seconds\":20,\"max_age_seconds\":300,\"now_epoch\":1720000100}'",
      "max_amount_usdc": "0.001"
    }
  },
  "attribution": {
    "header": "x-delx-source",
    "value": "intent-card-cache-freshness-calculate-api"
  },
  "evidence": {
    "paid_openapi": "https://api.delx.ai/openapi.x402.json",
    "governed_portfolio": "https://api.delx.ai/x402-portfolio.json",
    "live_contract": "https://api.delx.ai/api/v1/x402/cache-freshness-calculate"
  }
}