Track Ethereum Wallet Activity with Automated Notifications
Stay informed about your Ethereum wallet transactions with a powerful, customizable tracking bot designed for both individual users and developers. The Ethereum Wallet Tracker monitors specified wallet addresses and sends instant notifications whenever new transactions occur—whether they’re standard transfers, internal calls, or token interactions (ERC-20 and ERC-721). Notifications can be delivered via Line Notify or Discord, making it easy to stay updated across platforms.
This open-source tool supports both the Ethereum mainnet and the Goerli testnet, ideal for developers testing dApps or managing smart contracts. Built with automation and security in mind, the tracker uses reliable APIs from Etherscan and Alchemy to ensure accurate, real-time monitoring.
👉 Discover how real-time crypto tracking can enhance your digital asset management.
How to Set Up the Ethereum Wallet Tracker
Step-by-Step Self-Hosting Guide
You can easily host the Ethereum Wallet Tracker on your own machine. Follow these steps to get started:
- Download the latest release from the GitHub releases page.
- Extract the ZIP file and open the
config.yml
file using a text editor like Notepad++. - Fill in required credentials such as API keys and webhook URLs (details below).
- Run
WalletTracker.exe
to launch the application. - Add your Line Bot or Line Notify as a friend to receive messages.
- Start monitoring—you’ll now receive alerts for every new transaction.
🔐 Always keep your API keys and tokens secure. Never share them publicly or commit them to version control.
Configuring config.yml
: Essential Settings
The config.yml
file is the core configuration for the tracker. Below is a breakdown of each field:
# Webhook URL must start with https:// and end without a trailing slash
webhook_url: ''
# Port the webhook listens on (default: 5000)
webhook_port: 5000
# Required API keys
etherscan_api_key: ''
alchemy_api_key: ''
alchemy_webhook_auth_token: ''
# Line integration
line_channel_access_token: ''
line_channel_secret: ''
line_notify_id: ''
line_notify_secret: ''
Each value corresponds to services you’ll set up in the following sections.
Understanding Webhooks and How to Set One Up
A webhook is an HTTP callback: a way for one service to send real-time data to another. In this case, it allows Line and Discord to send event data to your tracker.
Since most home networks don’t have public HTTPS endpoints, you'll need a reverse proxy. The easiest solution is ngrok, which provides a secure public URL for your local server.
👉 Learn how ngrok-powered tools streamline blockchain development workflows.
Using Ngrok to Create a Secure HTTPS Endpoint
- Sign up at ngrok.com and download the executable.
- From the dashboard, create a new domain (e.g.,
your-name.ngrok-free.app
). - Run
ngrok config edit
and replace the content with:
authtoken: YOUR_AUTHTOKEN
version: 2
tunnels:
app:
proto: http
hostname: your-name.ngrok-free.app
addr: 127.0.0.1:5000
- Start the tunnel with
ngrok start app
. - Copy the generated HTTPS URL—it’s now your
webhook_url
.
This URL will route external messages (from Line/Discord) to your local bot securely.
Required API Keys and How to Obtain Them
Get Your Etherscan API Key
Etherscan provides blockchain data access:
- Go to etherscan.io/myapikey and sign up.
- Log in and click + Add.
- Name your app (e.g., “ETH Wallet Tracker”) and generate the key.
- Copy the API key into
etherscan_api_key
.
Retrieve Alchemy Webhook Auth Token
Alchemy powers real-time event tracking:
- Visit dashboard.alchemyapi.io/webhooks and sign in.
- Click on Auth token in the top-right corner.
- Copy the token into
alchemy_webhook_auth_token
.
💡 You can also use Alchemy’s API key if needed for additional features.
Integrating with Line Services
Set Up Line Channel Access Token & Secret
To enable messaging through Line:
- Go to Line Developers Console.
- Create a Provider and a Messaging API channel.
- In Basic Settings, find your
channel_secret
. - In Message API, click Issue to get your
channel_access_token
.
✅ Ensure these settings:
- ✅ Allow bot to join group chats → Enabled
- ❌ Auto-reply messages → Disabled
Configure Line Webhook
- In the same console, go to Messaging API > Webhook URL.
- Enter your ngrok URL +
/callback
(e.g.,https://your-name.ngrok-free.app/callback
). - Enable Use webhook.
- Save changes.
🔒 Line requires HTTPS—ngrok ensures compliance.
Get Line Notify Client ID & Secret
For push-style notifications:
- Visit notify-bot.line.me/my/services.
- Click Add Service, name it “ETH Wallet Tracker”.
- Set Callback URL to your webhook +
/notify
. - After creation, copy the Client ID and Secret.
Users must authorize the service to receive alerts.
Adding Discord Bot Support
Although not detailed in the original config, Discord integration enhances accessibility.
Create a Discord Bot
- Go to Discord Developer Portal.
- Click New Application, name it (e.g., “WalletTracker Bot”).
- Under Bot, click Add Bot.
Enable privileged intents:
- Presence Intent
- Server Members Intent
- Message Content Intent
- Copy the token under Build-A-Bot section.
Use this token in your backend logic or extended scripts for message delivery.
Project Contributions and Development Standards
This project thrives on community contributions.
How to Contribute
- Fork the repository.
- Clone your fork:
git clone https://github.com/your-username/Ethereum-Wallet-Tracker
. - Create a feature branch:
git checkout -b feature/new-notification
. - Commit changes with clear messages (see standards below).
- Push and open a pull request.
Coding & Commit Guidelines
- Max 100 characters per line
- Use
snake_case
for variables/functions - Add blank line at end of file
- Remove unused imports
- Write docstrings in Sphinx style
- Use Google-style TODO comments
Commit prefixes:
Update - ...
Fix bug - ...
Optimize - ...
Standardize - ...
Frequently Asked Questions (FAQ)
Q: Is the Ethereum Wallet Tracker free to use?
Yes, the tool is completely free and open-source under the MIT License. You only need to cover costs for third-party services like ngrok (if using custom domains) or API rate limits.
Q: Can I track multiple wallets at once?
Yes! The bot supports monitoring multiple Ethereum addresses simultaneously. Simply extend the tracking list in your configuration or database layer if customizing the code.
Q: Does it support ERC-721 (NFT) transactions?
Absolutely. The tracker detects ERC-20 token transfers and ERC-721 NFT transactions, including mints, sales, and transfers.
Q: What networks are supported?
Currently supports:
- Ethereum Mainnet
- Goerli Testnet (ideal for developers)
Future updates may include Sepolia or other testnets.
Q: Is my wallet data secure?
Yes. All tracking occurs off-chain via public APIs—you never expose private keys. Your wallet address is publicly visible on-chain anyway; this tool just adds alerting.
Q: Can I deploy this on a VPS?
Yes, deploying on a Linux VPS (like Ubuntu + systemd) is possible and more stable than local hosting. Use tools like PM2 or Docker for long-term uptime.
Keywords Mined & Integrated
Core keywords naturally integrated throughout:
- Ethereum wallet tracker
- monitor Ethereum transactions
- real-time crypto alerts
- blockchain transaction notifier
- ERC-20 transaction tracking
- ERC-721 NFT alerts
- free wallet monitoring tool
- self-hosted crypto bot
These terms align with high-intent search queries related to blockchain monitoring and personal finance automation.
Final Thoughts
The Ethereum Wallet Tracker bridges the gap between passive ownership and active awareness in decentralized finance. Whether you're a developer testing smart contracts or an investor tracking high-value movements, automated notifications bring peace of mind.
With support for multiple networks, token standards, and messaging platforms, it's one of the most flexible self-hosted tracking solutions available today.
👉 Explore advanced crypto tracking tools that complement self-hosted bots like this one.
Remember to star the project on GitHub if you find it useful—and consider contributing to help evolve its capabilities further.