Creating a DEX Signal Bot

A DEX Signal Bot allows users to automatically execute swaps on a decentralized exchange like Uniswap by listening to a specific webhook. When a valid signal payload is received, the bot performs a swap based on the user-defined configuration and wallet balance.

🛠️ Bot Setup Fields Here’s a breakdown of the required and optional fields when creating a DEX signal bot:

Name (Optional): You can give your bot a custom name. If left empty, the bot will automatically be named after the selected trading symbol (e.g., "ETHUSDC").

Webhook: Select one of your previously created webhooks. This webhook receives trading signals (via HTTP POST) that trigger the bot’s swap logic.

Symbol: Enter the trading pair symbol (e.g., ETHUSDC). This symbol is used to match the payload data with the appropriate bot.

Chain / Exchange: Select the blockchain network (e.g., Arbitrum) and the supported DEX (e.g., Uniswap). Factory address for the DEX is shown for verification.

Base Token Address / Quote Token Address: Enter the ERC20 token addresses you want to swap.

• Base Token: The token you're buying or selling (e.g., ETH)

• Quote Token: The token you're using to make the trade (e.g., USDC)

Start With: Choose whether the bot should start with a BUY or SELL:

• ✅ BUY: The bot will first buy the base token using the quote token. 👉 The user must deposit the quote token and set the amount in quote units (e.g., USDC).

• ✅ SELL: The bot will first sell the base token for the quote token. 👉 The user must deposit the base token and set the amount in base units (e.g., ETH).

🔄 The selected mode determines the direction of the first trade and which token the user must fund the bot with at creation.

Amount: Set the amount of the starting token to be used in each trade. You must send this amount to the bot contract immediately after creation.

• You can enter a fixed number (e.g., 2500)

• Or enable “Use All” to allow the bot to trade with its entire available balance

---

⚠️ Important: Understanding “Use All” vs Fixed Amount

• ✅ Use All Enabled: The bot will attempt to trade with 100% of its available balance every time. This ensures full usage of capital, but may result in smaller trades over time (e.g., after a loss).

• ❌ Use All Disabled: The bot will only trade with the fixed amount you specify (e.g., 100). If the bot balance falls below that amount (e.g., due to a failed or loss-making trade), the swap will not occur.

---

💰 After Creation Once the bot is created, you must send the selected amount of the starting token to the bot contract address. The bot will use this balance to perform trades based on incoming signals.

You can deposit or withdraw from the bot's token balance at any time via your dashboard.

---

⛽ GasTank Integration Required The bot needs gas (e.g., ETH) to execute trades. Towerflow handles this through the GasTank:

• Users must deposit native tokens (ETH, etc.) into their GasTank.

• When the bot runs, Towerflow calculates the gas cost and deducts it from the GasTank.

• A buffer of ~15% is added to cover burn cost and variable gas use.

totalCost = ((startGas - gasleft()) * tx.gasprice * 115) / 100;
gasTank.burn(owner, totalCost);

⚠️ If your GasTank is empty, your bot may fail to execute and be suspended. If you trigger the swap manually via your wallet, this cost is covered directly by you and no burn will happen.