Skip to content

πŸ”Ž Real-time scanner for newly created token contracts on Ethereum and Polygon networks using Mobula API.

License

Notifications You must be signed in to change notification settings

BitMorphX/tokens_scanner

Repository files navigation

tokens_scanner banner

πŸ›°οΈ Tokens Contract Scanner (tokens_scanner.py)

This script continuously scans and logs newly created cryptocurrency token contracts on the Ethereum and Polygon networks. It is designed for blockchain analysts, developers, and educators who want to monitor market activity and discover newly deployed tokens in real-time.


πŸ› οΈ Features

  • Real-time contract discovery via Mobula API
  • Tracks newly listed tokens on Ethereum and Polygon
  • Displays token data in a clean, colorized terminal format
  • Automatically logs contracts into separate text files:
    • eth_new_contracts.txt
    • pol_new_contracts.txt
  • Auto-refreshes every 0.5 to 3 seconds
  • Displays tokens in batches of 18 with scrolling updates

βš™οΈ How to Use

1. πŸ” Obtain a Mobula API Key

To use this scanner, you need a Mobula API key:

  1. Visit the official documentation: https://docs.mobula.io/introduction

  2. Sign in or register an account

  3. Generate your personal API key

  4. Open the script tokens_scanner.py and replace this line:

    API_KEY = "your_api_key"

    with your actual key:

    API_KEY = "YOUR_REAL_API_KEY"

🚫 Never share your API key with others β€” it is your personal access token!


πŸ“‚ Running the Program

Option 1 – via Python:

python tokens_scanner.py

Option 2 – via .bat launcher (Windows):

tokens_scanner.bat

The scanner will automatically:

  • Connect to Mobula API
  • Fetch new tokens
  • Display results in your terminal
  • Save contracts to:
    • eth_new_contracts.txt
    • pol_new_contracts.txt

πŸ§ͺ Requirements

Install the required Python packages:

pip install requests

Or use the provided requirements file:

pip install -r requirements.txt

Python 3.6+ is required.


πŸ“„ Output Files

File Name Description
eth_new_contracts.txt List of new Ethereum token contracts
pol_new_contracts.txt List of new Polygon token contracts

πŸ“ Project Structure

tokens_scanner/
β”œβ”€β”€ assets/
β”‚   └── banner.png
β”œβ”€β”€ .vscode/
β”‚   β”œβ”€β”€ settings.json
β”‚   β”œβ”€β”€ launch.json
β”‚   β”œβ”€β”€ tasks.json
β”‚   └── extensions.json
β”œβ”€β”€ .github/
β”‚   └── FUNDING.yml
β”œβ”€β”€ tokens_scanner.py
β”œβ”€β”€ tokens_scanner.bat
β”œβ”€β”€ LICENSE
β”œβ”€β”€ NOTICE
β”œβ”€β”€ ETHICS.md
β”œβ”€β”€ README.md
β”œβ”€β”€ requirements.txt
β”œβ”€β”€ RELEASE_v1.0.0.md
└── RELEASE_v2.0.0.md

πŸ” GitHub Contribution Streak

GitHub Streak


⚠️ DISCLAIMER

This software is intended strictly for educational and research purposes.

  • All provided data is for informational use only and not financial advice
  • The creator bears no responsibility for losses or damages resulting from usage
  • Use it at your own risk and always verify independently

Use responsibly. Learn ethically. Contribute honestly.


βš–οΈ Ethical Use

This tool is created strictly for research and educational purposes. See ETHICS for the full statement.


πŸ“œ License

Licensed under the Apache 2.0 License


πŸ“£ NOTICE

See NOTICE for important information about attribution, DMCA protection, and reuse permissions.


🍱 Support

β˜… Bitcoin (BTC)
1MorphXyhHpgmYSfvwUpWojphfLTjrNXc7

β˜… Monero (XMR)
86VAmEogaZF5WDwR3SKtEC6HSEUh6JPA1gVGcny68XmSJ1pYBbGLmdzEB1ZzGModLBXkG3WbRv12mSKv4KnD8i9w7VTg2uu

β˜… Dash (DASH)
XtNuNfgaEXFKhtfxAKuDkdysxUqaZm7TDX

We also value early privacy coins such as:
β˜… Bytecoin (BCN)
bcnZNMyrDrweQgoKH6zpWaE2kW1VZRsX3aDEqnxBVEQfjNnPK6vvNMNRPA4S7YxfhsStzyJeP16woK6G7cRBydZm2TvLFB2eeR

πŸ™ Thank you for supporting independent research and ethical technology.


πŸ‘€ Author & Contact

πŸ”— GitHub: https://github.com/BitMorphX
βœ‰οΈ Email: BitMorphX@proton.me
πŸ’¬ Telegram: https://t.me/BitMorphX

β€œI morph bits, not to break, but to understand.”
β€” BitMorphX


Β© BitMorphX – All rights reserved.