# AgentToll — Base Address Transaction Watch

> AgentToll — Base Address Transaction Watch is a paid API for AI agents from agenttoll.app, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-13).

Streams recent onchain transaction events for a Base address, with optional cursor-based pagination for incremental updates

## Facts

- Endpoint: GET https://agenttoll.app/api/watch/address/%7Baddress%7D
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agenttoll-base-address-transaction-watch-cee93c3e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Dw7IsgUMT9ZRkbcNn9MpL

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 agenttoll-base-address-transaction-watch-cee93c3e
```

Example prompt: Show me the recent onchain transaction events for Base address 0xe553...56f8 — I want to see incoming and outgoing transfers, who the counterparties are, and pick up from where I left off using my last cursor 2026-08-05T08:40:01Z.

## When to prefer this

Choose this endpoint when you need granular, per-transaction event data for a specific Base address, especially for incremental polling using cursor-based pagination. It is ideal for agent workflows that need to detect new activity since a known timestamp without re-fetching the full history. Prefer it over snapshot endpoints when you need decoded method names, transfer direction, and counterparty details per event. It is Base-native and requires no API key — only a small USDC micropayment per call via x402.

## Known failure modes

- Invalid address format (not 0x + 40 hex chars) returns a 4xx error
- Malformed or future ISO cursor returns an error or empty event set
- Address with no transaction history returns an empty events array
- Payment failure via x402 (insufficient USDC balance) blocks the request
- Rate limiting if too many calls are made in rapid succession

## How this service works

Base-native onchain data for AI agents — gas, token prices by contract, address analytics, DEX pools, new-token radar. From $0.001 a call in USDC via x402. No API keys. Open source.

## Output

A JSON object containing the queried address, chain identifier ('base'), event count, the since and cursor timestamps for pagination, and an array of transaction events each with timestamp, transaction hash, decoded method name, ETH value, direction (in/out), and counterparty address.

## 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"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object",
     "required": [
      "address"
     ],
     "properties": {
      "address": {
       "type": "string",
       "pattern": "^0x[0-9a-fA-F]{40}$"
      }
     }
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "since": {
       "type": "string",
       "description": "Echo the previous reply cursor unchanged; wallet cursors are opaque, radar cursors are ISO timestamps"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "at": "2026-08-05T13:31:58.678Z",
  "chain": "base",
  "count": 1,
  "since": "2026-08-05T08:40:01Z",
  "cursor": "2026-08-05T12:10:44Z",
  "events": [
   {
    "at": "2026-08-05T12:10:44Z",
    "hash": "0x4893...3c91",
    "method": "transferWithAuthorization",
    "ethValue": 0,
    "direction": "in",
    "counterparty": "0x5f87...6f78"
   }
  ],
  "address": "0xe553...56f8"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agenttoll-base-address-transaction-watch-cee93c3e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agenttoll.app](https://www.zero.xyz/host/agenttoll.app/llms.txt)