Address monitoring

How Treasury watches your vault's addresses for transactions, balances, and tokens

Address monitoring is how Treasury keeps track of what happens on chain at your vault's addresses. While an address is monitored, Treasury detects every transaction to or from it, keeps its balances current, and follows each transaction until it is final.

What monitoring gives you

  • Incoming and outgoing transactions. Treasury records each transaction involving the address, including token transfers, and adds it to the address's and vault's transaction history.
  • Balances. Native and token balances update after every transaction.
  • Token discovery. Treasury registers tokens the first time the address receives them. Tokens identified as spam are hidden by default.
  • Finality tracking. Each transaction moves from confirmed to finalized once the network considers it final. On public EVM networks, Treasury also handles chain reorganisations.

Which addresses can be monitored

Only addresses your vault controls: its primary address on each network, and addresses derived from the vault's key. Treasury doesn't monitor external or watch-only addresses, or addresses in your address book.

Each address shows whether it is monitored, with monitored, status (monitored or unmonitored), monitoredAt, and unmonitoredAt.

Start and stop monitoring

AddressMonitored by default?
A vault's primary address, when you register a network for the vaultYes
A new address you createOnly if you ask for it with monitor

You can start or stop monitoring any address on a network you manage, and both actions are safe to repeat. Use an idempotency-key header when you start monitoring.

Stopping monitoring keeps the address in the vault. Removing a network from a vault stops monitoring every address on that network. If you register the network again, Treasury monitors the primary address and every address that was monitored before.

When an address isn't monitored, Treasury doesn't detect incoming transfers to it. You can still read its balance on demand.

Networks Treasury monitors for you

On io.network and Liquid, Treasury tracks your vault's addresses itself, so you can't start or stop monitoring there:

  • io.network addresses are set up and tracked automatically when the vault is activated for an io.network organisation.
  • Liquid addresses are checked for incoming transactions every 60 seconds.

On other networks, monitoring is per address, and transactions appear as soon as Treasury detects them.

When a transaction is final

NetworkFinal after
Ethereum32 confirmations
Polygon256 confirmations
Arbitrum One, Base, OP Mainnet64 confirmations
Avalanche20 confirmations
BNB Smart Chain15 confirmations
Bitcoin6 confirmations
Liquid2 confirmations
SolanaFinalised commitment
TronSolidified block
XRP Ledger, io.networkImmediately, when validated

A transaction's on-chain status is described in Transaction requests.


Did this page help you?