https://github.com/can-kat/crypto-wallet-tracker

Crypto Wallet Tracker is a Python Telegram bot that tracks added ETH and BNB wallets and notifies users of new transactions.
https://github.com/can-kat/crypto-wallet-tracker

crypto crypto-bot crypto-currency crypto-tracker crypto-wallet crypto-wallet-blockchain crypto-wallet-finder crypto-wallet-tracker crypto-wallets cryptocoins cryptocurrencies cryptocurrency cryptocurrency-exchanges telegram-bot wallet-tracking wallet-transaction

Last synced: 5 days ago
JSON representation

Crypto Wallet Tracker is a Python Telegram bot that tracks added ETH and BNB wallets and notifies users of new transactions.

• Host: GitHub
• URL: https://github.com/can-kat/crypto-wallet-tracker
• Owner: can-kat
• License: cc0-1.0
• Created: 2023-04-25T22:04:59.000Z (almost 2 years ago)
• Default Branch: main
• Last Pushed: 2025-01-08T23:23:28.000Z (about 1 month ago)
• Last Synced: 2025-02-06T09:00:03.788Z (6 days ago)
• Topics: crypto, crypto-bot, crypto-currency, crypto-tracker, crypto-wallet, crypto-wallet-blockchain, crypto-wallet-finder, crypto-wallet-tracker, crypto-wallets, cryptocoins, cryptocurrencies, cryptocurrency, cryptocurrency-exchanges, telegram-bot, wallet-tracking, wallet-transaction
• Language: Python
• Homepage:
• Size: 83 KB
• Stars: 155
• Watchers: 4
• Forks: 69
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        


Crypto Wallet Transactions Tracker Bot





    

     

    


    

    

    


    

    

    




This is a Telegram bot that tracks the transactions of added Ethereum (ETH) and Binance Coin (BNB) wallets and sends notifications whenever a new transaction occurs. The bot uses the Etherscan and BSCscan APIs to gather information about transactions, and CoinGecko to fetch the current prices of ETH and BNB.

[![Telegram](https://img.shields.io/badge/Telegram-2CA5E0?style=for-the-badge&logo=telegram&logoColor=white)](https://t.me/cnkservices)

## Commands

- `/start` shows a welcome message and instructions on how to use the bot.

- `/add` adds a new wallet to track transactions for. The wallet address must be provided in the correct format (starting with '0x' for ETH wallets and 'bnb' for BNB wallets), otherwise the bot will prompt the user to correct it. The added wallets are saved in a JSON file for persistence.

- `/remove` removes a wallet from the list of tracked wallets. The user must provide the wallet address in the correct format.

- `/list` shows the list of currently tracked wallets.

## Features

- Logging: the bot prompts every transaction and errors.

- Format check: the bot checks that the wallet address provided by the user is in the correct format before adding it to the list of tracked wallets.

## Requirements

To run the bot, you'll need to have Python 3.6 or later installed on your system, along with the following Python libraries:

- `requests` (for making HTTP requests to the APIs)

- `web3` (for interacting with the Ethereum blockchain)

You'll also need to obtain API keys for Etherscan and BSCscan, as well as a Telegram bot token. These can be obtained by following the instructions on the respective websites.

## Installation

1. Clone this repository: `git clone https://github.com/cankatx/crypto-wallet-tracker.git`

2. Install the required packages: `pip install -r requirements.txt`

3. Replace the following placeholders in the `main.py` file with your API keys and bot token:

    ```python

    ETHERSCAN_API_KEY = ''

    BSCSCAN_API_KEY = ''

    TELEGRAM_BOT_TOKEN = ''

    TELEGRAM_CHAT_ID = ''

    ```

4. Start the bot: `python main.py`

## Screenshots

  

  

  

## Disclaimer

This bot is provided for educational purposes only and should not be used as financial advice. The bot does not have access to your wallet.