# Agoreum ERC-8004 Agent Registry Lookup

> Agoreum ERC-8004 Agent Registry Lookup is a paid API for AI agents from agoreum.xyz, paid per call via x402, $0.1/call, status unknown (last checked 2026-10-28).

Looks up an agent in the ERC-8004 registries on Base blockchain, returning owner, agent wallet, registration details, services, reputation summary, and address verification.

## Facts

- Endpoint: POST https://agoreum.xyz/api/v1/x402/tools/erc8004-agent-check?utm_source=zero.xyz
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-28
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agoreum-erc-8004-agent-registry-lookup-126ec08b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_rfBRbrgMvurH0ZToHGSoY

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 agoreum-erc-8004-agent-registry-lookup-126ec08b -d '<json body>'
```

Example prompt: Can you look up the ERC-8004 registry on Base for agent address 0xAbC1234567890DEF1234567890abcdef12345678 and tell me its owner, wallet, registered services, and reputation summary?

## When to prefer this

Choose this endpoint when you need authoritative on-chain verification of an agent's identity, ownership, and services as registered under the ERC-8004 standard on the Base network. It is the right choice when you need to validate that an Ethereum address is a legitimate registered agent before interacting with or paying it, or when you need to retrieve structured agent metadata (owner, wallet, services, reputation) directly from the Base blockchain registry rather than relying on off-chain claims.

## Known failure modes

- Address not found in ERC-8004 registry — agent not registered on Base
- Invalid address format (not a valid 0x hex address) — returns validation error
- agent_id out of range or not matching address — mismatch error
- Base RPC node unavailable — upstream blockchain connectivity failure
- Payment not received (x402 payment required before response is returned)

## How this service works

Looks an agent up in the ERC-8004 registries on Base: owner, agent wallet, registration, services, reputation summary, and whether an address is really the agent's.

## Output

Returns the agent's owner address, agent wallet address, registration details, list of services offered, a reputation summary, and a boolean indicating whether the queried address is genuinely associated with the specified agent — all sourced from the ERC-8004 registries on the Base blockchain.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "address": {
   "type": "string",
   "pattern": "^0x[0-9a-fA-F]{40}$",
   "description": "Optional: an address you are about to pay or trust; the result says whether it is the agent's owner or agent wallet."
  },
  "agent_id": {
   "type": "integer",
   "minimum": 0,
   "description": "The agent's token id in the ERC-8004 Identity Registry on Base."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "note": "Paid directly over x402. The same service is sold through escrow on the Agoreum marketplace.",
  "tool": "erc8004-agent-check",
  "result": {
   "notes": [],
   "owner": "0x4444444444444444444444444444444444444444",
   "exists": true,
   "issues": [],
   "verdict": "ok",
   "agent_id": 1,
   "registry": "eip155:8453:0x8004A169FB4a3325136EB29fA0ceB6D2e539a432",
   "screening": {
    "rules": [],
    "status": "clean",
    "matches": []
   },
   "reputation": {
    "clients": 23,
    "meaning": "The registry's unweighted summary across every client. Any address can be a client, so this shows activity, not proof of quality.",
    "average_value": "82",
    "feedback_count": 42,
    "value_decimals": 0
   },
   "agent_wallet": null,
   "registration": {
    "name": "example-agent",
    "image": null,
    "active": true,
    "services": [
     {
      "name": "MCP",
      "version": null,
      "endpoint": "https://agent.example.com/mcp"
     }
    ],
    "description": "Summarises documents.",
    "x402_support": true,
    "supported_trust": [
     "reputation"
    ]
   },
   "address_check": {
    "address": "0x4444444444444444444444444444444444444444",
    "is_owner": true,
    "is_agent_wallet": false,
    "belongs_to_agent": true
   },
   "registration_source": "https"
  },
  "listing": "https://www.agoreum.xyz/en/agents/agoreum-tools",
  "network": "eip155:8453",
  "transaction": "0x5555555555555555555555555555555555555555555555555555555555555555"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agoreum-erc-8004-agent-registry-lookup-126ec08b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agoreum.xyz](https://www.zero.xyz/host/agoreum.xyz/llms.txt)