# SperaxOS Giza Proof History API

> SperaxOS Giza Proof History 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-20).

Retrieves the history of zero-knowledge proofs generated by Giza agents, filterable by agent ID and proof system type.

## Facts

- Endpoint: POST https://chat.sperax.io/api/x402/tools/giza/getProofHistory?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-20
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/speraxos-giza-proof-history-api-bcdb7a18
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_wqmIuHGKDNaia0Q7pL4Hq

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-proof-history-api-bcdb7a18 -d '<json body>'
```

Example prompt: Show me the last 20 proof history entries for Giza agent ID 'agent-0x1234', filtering to only cairo proofs.

## When to prefer this

Use this endpoint when you need to retrieve the historical record of ZK proofs generated by a specific Giza agent or across all agents, especially when auditing, debugging, or monitoring proof generation activity. Prefer this over general blockchain explorers when you need Giza-specific proof metadata filtered by proof system type.

## Known failure modes

- Invalid or unknown agentId returns empty results or 404
- Unsupported proofType enum value returns validation error
- Limit value too large may be capped or return partial results
- Payment failure via x402 returns 402 Payment Required
- Service unavailability returns 5xx error

## 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 zero-knowledge proof history records from Giza, each entry likely including proof ID, proof system type (cairo, noir, or risc0), associated agent ID, timestamp, and proof status or metadata. Results are bounded by the specified limit (default 20).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "number",
   "description": "Maximum number of proofs to return (default: 20)"
  },
  "agentId": {
   "type": "string",
   "description": "Filter proofs by specific agent ID"
  },
  "proofType": {
   "enum": [
    "cairo",
    "noir",
    "risc0"
   ],
   "type": "string",
   "description": "Filter by proof system: \"cairo\", \"noir\", or \"risc0\""
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/speraxos-giza-proof-history-api-bcdb7a18/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)