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".

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

WETH

WBNB

WMATIC

WAVAX

WFTM

CAKE

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

PreviousDEX Bot MonitoringNextNFT Bot Monitoring

Last updated