Observe wallet balances and transfers
fresh402_wallet_watchReads blockchain state; the observation does not execute transactions or modify the target wallet/contract. An authorized USDC service payment is separate. Execution can charge USDC or prepaid credits, consume trial quota and update Fresh402 records. A new charge requires prior spending authorization. Without billing/trial credentials, a valid call returns an unpaid quote without executing the observation. Read ETH balance snapshots and selected ERC-20-shaped Transfer events for one wallet in a completed bounded finalized page. Save the owned cursor and use a new paid operation for the next page. Not full native/internal/NFT/transaction history; provider-reported logs cannot prove completeness. $0.020000 native USDC/call on Base (eip155:8453); compatible x402 or enabled native MPP client required, no Fresh402 token for first purchase. Save proof/input and private recovery token BEFORE paying for full-response-loss protection: REST X-Fresh402-Recovery-Token; MCP params._meta['fresh402/recovery-token']. Recover originals without new RPC/debit; foreign snapshot/cursor forbidden. Provider failure/partial scan is not paid success. observation_saved=false/persistence_error: recover only, never use unsaved IDs. Prepaid needs eligible finalized all-service credits or an original explicit service-specific tariff4 grant; inspect /v3/prepaid/quote/wallet_watch and /v3/prepaid/all-services. Historical Web rights unchanged; paying agents do not need their own RPC credentials. Observations30days, private financial recovery7days. Not full history, financial advice or security audit. Clients: https://fresh402.com/docs#payments. Free signed trial: /v3/agent-trial requires an unfunded EOA ownership signature; human Web trial: /v2/trial. Eligibility/capacity may return429. Use only X-Fresh402-Trial-Key plus persisted Idempotency-Key; replay exact tool/input/key. Exhaustion never authorizes a charge. The same fixed x402 service price may also be paid in native Circle USDC on Solana Mainnet (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp), when advertised by the unpaid challenge. Explicitly select one accepted network and pin its mint, merchant, amount and sponsored fee payer before signing. Solana payers need no Base wallet; Standalone native Solana MPP solana/charge is also advertised; its client pays a separately authorized SOL network fee, with no server fee sponsorship. Prepaid MPP funding remains Base-only. Payment network does not change the observed chain: blockchain products still inspect finalized Base. Solana delivery requires finalized matching USDC evidence. Persist the original network, resource, input, proof and private recovery capability; never switch networks or authorize a replacement after uncertainty.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"chain_id": "<chain_id>",
"address": "<address>",
"tokens": "<tokens>"
},
"name": "fresh402_wallet_watch"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| block | No | Finalized only. Every state read pins the selected block hash with requireCanonical:true; no latest/number fallback. | finalized |
| cursor | No | Owned opaque cursor from a prior successful wallet_watch. Scope, wallet, tokens, provider and policy must match. | |
| tokens | Yes | One to four selected ERC-20 contracts; no full wallet transaction history. | |
| address | Yes | 20-byte Ethereum address; lowercase/uppercase accepted, mixed case must have a valid EIP-55 checksum. Normalized to checksummed form. | |
| chain_id | Yes | Base mainnet only; returned provider chain must match. | |
| chunk_size | No | Single bounded chunk; four-block maximum and no automatic retry. | |
| from_block | No | Initial first block; cannot be supplied with cursor. Default last four finalized blocks; a gap beyond32 fails without skipping history. | |
| max_blocks | No | At most four blocks in this paid page; default4. has_more describes a completed bounded page, not permission to charge a failed partial scan. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||