# AgentOracle Service Health Status

> AgentOracle Service Health Status is a paid API for AI agents from aiagentoracle.ai, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Returns a live health snapshot of the AgentOracle service including operational status, tracked token count, last ingestion timestamp, ingestion error count, process uptime, and API version.

## Facts

- Endpoint: GET https://aiagentoracle.ai/api/v1/status
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/aiagentoracle-ai-1ff114c4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_RaZSXtkW6nSy2vbnufsHd

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 aiagentoracle-ai-1ff114c4
```

Example prompt: Before I run a big query, can you do a quick health check on AgentOracle — tell me if it's operational, how many tokens it's tracking, when it last ingested data, and whether there are any ingestion errors?

## When to prefer this

Use this endpoint as a cheap ($0.01 USDC) pre-flight heartbeat before issuing heavier queries to AgentOracle (token lookups, price history, market cap lists). Ideal for agents that need to confirm the service is operational and data is fresh before making multiple downstream calls. Also useful for monitoring pipelines that need to track AgentOracle uptime and ingestion health over time.

## Known failure modes

- Service itself is down — may return a non-200 HTTP error or timeout
- Payment failure — x402 payment of 0.01 USDC not accepted, returns 402
- Rate limiting — too many rapid heartbeat calls may be throttled
- Degraded state returned — status field shows 'degraded' or 'down' indicating partial outage

## How this service works

AgentOracle: live service-health snapshot — tracked-token count, last ingestion timestamp, ingestion error counter, process uptime, and API version. Use as a cheap heartbeat before issuing larger queries.

## Output

Returns a JSON object with: status (enum: 'operational', 'degraded', or 'down'), tokenCount (integer number of tracked tokens), lastIngestion (ISO 8601 datetime or null), ingestionErrors (integer error count), uptime (process uptime in seconds), and version (API version string).

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {}
 }
}
```

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {}
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "status",
      "tokenCount",
      "ingestionErrors",
      "uptime",
      "version"
     ],
     "properties": {
      "status": {
       "enum": [
        "operational",
        "degraded",
        "down"
       ],
       "type": "string"
      },
      "uptime": {
       "type": "number",
       "description": "Process uptime in seconds."
      },
      "version": {
       "type": "string"
      },
      "tokenCount": {
       "type": "integer",
       "minimum": 0
      },
      "lastIngestion": {
       "type": [
        "string",
        "null"
       ],
       "format": "date-time"
      },
      "ingestionErrors": {
       "type": "integer",
       "minimum": 0
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/aiagentoracle-ai-1ff114c4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from aiagentoracle.ai](https://www.zero.xyz/host/aiagentoracle.ai/llms.txt)