# Citiview Wallet Watch – Multi-Chain Transfer Alert Service

> Citiview Wallet Watch – Multi-Chain Transfer Alert Service is a paid API for AI agents from agents.citiviewgroup.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-14).

Monitors any EVM wallet address on Base, Ethereum, Arbitrum, Optimism, or Polygon for up to 7 days and POSTs real-time alerts for every incoming/outgoing ETH, token, or NFT transfer to a specified webhook URL.

## Facts

- Endpoint: GET https://agents.citiviewgroup.com/v1/wallet/watch?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/citiview-wallet-watch-multi-chain-transfer-alert-service-a9c23870
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ovLOQL3iP7oZoUyAf7Oat

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 citiview-wallet-watch-multi-chain-transfer-alert-service-a9c23870
```

Example prompt: Watch the wallet 0x742d35Cc6634C0532925a3b8D4C9b7e1234abcd on Base for the next 7 days and send alerts for every incoming or outgoing transfer to https://my-server.com/wallet-hook.

## When to prefer this

Choose this endpoint when you need event-driven, near-real-time notifications for on-chain wallet activity across major EVM chains without running your own node or indexer. It is ideal for agents that need to react to blockchain events via webhook rather than polling, and covers ETH, ERC-20 tokens, and NFTs in a single watch. Prefer it over block explorers for automation pipelines where latency under 10 minutes is acceptable.

## Known failure modes

- Invalid or malformed wallet address returns an error response
- Unsupported chain name returns a validation error
- Webhook URL is unreachable or returns non-2xx — alerts may be lost with no retry guarantee
- days value outside 1–7 range rejected
- Missing required fields (address or webhook_url for new watch, id for status check) returns 400-level error
- Watch ID not found returns a not-found error
- Payment failure (x402) causes the call to be rejected before watch is registered

## How this service works

Wallet activity alerts: watch any wallet on Base, Ethereum, Arbitrum, Optimism or Polygon for 7 days; every incoming or outgoing transfer (ETH, tokens, NFTs) is POSTed to your webhook URL within about 10 minutes. Check status with the watch id. Also callable as GET with the same fields as query parameters.

## Output

When creating a watch: returns a watch ID and confirmation that monitoring has started. While active: POSTs a JSON payload to the provided webhook URL within ~10 minutes for each transfer event, including transaction hash, token/NFT details, direction (in/out), chain, and value. When checking status by watch ID: returns current watch state, remaining time, and the monitored address and chain.

## 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"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "id": {
       "type": "string",
       "description": "Check an existing watch"
      },
      "days": {
       "type": "integer",
       "description": "1-7"
      },
      "chain": {
       "type": "string",
       "description": "base (default) | ethereum | arbitrum | optimism | polygon"
      },
      "address": {
       "type": "string",
       "description": "0x wallet to watch"
      },
      "webhook_url": {
       "type": "string",
       "description": "Your https URL that receives the alerts"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/citiview-wallet-watch-multi-chain-transfer-alert-service-a9c23870/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.citiviewgroup.com](https://www.zero.xyz/host/agents.citiviewgroup.com/llms.txt)
