{"id":18302311,"url":"https://github.com/0xtaodev/wallet-trades-tracker","last_synced_at":"2025-10-03T13:51:28.765Z","repository":{"id":210464460,"uuid":"725613359","full_name":"0xTaoDev/Wallet-Trades-Tracker","owner":"0xTaoDev","description":"This tool allows for near-instant notifications whenever a wallet executes a swap on an EVM-compatible blockchain","archived":false,"fork":false,"pushed_at":"2025-01-08T16:57:52.000Z","size":1173,"stargazers_count":52,"open_issues_count":0,"forks_count":7,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-05T14:35:11.413Z","etag":null,"topics":["avax","blockchain","bsc","crypto","defi","dex","ethereum","evm","ftm","python","swap","tracking","trade","wallet","web3"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/0xTaoDev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-11-30T14:11:22.000Z","updated_at":"2025-03-28T06:03:37.000Z","dependencies_parsed_at":"2023-12-02T23:22:31.450Z","dependency_job_id":"22875808-fe07-4310-b2f7-a40c56ad6e08","html_url":"https://github.com/0xTaoDev/Wallet-Trades-Tracker","commit_stats":{"total_commits":26,"total_committers":2,"mean_commits":13.0,"dds":0.2692307692307693,"last_synced_commit":"d38da868e842e8a4ce290a7505bf0d9be2c60a40"},"previous_names":["0xtaodev/wallet-trades-tracker"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/0xTaoDev/Wallet-Trades-Tracker","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xTaoDev%2FWallet-Trades-Tracker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xTaoDev%2FWallet-Trades-Tracker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xTaoDev%2FWallet-Trades-Tracker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xTaoDev%2FWallet-Trades-Tracker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/0xTaoDev","download_url":"https://codeload.github.com/0xTaoDev/Wallet-Trades-Tracker/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xTaoDev%2FWallet-Trades-Tracker/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278173365,"owners_count":25942293,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-03T02:00:06.070Z","response_time":53,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["avax","blockchain","bsc","crypto","defi","dex","ethereum","evm","ftm","python","swap","tracking","trade","wallet","web3"],"created_at":"2024-11-05T15:19:08.736Z","updated_at":"2025-10-03T13:51:28.741Z","avatar_url":"https://github.com/0xTaoDev.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003e\n🔎 Wallet Trades Tracker 🔍\n\u003cimg src=\"https://github.com/0xtaodev/wallet-trades-tracker/blob/main/images/banner.jpg?raw=true\" width=\"75%\" height=\"75%\"\u003e\n\u003c/h1\u003e\n\n---\n\n\u003cp align=\"center\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/stars/0xtaodev/wallet-trades-tracker\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/forks/0xtaodev/wallet-trades-tracker\"\u003e\n    \u003cbr\u003e\n    \u003cimg src=\"https://img.shields.io/github/issues/0xtaodev/wallet-trades-tracker\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/issues-closed/0xtaodev/wallet-trades-tracker\"\u003e\n    \u003cbr\u003e\n    \u003cimg src=\"https://img.shields.io/github/languages/top/0xtaodev/wallet-trades-tracker\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/last-commit/0xtaodev/wallet-trades-tracker\"\u003e\n    \u003cbr\u003e\n\u003c/p\u003e\n\n# 📖 Introduction\n**Wallet Trades Tracker** is a Python tool that allows you to get notifications when a wallet from the list make a trade.\nAt this moment, **the tool only supports Ethereum** but it's probably working with others EVM-compatible blockchain.\n\n# ⚠️ Disclaimer\n**Please note that I'm not responsible for any loss of funds, damages, or other libailities resulting from the use of this software or any associated services.\u003cbr\u003e\nThis tool is provided for educational purposes only and should not be used as financial advice, it is still in expiremental phase so use it at your own risk.**\n\n## How it works 🔬\nEach EVM-compatible blockchain bot will **scan every new block** to find wallets **matching those in the `wallets.txt`** file.\nUpon finding a match, it will **check if the transaction is a swap**, if so, it will then **notify this transaction using Discord and Telegram**.\n\n## Features ✨\n- **Real-time monitoring**: Tracking each new swaps from any DEXs\n- **Wallet filtering**: Allowing users to specify which wallets to track\n- **Instant notification**: Sending real-time alerts via Discord, Telegram, or other platforms\n- **Transaction analysis**: Providing details about transactions such as amounts, involved addresses, exchanged tokens...\n\n## Requirements 📄\n\nTo run the tool, you will **need these packages**\n- `web3` (interacting with EVM-compatible blockchain)\n- `multicall` (for making multi RPC calls)\n- `discord.py` (to create an embed for each notification)\n- `python-dotenv` (for managing environment variables in Python applications)\n\n## Installation 🛠️\n\n1. Clone this repository: `git clone https://github.com/0xTaoDev/Wallet-Trades-Tracker.git`\n2. Install the required packages: `pip install -r requirements.txt`\n3. Create a virtual environnment : `python -m venv venv`\n4. Populate these variables located in .env file located in the main directory.\n```python\n    DISCORD_WEBHOOK_URL=\"\"\n    TELEGRAM_BOT_TOKEN=\"\"\n    TELEGRAM_CHAT_ID=\"\"\n```\n4. Edit `wallets.txt` with your own wallets to track\u003cbr\u003eFormat: BLOCKCHAIN:ADDRESS (e.g.:ETHEREUM:0xae2fc483527b8ef99eb5d9b44875f005ba1fae13)\n5. Start the tool with `python run.py`\n\n## Known issues 🚩\n\n`ImportError: cannot import name 'getargspec' from 'inspect'` : you need to uninstall web3 and install it again in order to update it.\n\n## Screenshots 📸\n\n\u003cp align=\"center\"\u003e\n    \u003cimg src=\"images/image1.png\"/\u003e\n    \u003cimg src=\"images/image2.png\"/\u003e\n\u003c/p\u003e\n\n# 📝 TO-DO\n- [ ] Integrate others EVM-compatible blockchains\n\n# 🤝 Contributions\nIf you are interesting in contributing, fork the repository and submit a pull request in order to merge your improvements into the main repository.\u003cbr\u003e\nContact me for any inquiry, I will reach you as soon as possible.\u003cbr\u003e\n[![Discord](https://img.shields.io/badge/Discord-%237289DA.svg?logo=discord\u0026logoColor=white)](https://discord.gg/QxwPGcXDp7)\n[![Twitter](https://img.shields.io/badge/Twitter-%231DA1F2.svg?logo=Twitter\u0026logoColor=white)](https://twitter.com/0xTaoDev)\n\n## License 🧾\n\nThis project is licensed under the MIT license. Feel free to edit and distribute this template as you like.\u003cbr\u003e\nSee [LICENSE](LICENSE) for more information.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F0xtaodev%2Fwallet-trades-tracker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F0xtaodev%2Fwallet-trades-tracker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F0xtaodev%2Fwallet-trades-tracker/lists"}