Message Template Variable Summary

Common Variables for All Monitors:

  • $bot

  • $alert

Address Monitor:

  • $bot

  • $alert

  • $chain

  • $block

  • $tx

  • $intent

Event Monitor:

  • $bot

  • $alert

  • $chain

  • $block

  • $tx

  • $event

  • $params

Block Monitor:

  • $bot

  • $alert

  • $chain

  • $block

Arweave Monitor:

  • $bot

  • $alert

  • $chain

  • $block

  • $tx

NFT Monitor:

  • $bot

  • $alert

  • $block

  • $nft

DEX Monitor:

  • $bot

  • $alert

  • $dex

Value Monitor:

  • $bot

  • $alert

  • $value

Snapshot Monitor:

  • $bot

  • $alert

  • $Snapshot

Detailed Description of Variables

$bot

param
type
comment

$bot.name

string

Name of the Bot

$bot.url

string

Link to the Bot

$alert

param
type
comment

$alert.time

string

Time the alert was triggered, according to the user's timezone

$alert.timestamp

uint64

Timestamp

$chain

param
type
comment

$chain.type

string

ethereum

$chain.chainId

uint64

chain_id

$chain.symbol

string

Symbol of the chain's native token

$chain.decimals

int

Decimals of the chain's native token

$chain.explore

string

Link to the block explorer

$block

param
type
comment

$block.hash

string

Block hash

$block.height

uint64

Block height

$block.minter

string

Address of the block miner

$block.baseFeePerGas

float64

Base fee for this block, in gwei

$block.gasUsedPercent

float64

Percentage of gas used for this block

$tx

param
type
comment

$tx.hash

string

Transaction hash

$tx.nonce

string

Transaction nonce

$tx.from

string

From address

$tx.to

string

To address

$tx.value

string

Transaction value

$tx.gas

string

Amount of gas used for the transaction

$tx.input

string

Input data for the transaction

$event

param
type
comment

$event.contract

string

Contract address that triggered the event

$event.params

object

Parsed event parameter object

$params

$params is an alias for $event.params, used to directly access event parameters. The specific parameter names depend on the ABI definition of the smart contract event being monitored.

Common Event Parameter Examples:

For ERC20 Token Transfer events:

  • $params.from - Transfer sender address

  • $params.to - Transfer receiver address

  • $params.value - Transfer amount

For Uniswap Swap events:

  • $params.sender - Swap initiator

  • $params.recipient - Swap receiver

  • $params.amount0In - Input amount of token 0

  • $params.amount1In - Input amount of token 1

  • $params.amount0Out - Output amount of token 0

  • $params.amount1Out - Output amount of token 1

Usage Examples:

🎯 Event Monitor Triggered!
Contract Address: $event.contract
Transaction Hash: $tx.hash
Sender: $tx.from

--- ERC20 Transfer Event ---
From: $params.from
To: $params.to
Amount: $params.value

--- Uniswap Swap Event ---
Swapper: $params.sender
Recipient: $params.recipient
Input Amount 0: $params.amount0In
Input Amount 1: $params.amount1In
Output Amount 0: $params.amount0Out
Output Amount 1: $params.amount1Out

Block Explorer: $chain.explore/tx/$tx.hash
Bot Details: $bot.url

$nft

param
type
comment

$tx.hash

string

Transaction hash

$tx.nonce

string

Transaction nonce

$tx.from

string

From address

$tx.to

string

To address

$tx.value

string

Transaction value

$tx.gas

string

Amount of gas used for the transaction

$tx.input

string

Input data for the transaction

$dex

param
type
comment

$dex.name

string

DEX name

$dex.address

string

Contract address for DEX swap

$dex.tokenBase.symbol

string

Token base symbol

$dex.tokenBase.address

string

Token base address

$dex.tokenBase.decimals

int

Decimals of the token base

$dex.tokenBase.amount

decimal

Amount of the token base

$dex.tokenBase.balance

decimal

Liquidity of the token base

$dex.tokenQuote.symbol

string

Token quote symbol

$dex.tokenQuote.address

string

Token quote address

$dex.tokenQuote.decimals

int

Decimals of the token quote

$dex.tokenQuote.amount

decimal

Amount of the token quote

$dex.tokenQuote.balance

decimal

Liquidity of the token quote

$dex.value

decimal

Token quantity

$dex.USDValue

decimal

USD value of the token

$dex.price

decimal

Price

$dex.priceUSD

decimal

Price in USD

$dex.action

string

Action

$dex.tokenIn.symbol

string

Incoming token symbol

$dex.tokenIn.address

string

Incoming token address

$dex.tokenIn.decimals

int

Decimals of the incoming token

$dex.tokenIn.amount

decimal

Amount of the incoming token

$dex.tokenOut.symbol

string

Outgoing token symbol

$dex.tokenOut.address

string

Outgoing token address

$dex.tokenOut.decimals

int

Decimals of the outgoing token

$dex.tokenOut.amount

decimal

Amount of the outgoing token

$dex.direction

📈 📉

Upwards / Downwards

$dex.changed.duration

string

Duration of the change

$dex.changed.rate

decimal

Rate of the change

$dex.changed.direction

📈 📉

Upwards / Downwards

$snapshot

param
type
comment

$snapshot.event

string

Callback event

$snapshot.time

string

Time

$snapshot.proposal.id

string

ID

$snapshot.proposal.title

string

Title

$snapshot.proposal.author

string

Author

$snapshot.proposal.state

string

State

$snapshot.proposal.event

string

Event

$snapshot.proposal.space

string

Space

$snapshot.proposal.link

string

Link

$snapshot.proposal.body

string

Content

$snapshot.proposal.start

string

Start time

$snapshot.proposal.end

string

End time

$snapshot.space.id

string

Space ID

$snapshot.space.name

string

Space name

$snapshot.space.about

string

Space description

$snapshot.space.network

string

Space network

$snapshot.space.symbol

string

Space symbol

$value

param
type
comment

$value.values

map

Formatted values, for dynamic parsing, e.g., $value.values.balance, $value.values["outpu0"]

$value.condition

string

All condition content converted to string

$value.conditions

map

Conditions set by the bot converted into a map, with the first field as the key and the condition content as the value in the string format

$intent

param
type
comment

$intent.swap_intents

array

Array of swap intents

$intent.swap_intents[].sender

string

Sender address

$intent.swap_intents[].swap_type

string

Type of swap

$intent.swap_intents[].buy_token

string

Address of token to buy

$intent.swap_intents[].buy_amount

string

Amount of token to buy

$intent.swap_intents[].sell_token

string

Address of token to sell

$intent.swap_intents[].sell_amount

string

Amount of token to sell

Usage Examples:

Sender: {$intent.swap_intents[0].sender}
Buy Token: {$intent.swap_intents[0].buy_token}
Buy Amount: {$intent.swap_intents[0].buy_amount}
Sell Token: {$intent.swap_intents[0].sell_token}
Sell Amount: {$intent.swap_intents[0].sell_amount}
Swap Type: {$intent.swap_intents[0].swap_type}

Last updated