DEX Bot Monitoring

What is DEX Bot Monitoring?

DEX Bot Monitoring is a type of monitoring designed for DEX scenarios. Its main function is to monitor relevant events on decentralized exchanges (DEX).

Typical Scenarios for DEX Bot Monitoring

1. Monitoring high-value transactions on a DEX

2. Monitoring significant liquidity removals on a DEX

3. Monitoring significant percentage changes in liquidity on a DEX

4. Monitoring liquidity thresholds on a DEX

5. Monitoring price fluctuations on a DEX

Supported Data Sources

Data Source	Type	Stability
Ethereum	on chain	Very High
BSC	on chain	High
Avalanche	on chain	High
Polygon PoS	on chain	High
Arbitrum	on chain	High
Optimism	on chain	High
Base	on chain	High
ZKFair	on chain	High
Blast	on chain	High

Supported Swaps

Chain	Dex
Ethereum	UniswapV2, UniswapV3, Sushiswap
BSC	Pancakeswap V2
Avalanche	TraderJoe, Pangolin
Polygon PoS	UniswapV2, UniswapV3, MMF, Quickswap
Arbitrum	UniswapV3, Sushiswap, Chronos
Optimism	UniswapV3
Base	UniswapV3
ZKFair	SideSwap
Blast	Thruster

How to Configure DEX Bot Monitoring?

After logging in to the ChainBot platform, go to the upper right corner and select "Create Bot" -> "Dex Monitor".

Create Dex Monitor

Info Description

Field Name	Description	Required
Name	Bot monitoring name	Yes
Chain	Selected Chain	Yes
Contract	Selected smart contract address	Yes
Function	Selected smart contract method	Yes
Tags	Bot monitoring tags, helpful for search	Yes

Conditions Description

Price	Below	Price of specified token in the dex is below the set threshold
	Above	Price of specified token in the dex is above the set threshold
	ChangeRisesRate	Percentage increase in the price of the specified token in the dex
	ChangeDropsRate	Percentage decrease in the price of the specified token in the dex
	ChangeRisesDropsRate	Percentage increase or decrease in the price of the specified token in the dex, monitoring both
Liquidity	Below	Liquidity is below the set threshold
	Above	Liquidity is above the set threshold
	ChangeRisesRate	Percentage increase in liquidity of the specified pair in the dex
	ChangeDropsRate	Percentage decrease in liquidity of the specified pair in the dex
	ChangeRisesDropsRate	Percentage increase or decrease in the liquidity of the specified pair in the dex
	WhaleAdd	Large liquidity addition
	WhaleRemove	Large liquidity removal
	WhaleAddRemove	Large liquidity addition or removal
Swap	WhaleSell	Large sell
	WhaleBuy	Large buy
	WhaleBuySell	Large buy and sell

Template Variables Description

$tokenBase.symbol	Symbol of tokenBase, e.g., WBTC
$tokenBase.decimals	Decimals of tokenBase, e.g., 18
$tokenBase.address	On-chain address of tokenBase
$tokenQuote.symbol	Symbol of tokenQuote, e.g., WETH
$tokenQuote.decimals	Decimals of tokenQuote, e.g., 18
$tokenQuote.address	On-chain address of tokenQuote
$tokenQuote.balance	Balance of tokenQuote (only supported during liquidity changes)
$tokenIn.symbol	Symbol of tokenIn, e.g., WBTC
$tokenIn.decimals	Decimals of tokenIn, e.g., 18
$tokenIn.address	On-chain address of tokenIn
$tokenOut.symbol	Symbol of tokenOut, e.g., WETH
$tokenOut.decimals	Decimals of tokenOut, e.g., 18
$tokenOut.address	On-chain address of tokenOut
$dex.name	Name of the DEX, e.g., Uniswap
$value	Amount of target token exchanged in the dex
$price	Exchange price of the target token, valued in base token wei units
$priceUSD	Exchange price of the target token, valued in USD
$changed.duration	Time range of the indicator change
$changed.rate	Percentage rate of the indicator change
$action	Behaviour of the monitoring indicator, add (addition) / remove (removal) / buy / sell

Terminology Description

1. tokenBase: The base token, e.g., in a WBTC/WETH trading pair, WBTC is the tokenBase.

