# DEX Bot 监控

### Dex Bot 监控是什么？

DEX Bot 监控是针对 DEX 的需求场景而设计的监控类型。该主要功能是监控各去中心化交易所的相关事件。

### Dex Bot 监控典型场景

1. Dex 上大额成交监控
2. Dex 上流动性大额移除监控
3. Dex 上流动性大额百分比监控
4. Dex 上流动性阈值监控
5. Dex 上币价波动监控

#### 支持的数据源

| 数据源         | 类型       | 稳定性 |
| ----------- | -------- | --- |
| Ethereum    | on chain | 极高  |
| BSC         | on chain | 高   |
| Avalanche   | on chain | 高   |
| Polygon PoS | on chain | 高   |
| Arbitrum    | on chain | 高   |
| Optimism    | on chain | 高   |
| Base        | on chain | 高   |
| ZKFair      | on chain | 高   |
| Blast       | on chain | 高   |

#### 支持的 Swap

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

### 如何配置 Dex Bot 监控？

登录 ChainBot 平台后，右上角 "Create Bot" -> "Dex Monitor"。

<figure><img src="https://269759277-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmoG8PqN7GJCejgjqG74o%2Fuploads%2FHyQZFY5Lfy7v0PSflfW6%2Fcreate-dex-monitor.png?alt=media&#x26;token=d5439fed-a6b5-44d5-a642-f89b25966611" alt=""><figcaption><p>Create Dex Monitor</p></figcaption></figure>

**Info 说明**

| 字段名      | 说明               | 是否必填 |
| -------- | ---------------- | ---- |
| Name     | Bot 监控名          | 是    |
| Chain    | 选定的 Chain        | 是    |
| Contract | 选定的智能合约地址        | 是    |
| Function | 选定的智能合约的方法       | 是    |
| Tags     | Bot 监控 tags，利于搜索 | 是    |

#### Conditions 说明

| Price     | Below                | dex 中指定 token ​的价格低于设置的阈值          |
| --------- | -------------------- | ---------------------------------- |
|           | Above                | dex 中指定 token ​的​​价格高于设置的阈值        |
|           | ChangeRisesRate      | dex 中指定 token ​价格上涨百分率             |
|           | ChangeDropsRate      | dex 中指定 token ​价格下跌百分率             |
|           | ChangeRisesDropsRate | dex 中指定 token ​价格上涨或者下跌百分率，两个同时都监控 |
| Liquidity | Below                | 流动性低于设置的阈值                         |
|           | Above                | 流动性高于设置的阈值                         |
|           | ChangeRisesRate      | dex 中指定 pair 的流动性上涨百分率             |
|           | ChangeDropsRate      | dex 中指定 pair 的流动性下跌百分率             |
|           | ChangeRisesDropsRate | dex 中指定 pair 的流动性上涨或下跌百分率          |
|           | WhaleAdd             | 大额流动性添加                            |
|           | WhaleRemove          | 大额流动性移除                            |
|           | WhaleAddRemove       | 大额流动性添加或者移除                        |
| Swap      | WhaleSell            | 大额卖出                               |
|           | WhaleBuy             | 大额买入                               |
|           | WhaleBuySell         | 大额买卖                               |

**模板变量说明**

| $tokenBase.symbol    | tokenBase 的 symbol，比如 WBTC                   |
| -------------------- | -------------------------------------------- |
| $tokenBase.decimals  | ​tokenBase 的 decimals，比如 18                  |
| $tokenBase.address   | ​tokenBase 的链上地址                             |
| $tokenQuote.symbol   | ​tokenQuote 的 symbol，比如 WETH                 |
| $tokenQuote.decimals | ​tokenQuote 的 decimals，比如 18                 |
| $tokenQuote.address  | tokenQuote 的链上地址                             |
| $tokenQuote.balance  | tokenQuote 的余额（只在流动性变化的时候支持）                 |
| $tokenIn.symbol      | ​tokenIn 的 symbol，比如 wbtc                    |
| $tokenIn.decimals    | ​tokenIn 的 decimals，比如 18                    |
| $tokenIn.address     | ​tokenIn 的链上地址                               |
| $tokenOut.symbol     | ​​tokenOut 的 symbol，比如 weth                  |
| $tokenOut.decimals   | ​​tokenOut 的 decimals，比如 18                  |
| $tokenOut.address    | ​​tokenOut 的链上地址                             |
| ​$dex.name           | DEX 的名字，比如 uniswap                           |
| $value               | 目标 token 在 dex 兑换的数量                         |
| $price               | 目标 token 兑换的价格，以 base token wei 计价单位         |
| $priceUSD            | 目标 token 兑换成 U 的价格，以 U 计价                    |
| $changed.duration    | ​指标变动时间范围                                    |
| $changed.rate        | ​指标变动百分率                                     |
| $action              | 监控指标的行为，add（添加）/ remove（移除）/ buy（买）/ sell（卖） |

#### 术语说明

1. tokenBase：为基准 token，例如：WBTC/WETH 交易对中，其中 WBTC 为 tokenBase。
2. tokenQuote：为基准 token 定价的 token，例如：WBTC/WETH 交易对中，其中 WETH 为 tokenQuote。
3. tokenIn：在 dex 中使用 swap 功能使用 a 换 b时，其中 a 为 tokenIn，b 为 tokenOut。即：将 a token 放进流动性池子中，从流动性池子中拿出 b token 的行为。例如：swap WBTC/WETH 时，此时 WBTC 为 tokenIn，WETH 则为 tokenOut。
4. tokenBase, tokenQuote, tokenIn, tokenOut 均为 ERC20 的 Token，因此都有 name, symbol, decimals, address 等标准 ERC20 的方法。

#### 默认告警模板

大额成交 Swap-WhaleSwap

{% code overflow="wrap" lineNumbers="true" %}

```shell
[ 🐳 {$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}
```

{% endcode %}

流动性大额 Liquidity-WhaleAdd/WhaleRemove/WhaleAdRemove

{% code overflow="wrap" lineNumbers="true" %}

```shell
[ 🐳 {$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
```

{% endcode %}

流动性大额百分比 Liquidity-WhaleAddPercent/WhaleRemovePercent/WhaleAddRemovePercent

{% code overflow="wrap" lineNumbers="true" %}

```shell
[ 🐳 {$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
```

{% endcode %}

流动性阈值 Liquidity-Above/Below

{% code overflow="wrap" lineNumbers="true" %}

```shell
[ {$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}
```

{% endcode %}

流动性波动比率 Liquidity-ChangeRisesRate/ChangeDropsRate/ChangeRisesDropsRate

{% code overflow="wrap" lineNumbers="true" %}

```shell
[ {$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}
```

{% endcode %}

币价波动 Price-ChangeRisesRate/ChangeDropsRate/ChangeRisesDropsRate

{% code overflow="wrap" lineNumbers="true" %}

```shell
[ {$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}
```

{% endcode %}

币价阈值监控 Price-Above/Below

{% code overflow="wrap" lineNumbers="true" %}

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

{% endcode %}

[了解告警通知模板？](https://docs.chainbot.io/zh/advanced-features/alarm-notification-template)

#### 通知消息示例

> \[ 🐳 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](https://www.chainbot.io)

#### Dex Bot 监控案例

[dex-bot-demo](https://docs.chainbot.io/zh/bot-case/dex-bot-demo "mention")