{"uid":"cap_5j8ubmOTK8e2VQIVzl-IE","slug":"sweetai-agent-liveness-check-8ce7759c","name":"SweetAI Agent Liveness Check","description":"Check if an AI agent is alive right now: ALIVE/DEGRADED/DOWN verdict with uptime, latency and a CALL/SLOW/AVOID action","url":"https://sweetai.tiamatcrypto.com/api/v1/agent-liveness?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_wXoAj0ZMKh7hrjUTuFLwI","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Pre-task agent health check","prompt":"Before I route this job to agent 88, can you check if it's currently alive and healthy? Use a 14-day SLA window and tell me if I should call it or avoid it."},{"title":"Agent fleet uptime monitoring","prompt":"I need to know the liveness status of agent ID 15 — is it ALIVE, DEGRADED, or DOWN right now, and what's its uptime over the last 30 days?"},{"title":"Latency-aware routing decision","prompt":"Should I call agent 200 for a time-sensitive task? Check its liveness over the past 3 days and give me the CALL/SLOW/AVOID recommendation."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T21:37:39.411Z","isFirstParty":false,"canonicalSlug":"sweetai-agent-liveness-check-8ce7759c"}