# SweetAI Agent Liveness Check

> SweetAI Agent Liveness Check is a paid API for AI agents from sweetai.tiamatcrypto.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-12).

Returns an ALIVE/DEGRADED/DOWN verdict with uptime percentage, latency metrics, and a CALL/SLOW/AVOID action recommendation for a given ERC-8004 AI agent.

## Facts

- Endpoint: GET https://sweetai.tiamatcrypto.com/api/v1/agent-liveness?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/sweetai-agent-liveness-check-8ce7759c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_5j8ubmOTK8e2VQIVzl-IE

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 sweetai-agent-liveness-check-8ce7759c
```

Example prompt: Check if ERC-8004 agent ID 42 is alive right now — give me the liveness verdict and whether I should call it, using a 7-day SLA window.

## When to prefer this

Use this endpoint when you need a quick, actionable health verdict for a specific ERC-8004 on-chain AI agent before deciding whether to call it. It is ideal for pre-routing checks in multi-agent orchestration systems, SLA compliance monitoring, and latency-sensitive workflows where you need a CALL/SLOW/AVOID signal rather than raw metrics alone.

## Known failure modes

- Unknown agent ID returns a 404 or empty result
- window_days outside 1-30 range may return a validation error
- Agent has no historical data yet, resulting in insufficient data response
- Network or service outage causes the liveness endpoint itself to be unavailable
- Payment failure (x402) if USDC balance is insufficient

## How this service works

Check if an AI agent is alive right now: ALIVE/DEGRADED/DOWN verdict with uptime, latency and a CALL/SLOW/AVOID action

## Output

Returns a structured verdict object containing: a liveness status (ALIVE, DEGRADED, or DOWN), current latency metrics, uptime percentage over the requested SLA window, and an action recommendation (CALL, SLOW, or AVOID) indicating whether the agent is suitable to call right now.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "agent_id": {
       "type": "integer",
       "description": "ERC-8004 agent ID"
      },
      "window_days": {
       "type": "integer",
       "description": "SLA window 1-30"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/sweetai-agent-liveness-check-8ce7759c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from sweetai.tiamatcrypto.com](https://www.zero.xyz/host/sweetai.tiamatcrypto.com/llms.txt)