{
  "format": "delx/intent-card/v1",
  "id": "data-freshness-api",
  "intent": "Data Freshness for an agent workflow",
  "title": "Data Freshness API for agents",
  "description": "Evaluate data age against a caller-supplied freshness objective. Use it as a bounded preflight or analysis step inside an enterprise agent workflow before data, policy, integration, security, or commercial decisions reach production. Returns deterministic machine-readable JSON for $0.003 USDC via x402 on Base. Execution is first-party, local-only, stateless, memory-only, and has no paid upstream or input retention. Results are advisory; the caller remains responsible for authorization and production controls.",
  "keywords": [
    "Data Freshness API",
    "Data Freshness for agents",
    "pay per result API",
    "x402 API",
    "no API key"
  ],
  "updated_at": "2026-08-06",
  "canonical_url": "https://commerce.delx.ai/intents/data-freshness-api",
  "machine_url": "https://commerce.delx.ai/intents/data-freshness-api.json",
  "recommendation": {
    "tool_name": "util_data_freshness",
    "service_name": "Delx Data Freshness",
    "method": "POST",
    "resource": "https://api.delx.ai/api/v1/x402/data-freshness",
    "price_usdc": "0.003",
    "payment_protocols": [
      "x402",
      "mpp"
    ],
    "input_schema": {
      "type": "object",
      "properties": {
        "age_seconds": {
          "description": "Input field: age_seconds.",
          "type": "number"
        },
        "max_age_seconds": {
          "description": "Input field: max_age_seconds.",
          "type": "number"
        }
      },
      "required": [
        "age_seconds",
        "max_age_seconds"
      ],
      "additionalProperties": true
    },
    "example_input": {
      "age_seconds": 300,
      "max_age_seconds": 900
    },
    "example_output": {
      "schema": "delx/util-data-freshness/v1",
      "fresh": true,
      "age_seconds": 300,
      "max_age_seconds": 900,
      "overdue_seconds": 0,
      "freshness_percent": 66.6667
    },
    "agentcash": {
      "buy": "npx agentcash@latest fetch https://api.delx.ai/api/v1/x402/data-freshness -m POST -H 'x-delx-source: intent-card-data-freshness-api' --max-amount 0.003 -b '{\"age_seconds\":300,\"max_age_seconds\":900}'",
      "max_amount_usdc": "0.003"
    }
  },
  "attribution": {
    "header": "x-delx-source",
    "value": "intent-card-data-freshness-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/data-freshness"
  }
}