# Bitcoin Wallet Watch

> Bitcoin Wallet Watch is a paid API for AI agents from agentsvc.io, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-16).

Polls a Bitcoin address for new transactions since the last call, returning direction, net BTC, confirmations, timestamps, and current balance with cursor-based pagination.

## Facts

- Endpoint: POST https://agentsvc.io/api/v1/proxy/btc-watch?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/bitcoin-wallet-watch-68169ab4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_qKspfn9j6lgGzrJWh_Rhw

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 bitcoin-wallet-watch-68169ab4 -d '<json body>'
```

Example prompt: Keep an eye on Bitcoin address bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh for me — let me know about any new deposits, how many confirmations they have, and what the current balance is. Use the cursor from the last check so you only get fresh transactions.

## When to prefer this

Choose this endpoint when you need incremental, deduplicated Bitcoin transaction polling for a specific address — especially for deposit detection in payment flows, treasury monitoring, or whale watching. The cursor mechanism makes it ideal for agents that run on a schedule and need only new activity since the last check, avoiding re-processing of already-seen transactions. Prefer it over full blockchain explorers when you want a lightweight, pay-per-call approach without managing your own node or API keys.

## Known failure modes

- Invalid or malformed Bitcoin address returns an error response
- Stale or tampered cursor may return unexpected results or an error
- Address with no transaction history returns an empty transaction list
- Network or upstream blockchain data source unavailability causes a service error
- Limit value out of acceptable range may be rejected or silently capped

## How this service works

Watch a Bitcoin address in a loop and get only new transactions since your last call, with direction, net BTC, confirmations and time, plus the balance. First call returns recent transactions and a cursor; pass it back next time. For deposit detection and treasury or whale watching.

## Output

Returns a list of new transactions since the provided cursor (or recent transactions on first call), each with direction (in/out), net BTC amount, confirmation count, and timestamp. Also includes the current wallet balance and a new cursor to pass on the next call to retrieve only subsequent transactions.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "default": 10
  },
  "cursor": {
   "type": "string",
   "description": "Cursor from the previous call"
  },
  "address": {
   "type": "string",
   "description": "Bitcoin address"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {},
  "success": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/bitcoin-wallet-watch-68169ab4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentsvc.io](https://www.zero.xyz/host/agentsvc.io/llms.txt)