# AmanChain Agent Roster

> AmanChain Agent Roster is a paid API for AI agents from preview-chat-701ec510-82d7-4ee3-ae9d-8fdb8c4f421b.space-z.ai, paid per call via x402, $0.031104/call, status unknown (last checked 2026-09-15).

Retrieves the roster of on-chain agents available on the AmanChain node, returning live agent listings from consensus state.

## Facts

- Endpoint: POST https://preview-chat-701ec510-82d7-4ee3-ae9d-8fdb8c4f421b.space-z.ai/api/x402/aman-agent-roster
- Price: $0.031104/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/amanchain-agent-roster-71db510f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_A7eZ_7xc0FDsiYuWD_o5q

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 amanchain-agent-roster-71db510f -d '<json body>'
```

Example prompt: Can you pull up the current agent roster on AmanChain and show me which agents are available right now?

## When to prefer this

Choose this endpoint when you need a live, deterministic view of agents registered on AmanChain sourced directly from on-chain consensus state. Prefer this over static registries or cached agent lists when freshness and on-chain provenance matter. Ideal for agent orchestration workflows that need to dynamically discover and select from available on-chain agents without requiring an API key.

## Known failure modes

- Network or node unavailability returns a connection error
- Payment failure via x402/USDC results in a 402 response and no data returned
- Malformed JSON body (wrong serviceId or missing request field) returns a 400 validation error
- Consensus state lag may return a slightly stale roster in rare cases

## How this service works

Agent Roster: node-operated on-chain service Executed deterministically by the AmanChain node against live consensus state (real blocks, pools, balances) — paid per call via x402, settled in USDC on Base. Input: JSON body {"serviceId":"aman-agent-roster","request":"<input>"}. No account, no API key.

## Output

Returns a structured list of agents registered on the AmanChain node, including agent names, identifiers, and capability descriptions sourced from live consensus state. Data reflects real blocks, pools, and balances at query time.

## 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "properties": {
      "request": {
       "type": "string",
       "description": "service input (see body example)"
      },
      "serviceId": {
       "type": "string",
       "description": "the service id, \"aman-agent-roster\""
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST",
      "PUT",
      "PATCH"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/amanchain-agent-roster-71db510f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from preview-chat-701ec510-82d7-4ee3-ae9d-8fdb8c4f421b.space-z.ai](https://www.zero.xyz/host/preview-chat-701ec510-82d7-4ee3-ae9d-8fdb8c4f421b.space-z.ai/llms.txt)