# SperaxOS Giza Agent Overview API

> SperaxOS Giza Agent Overview API is a paid API for AI agents from chat.sperax.io, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-23).

Retrieves an overview of AI agents registered on the Giza protocol, filterable by blockchain, status, and count limit

## Facts

- Endpoint: POST https://chat.sperax.io/api/x402/tools/giza/getAgentOverview?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-23
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/speraxos-giza-agent-overview-api-c05a3916
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_o3AMVuJaDv8L100KxJHAA

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 speraxos-giza-agent-overview-api-c05a3916 -d '<json body>'
```

Example prompt: Show me up to 20 active Giza agents on Starknet — I want an overview of what's currently running.

## When to prefer this

Use this endpoint when you need to discover, audit, or monitor AI agents registered on the Giza protocol across specific blockchains. Prefer this over generic blockchain explorers when you specifically want structured agent-level metadata filtered by status and chain within the Giza ecosystem.

## Known failure modes

- Invalid chain name returns empty list or error
- Unsupported status enum value rejected by schema validation
- Payment failure via x402 if USDC balance is insufficient
- Limit value of 0 or negative may cause unexpected behavior
- Network timeout if Giza protocol data source is unavailable

## How this service works

AI-powered DeFi intelligence APIs payable via the x402 HTTP payment protocol. No API key required — pay per request with USDC on Base. Identity-only (SIWX) endpoints are free for wallets with an agentcash identity.

## Output

A list of Giza AI agents matching the requested filters, including agent metadata such as status, chain affiliation, and any available overview details. Defaults to 10 results if no limit is specified.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "chain": {
   "type": "string",
   "description": "Filter agents by blockchain (e.g. \"ethereum\", \"starknet\", \"arbitrum\")"
  },
  "limit": {
   "type": "number",
   "description": "Maximum number of agents to return (default: 10)"
  },
  "status": {
   "enum": [
    "active",
    "inactive",
    "pending"
   ],
   "type": "string",
   "description": "Filter by agent status: \"active\", \"inactive\", or \"pending\""
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/speraxos-giza-agent-overview-api-c05a3916/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from chat.sperax.io](https://www.zero.xyz/host/chat.sperax.io/llms.txt)