- Home
- Low Gas Balance Alerts
Low Gas Balance Alerts
Find out before the wallets that run your system run out of gas: relayers, bots, keepers and deployers, on every chain they operate on.
An automated wallet that runs out of its gas token does not fail loudly. Its transactions are rejected before they reach a block, so there is no revert to see on an explorer and no error in your contracts. The bot just stops. Often the first sign is a user report, a stale price, or a missed liquidation.
A low gas balance alert is the cheapest insurance against that: a floor on each operational wallet's native balance, and a message to the right channel when it is crossed.
Which wallets need one
Relayers
Meta-transaction and gasless-transaction relayers pay gas on behalf of users. An empty relayer means every user action in your app fails at once.
Bots
Arbitrage, liquidation and market-making bots that stop sending transactions stop earning, and nobody notices until the PnL report.
Keepers
Automation wallets that harvest vaults, update oracles or trigger scheduled jobs. A missed run can leave a protocol stale or under-collateralised.
Deployers and admin wallets
The wallet a CI pipeline deploys from, or the one that executes a timelock. Running dry mid-release leaves a half-finished upgrade.
Bridges and sequencer-adjacent wallets
Wallets that post data or relay messages between chains, often on several chains at once, each needing its own gas token.
Setting it up
- Create a native balance monitor for the wallet and choose its chain.
- Set the condition to less than and the threshold to your floor, in the chain's gas token.
- Pick a check interval: every 5 minutes on Starter, as often as every minute on Pro.
- Attach a channel the people who refill the wallet actually read. Email, Slack, Telegram, PagerDuty and webhook are on every plan.
- Repeat per chain. Group the monitors (for example "relayers") to see them together.
Example (Pro plan): a relayer on Base
- Monitor type
- Balance
- Chain
- Base
- Address
- 0x7777777777777777777777777777777777777777 (placeholder)
- Condition
- Less than 0.05 (ETH)
- Check interval
- 1 minute
- Alert channels
- Slack #ops, plus a webhook to your refill job
The 1-minute interval is a Pro feature; on Starter, use a 5-minute interval. Slack and webhooks are on every plan. When the relayer drops below 0.05 ETH, the alert names the current balance and the threshold. When it is refilled above 0.05 ETH, a recovery notice follows, so the channel shows it was handled.
Gas tokens by chain
Set each threshold in the native token of the chain the monitor watches:
Beyond the balance
A healthy balance does not mean a healthy bot. Add a failed transaction monitor on the same wallet to catch it burning gas on reverts, and a transaction count monitor to catch it going quiet while it still has funds.
Frequently asked questions
What is a low gas balance alert?
An alert that fires when the native token balance of a wallet, the token it pays gas with, falls below a floor you set. Chainitor checks the balance on your check interval and alerts once when it drops below the floor, then sends a recovery notice when the wallet is topped up.
How do I choose the threshold?
Take what the wallet spends on gas in a normal day, multiply by the days you need to notice and refill it, and add headroom for gas spikes. A keeper spending 0.05 ETH a day that you can refill within two days needs a floor of at least 0.1 ETH; 0.2 ETH leaves room for a busy day.
Can I watch the same wallet on several chains?
Yes, with one monitor per chain. An address is the same on every EVM chain but its balance is not, so a relayer on Base and Arbitrum needs a monitor on each, with a threshold in that chain's gas token.
How quickly will I hear about it?
Balances are checked every 5 minutes on the Starter plan and every minute on Pro. The alert goes out on the first check that finds the balance below your floor.
Does Chainitor top up the wallet for me?
No. Chainitor only reads public balances and sends alerts; it never holds keys or sends transactions. To automate a refill, send the alert to a webhook and have your own system move the funds.
Related monitors and guides
Never let an operational wallet run dry
Add a gas floor to every relayer, bot and keeper in a few minutes. Balance monitors are on every plan.
Start monitoring free7-day free trial ⢠No immediate charge