Value Bot Monitoring

What is Value Bot Monitoring?

Value Bot Monitoring is a type of monitoring designed for numerical changes. Its main function is to monitor the value changes of a certain object, and when the value change reaches a preset threshold, an alert will be triggered.

Typical Scenarios for Value Bot Monitoring

1. Monitoring Token balance changes

2. Monitoring the percentage change of Curve stablecoins

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
Polygon zkEVM	on chain	High
ZkSync Era	on chain	High
Base	on chain	High
Scroll	on chain	High
Manta	on chain	High
ZKFair	on chain	High
Blast	on chain	High
Linea	on chain	High
B2	on chain	High
Merlin	on chain	High

How to Configure Value Bot Monitoring?

After logging into the ChainBot platform, top right corner "Create Bot" -> "Value Monitor".

Create a Value Bot

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
Interval	Data point interval, fetching data from the configured data source at each interval	Yes
Baseline Trigger	If this item is selected, the trigger condition is taken as the baseline. Once the value reaches the baseline, it will not be repeatedly triggered. It will only trigger again if it leaves and re-enters the baseline.	Yes
Fields	Numeric fields to be processed	Yes
Tags	Bot Monitoring tags for easy search	Yes

Fields Description

Comprises multiple Field fields, each Field is an object containing field and formater types. The formater is a piece of js code; the user needs to define the code to format the final value.

Built-in Functions

Function Name	Description
tokenPrice(symbol)	Gets the USD-based price of the token, such as tokenPrice('weth')
bot(botId)	References the content of a specific Bot, such as bot('1')
add(x,y)	x+y
sub(x,y)	x-y
mul(x,y)	x*y
div(x,y)	x/y && y != 0
pow(x,y)	x^y

Supported USD-based Tokens

Automatically gets the USD-based price of tokens. The data source comes from the highest liquidity trading pairs on the chain, with more tokens to be supported in the future.

Token	Pool
WBTC	WBTC/BUSD
WETH	WETH/USDT
WBNB	WBNB/BUSD
WMATIC	WMATIC/USDC
WAVAX	WAVAX/USDC
WFTM	WFTM/USDC
CAKE	CAKE/USDC

Conditions Description

The field parsing in conditions is dynamic and will change with the content configured in Fields. The Key of the Condition is the content of the Field, and both are consistent. The value in the condition is the threshold set by the user. When comparing values, the system uses the value formatted by the Field formater and compares it with the value in the condition. Therefore, users need to be aware of unit conversions when configuring.

Template Variables Description

$subscription.name	Subscription Name, usually the same as the Bot Monitoring Name
$block.height	Block Height
$value.{}	Formatted value, dynamically parsed, e.g., $value.balance
$condition	All condition content is converted to a string
$alert.time	Block Time

Default Alert Template

[{$bot.name}]
Block: {$block.height}
Values:{$value.values.ltv}
Condition: {$value.condition}
Time: {$alert.time}

Learn about alarm notification templates?

Notification Message Example

[ENS Governance ETH Balance > 35000 ETH]

Block: 16046035

Balance: 35335.915888

Condition: (5m) balance last > 35000

Time: 2022-11-25T17:14:30+08:00

Created By ChainBot.io

Value Bot Monitoring Examples

Value Bot Example