> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dfns.co/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> The current DFNS API specification is https://docs.dfns.co/openapi.yaml. Files under /openapi-versions/ are archives of past releases; do not use them for new code.
> Prefer the official DFNS SDKs to raw HTTP calls: they sign requests for you. See https://docs.dfns.co/sdks.md.
> Requests that change state need a User Action Signature in the X-DFNS-USERACTION header, in addition to the Authorization bearer token. See https://docs.dfns.co/guides/developers/signing-requests.md.
> Do not use appId or the X-DFNS-APPID header: applications are deprecated.
> For a summary of how to build on DFNS, read https://docs.dfns.co/skill.md.

# Watch addresses

> Watch an address DFNS does not control from the dashboard: add it to the Watchlist, check its balances and transfers, and stop watching.

An [address watch](https://docs.dfns.co/core-concepts/address-watches.md) follows an on-chain address that is not one of your wallets, so you can see its balances and transfers in the dashboard. This guide walks through the Watchlist. To do the same with the API, see [Watch addresses via API](https://docs.dfns.co/guides/developers/watch-addresses.md).

## Prerequisites

* `AddressWatches:Read` to see the Watchlist
* `AddressWatches:Create` to add a watch
* `AddressWatches:Delete` to stop watching

See [roles and permissions](https://docs.dfns.co/core-concepts/roles-and-permissions.md#address-watches).

## Watch an address

**1. Open the Watchlist**

In the dashboard, go to **Operations** and open the **Watchlist** tab, next to **Wallets** and **Vaults**. It lists every active watch with its name, network, address, and creation date. Click **Watch Address** to add one.

![Watchlist tab with the Watch Address button highlighted](https://mintcdn.com/dfns-6d8c7466/2EWXL1qWdYee0wd6/images/auto/watching-addresses-1.png?fit=max\&auto=format\&n=2EWXL1qWdYee0wd6\&q=85\&s=3136513bd44e5ac31ae7ee76993748c1)

**2. Enter the address**

Select the network, then enter the address. The network list only shows networks that support address watches, and the form checks that the address is valid for that network. Give the watch a name, and optionally an external ID from your own system, then click **Watch Address**.

![Watch an Address form with network, address, name, and external ID filled in](https://mintcdn.com/dfns-6d8c7466/2EWXL1qWdYee0wd6/images/auto/watching-addresses-2.png?fit=max\&auto=format\&n=2EWXL1qWdYee0wd6\&q=85\&s=c49773c51cc34fd04723af2ea7e36501)

If a policy requires approval for this action, the watch is submitted for approval and is created once approved.

## Check balances and transfers

**1. Open the watch**

Click a watch in the Watchlist. Its page shows the address and the watch ID, the net asset value in USD, the native balance, the date watching started, and every asset the address holds.

![Watched address page with net asset value, native balance, and the assets table](https://mintcdn.com/dfns-6d8c7466/2EWXL1qWdYee0wd6/images/auto/watching-addresses-3.png?fit=max\&auto=format\&n=2EWXL1qWdYee0wd6\&q=85\&s=cfe652d4132aab485ec08881bc33fff9)

**2. Review transfers**

Further down the same page, **Transfers** lists the incoming and outgoing transfers that touch the address, with the counterparty, amount, transaction hash, and time. Transfers from before the address was first watched are not shown.

![Transfers table for a watched address with incoming and outgoing transfers](https://mintcdn.com/dfns-6d8c7466/2EWXL1qWdYee0wd6/images/auto/watching-addresses-4.png?fit=max\&auto=format\&n=2EWXL1qWdYee0wd6\&q=85\&s=62e4855446ab5ba13e2fce345e2e9f82)

## Stop watching

Open the actions menu (**⋮**) on the watch's page, or on its row in the Watchlist, and choose **Delete**. Confirm in the dialog.

![Delete Watched Address confirmation dialog](https://mintcdn.com/dfns-6d8c7466/2EWXL1qWdYee0wd6/images/auto/watching-addresses-5.png?fit=max\&auto=format\&n=2EWXL1qWdYee0wd6\&q=85\&s=9a4078c5e4316ae4f3d7ae703906b687)

The watch leaves the Watchlist and its notifications stop. Watching the same address again on the same network brings back the same watch, with its history.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.