A Telegram bot to interact with the Ethereum ecosystem, track the gas prices and wallets.
- Check current Ethereum gas prices.
- Subscribe to alerts for low gas prices.
- Customize gas price alert thresholds.
- Track the gas price for a specific amount of minutes.
- Track a wallet address and receive alerts when a transaction is sent or received.
- API with health check endpoint.
- Python 3.10 or later.
- A Telegram bot token (obtainable through BotFather).
- An Etherscan API key (obtainable from Etherscan.io).
- Docker (optional).
- Clone this repository.
- Copy
.env-example
to.env
and fill in the required values. - Build the Docker image:
docker build -t gas-tracker-bot .
- Run the Docker container:
docker run -d -e TELEGRAM_TOKEN=your_token -e ETHERSCAN_API_KEY=your_api_key --name gas-tracker-bot gas-tracker-bot
- Clone this repository.
- Copy
.env-example
to.env
and fill in the required values. - Install the required Python packages:
pip install -r requirements.txt
- Run the bot:
python tracker.py
/start
- Start the bot./help
- Show help./gas
- Show current gas prices./subscribe
- Subscribe to gas price alerts./unsubscribe
- Unsubscribe from gas price alerts./thresholds
- Show current gas price alert thresholds./set_thresholds
- Set gas price alert thresholds./track
- Track the gas price for a specific amount of minutes (max 10).
The bot will send a message to all subscribers when the gas price falls below the low
threshold or rises above the high
threshold.
This project is licensed under the MIT License.
This project is governed by the Contributor Covenant Code of Conduct.
This project is provided "as is", without warranty of any kind, express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose and noninfringement. In no event shall the author(s) or the project be liable for any claim, damages or other liability, whether in an action of contract, tort or otherwise, arising from, out of or in connection with the project or the use or other dealings in the project. Use at your own risk.
I'm a surfer, a trader, and a software architect with 15 years of experience designing highly available distributed production environments and developing cloud-native apps in public and private clouds. Just your average bloke. Feel free to connect with me on LinkedIn, but no funny business.