# AgentPay On-Chain Events Lookup

> AgentPay On-Chain Events Lookup is a paid API for AI agents from agentpay.help, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Retrieves recent on-chain events (e.g. ERC-20 transfers) for a given wallet address on a specified blockchain, paid per-call via USDC on Base.

## Facts

- Endpoint: POST https://agentpay.help/v1/on-chain-events
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentpay-on-chain-events-lookup-4c31d89e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_epeBUt37nMAptUFv8v5cN

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 agentpay-on-chain-events-lookup-4c31d89e -d '<json body>'
```

Example prompt: Can you pull the recent on-chain events for the wallet 0x1234567890abcdef1234567890abcdef12345678 on Base and tell me what ERC-20 transfers came in or went out?

## When to prefer this

Choose this endpoint when you need a quick, keyless, pay-per-call lookup of on-chain token transfer events for a specific wallet address without setting up an account or API key. Ideal for AI agents that need lightweight, on-demand blockchain activity checks without integrating a full blockchain indexer or node provider.

## Known failure modes

- Invalid wallet address format returns a validation error
- Unsupported chain name or ID returns an error or empty result
- No events found returns an empty events array
- Payment failure via x402 protocol blocks the request
- Network or RPC timeout may result in a service error

## How this service works

Pay-per-call AI services via the 402 Payment Required protocol. No accounts, no API keys — just USDC on Base.

## Output

Returns a JSON array of on-chain events for the given wallet, where each event includes the event type (e.g. erc20_transfer), the asset involved (e.g. USDC), the amount, and the direction (in or out).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "chain": {
   "type": "string",
   "description": "Chain name or id, default base"
  },
  "address": {
   "type": "string",
   "pattern": "^0x[a-fA-F0-9]{40}$",
   "description": "Wallet address"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "events": [
   {
    "type": "erc20_transfer",
    "asset": "USDC",
    "amount": "0.03",
    "direction": "in"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentpay-on-chain-events-lookup-4c31d89e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentpay.help](https://www.zero.xyz/host/agentpay.help/llms.txt)