Create Address Watch
Registers an on chain address to watch. An address watch is not controlled by Dfns: it holds no key, it cannot sign or move funds. The indexer matches on chain activity touching the address and sends the corresponding webhooks.
The address must already exist on chain and is normalized to the form the indexer matches on (lowercase for EVM networks). Only networks that support address watches are accepted. A given address can only be watched once per network within an organization while the watch is Active.
Watching an address that was previously deleted re-activates the deleted watch, with the ID, the nickname and the externalId it had before: the request body is only used to find it.
Authentication
✅ Organization User (CustomerEmployee)✅ Delegated User (
EndUser)✅ Service Account
Required Permissions
AddressWatches:Create: Always required.Authorizations
Bearer Token: Used to authenticate API requests. More details how to generate the token: Authentication flows
User Action Signature: Used to sign the change-inducing API requests. More details how to generate the token: User Action Signing flows
Body
Network to watch the address on. Only networks that support address watches are accepted.
ArbitrumOne, ArbitrumSepolia, ArcTestnet, Areum, AvalancheC, AvalancheCFuji, Base, BaseSepolia, Berachain, BerachainBepolia, Bob, BobSepolia, Bsc, BscTestnet, Celo, CeloAlfajores, Codex, CodexSepolia, Ethereum, EthereumClassic, EthereumClassicMordor, EthereumSepolia, EthereumHoodi, FlareC, FlareCCoston2, FlowEvm, FlowEvmTestnet, Ink, InkSepolia, Optimism, OptimismSepolia, Plasma, PlasmaTestnet, Plume, PlumeSepolia, Polygon, PolygonAmoy, Rayls, RaylsTestnet, Robinhood, RobinhoodSepolia, SeiAtlantic2, SeiPacific1, Solana, SolanaDevnet, Sonic, SonicTestnet, Tempo, TempoModerato, Tsc, TscTestnet1, Xdc, XdcApothem, XLayer, XLayerSepolia The on chain address to watch.
1 - 256Address watch nickname.
100User-defined value that can be used to correlate the entity with an external system.
100Response
Success
ID of the address watch.
1 - 64^aw-[a-z0-9]{5}-[a-z0-9]{5}-[a-z0-9]{14,16}$"aw-0pbh4-7sdh4-2occ0e4r1g7obe8c"
Network the address is watched on.
ArbitrumOne, ArbitrumSepolia, ArcTestnet, Areum, AvalancheC, AvalancheCFuji, Base, BaseSepolia, Berachain, BerachainBepolia, Bob, BobSepolia, Bsc, BscTestnet, Celo, CeloAlfajores, Codex, CodexSepolia, Ethereum, EthereumClassic, EthereumClassicMordor, EthereumSepolia, EthereumHoodi, FlareC, FlareCCoston2, FlowEvm, FlowEvmTestnet, Ink, InkSepolia, Optimism, OptimismSepolia, Plasma, PlasmaTestnet, Plume, PlumeSepolia, Polygon, PolygonAmoy, Rayls, RaylsTestnet, Robinhood, RobinhoodSepolia, SeiAtlantic2, SeiPacific1, Solana, SolanaDevnet, Sonic, SonicTestnet, Tempo, TempoModerato, Tsc, TscTestnet1, Xdc, XdcApothem, XLayer, XLayerSepolia The watched on chain address.
Address watch status.
Active, Archived Address watch nickname.
100User-defined value that can be used to correlate the entity with an external system.
100