2. tokenQuote: The token that prices the base token, e.g., in a WBTC/WETH trading pair, WETH is the tokenQuote.

3. tokenIn: In the dex, when using the swap function, swapping a for b, a is tokenIn and b is tokenOut. That is, putting token a into the liquidity pool and taking token b out of the liquidity pool. For example, when swapping WBTC/WETH, WBTC is tokenIn and WETH is tokenOut.

4. tokenBase, tokenQuote, tokenIn, tokenOut are all ERC20 tokens, therefore, they all have standard ERC20 methods like name, symbol, decimals, address.

Default Alert Templates

High-Value Swap - WhaleSwap

[ 🐳 {$bot.name} ]
Pair: {$dex.tokenBase.symbol}/{$dex.tokenQuote.symbol} on {$dex.name}
Value: {$dex.value} USD
Action: {$dex.tokenIn.amount} {$dex.tokenIn.symbol} -> {$dex.tokenOut.amount} {$dex.tokenOut.symbol} at price {$dex.price} USD
Explore: {$chain.explore}/tx/{$tx.hash}

Large Liquidity - WhaleAdd/WhaleRemove/WhaleAdRemove

[ 🐳 {$bot.name} ]
Pair: {$dex.tokenBase.symbol}/{$dex.tokenQuote.symbol} on {$dex.name}
Value: {$dex.value} USD
Action: {$dex.tokenIn.amount} {$dex.tokenIn.symbol} -> {$dex.tokenOut.amount} {$dex.tokenOut.symbol} at price {$dex.price} USD
Explore: {$chain.explore}/tx/{$tx.hash}
Created By ChainBot.org

Large Percentage Liquidity - WhaleAddPercent/WhaleRemovePercent/WhaleAddRemovePercent

[ 🐳 {$bot.name} ]
Pair: {$dex.tokenBase.symbol}/{$dex.tokenQuote.symbol} on {$dex.name}
Value: {$dex.value} USD
Action: {$dex.action} more than {$dex.changed.rate}% liquidity to pool
Explore: {$chain.explore}/tx/{$tx.hash}
Created By ChainBot.org

Liquidity Threshold - Above/Below

[ {$bot.name}  ]
📉📈 {$dex.tokenBase.symbol}/{$dex.tokenQuote.symbol} liquidity on {$dex.name} above/below {$dex.changed.rate} in the past {$dex.changed.duration}
current liquidity is {$dex.tokenQuote.balance} {$dex.tokenQuote.symbol}

Liquidity Fluctuation Ratio - ChangeRisesRate/ChangeDropsRate/ChangeRisesDropsRate

[ {$bot.name}  ]
📉📈 {$dex.tokenBase.symbol}/{$dex.tokenQuote.symbol} liquidity on {$dex.name} {$dex.direction} {$dex.changed.rate} in the past {$dex.changed.duration}
current liquidity is {$dex.tokenQuote.balance} {$dex.tokenQuote.symbol}

Price Fluctuation - ChangeRisesRate/ChangeDropsRate/ChangeRisesDropsRate

[ {$bot.name} ]
📉📈 {$dex.tokenBase.symbol}/{$dex.tokenQuote.symbol} price on {$dex.name} {$dex.direction} {$dex.changed.rate} in the past {$dex.changed.duration}
current price is {$dex.price} {$dex.tokenQuote.symbol}

Price Threshold Monitoring - Above/Below

[ {$bot.name} ]
📉📈 {$dex.tokenBase.symbol}/{$dex.tokenQuote.symbol} price on {$dex.name} {$dex.direction} {$dex.setPrice}. 
current price {$dex.price} USD.

Learn about alert notification templates?

Notification Message Example

[ 🐳 Whale swap on Uniswap ETH/USDT pool ] Pair: WETH/USDT on UniswapV3 Value: 51.237884 USD Action: 0.0404716445741972 WETH -> 51.237884 USDT at price 1266.019321405753878 USD Explore: https://etherscan.io/tx/0xef1cd8f1edfbfa7fc2efe74b814c3535c333921cedae9aaad66a9d969ab885b8 Created By ChainBot.io

Dex Bot Monitoring Cases

Dex Bot Example