Balance monitoring

Track balance changes and threshold activity in wallets and smart contracts

Dispatch makes it easy to get alerts and webhook data streams for balance changes and threshold changes for wallets and smart contracts.

Balance-tracking Triggers you can choose from:

1. Balance changes

2. Balance threshold reached

With either Trigger, you can monitor multiple wallet and/or contract addresses with one Patch, as long as all addresses are on the same network. You can currently only monitor one token per Patch.

So, if you want to track USDC balance changes in multiple wallets and contracts on Base, you can create one Patch to do that. However, if you want to track USDC activity in multiple wallets on multiple networks (e.g. Ethereum and Base), you'll need to create one Patch for each network.

Balance changes

Choose the "Asset balance change" Trigger if you want to monitor wallets and smart contracts for changes to the balance of a specific token.

Using the token whitelist

Dispatch comes pre-loaded with popular tokens that make it easy to start monitoring balance activity. All you have to do is select the network that the token is on, and type the token symbol in the "Token" search box.

Searching for a token to monitor balance changes

If you don't see the token you want to monitor, you can add it.

Adding tokens

After searching the whitelist to make sure the token you want to monitor is not already in Dispatch, here's how to add the token you want to watch.

What you will need (Requirements)

1. Network - Which network is the asset on?

2. Token contract address

3. Contract ABI - If the token contract is unverified

From the Patch Builder in Step 2, "Trigger Conditions", if you don't see the token you want to monitor, select "Add a token" from the Token dropdown:

Click "Add a token" at the bottom of the dropdown

This will launch a modal:

Adding a token to Dispatch

Once you add the token contract address and a descriptive nickname you'll remember, press the "Add contract" button.

Unverified token contracts

If the address you entered is for an unverified contract, you'll need to paste in the contract's ABI in JSON format:

Adding the ABI for an unverified token contract

Once you've added the contract to Dispatch, you will be able to use it in any Patch you create.

Balance threshold reached

The "Balance threshold reached" Trigger is helpful if you need to know when the balance of a specific token goes above or below a certain threshold amount.

For example, if you want to know when a team wallet's ETH balance goes below a certain amount, or when a reward-dispensing contract's ERC-20 reward token goes below a certain threshold.

After selecting the network that the token is on, you'll be able to search for the token and enter addresses.

Don't see the token you want to set a balance threshold alert for? Here's how to add the token.

Once you've selected the token, set

1. Balance threshold: The number (threshold)

2. Above or below threshold: Do you want to know when the balance goes above the number? Or below it?