Watch Mainnet Accounts

Watch mainnet contracts and wallets from the command line. Watched accounts appear on the home map, the Contracts & Wallets page, and the activity feed — see Mainnet Analytics.

Requires contract.dev login (or CONTRACT_DEV_API_KEY).

`watch <address>`

Watch an address. Contract vs wallet is detected automatically.


# A contract on Ethereum (chain 1 is the default)
contract.dev watch 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 --name "USDC"
 
# A contract on Base
contract.dev watch 0xPool... --chain 8453 --name "WETH/USDC pool"
 
# A wallet on explicit chains
contract.dev watch 0xDeployer... --name "Deployer" --chains 1,8453,42161


Watching contract USDC (0xa0b8...eb48) on chain 1

Flag	Description
`--chain <id>`	Chain to watch a contract on / detection anchor. Default: `1`.
`--name <label>`	Display name.
`--chains <ids>`	Wallet chain membership, comma-separated. Omit to let the server detect where the wallet is active.

Contracts are watched per (chain, address). Wallets are a single entry across their chains.

`watch list`


contract.dev watch list                 # everything
contract.dev watch list --chain 8453    # one chain


contract   1              0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48  USDC
wallet     1,8453,42161   0x28c6c06298d514db089934071355e5743bf21d60  Deployer

`unwatch <address>`

Archive a watched account — it disappears from the map, list, and feed.


contract.dev unwatch 0xPool... --chain 8453

--chain disambiguates contracts watched on several chains; wallets never need it.