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

πŸ›°οΈ Token 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

  1. Ensure required dependencies are installed
  2. Run the script via terminal:
python3 tokens_scanner.py

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 colorama

Or use the provided requirements file:

pip install -r requirements.txt

πŸ“„ 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

πŸ“ƒ License

MIT License β€” see LICENSE


⚠️ Disclaimer

This software is intended for educational and informational purposes only.

  • Many newly deployed tokens may be scams, honeypots, or contain malicious logic
  • Always perform your own research before making any financial decisions
  • The author assumes no responsibility for any loss, misuse, or outcomes arising from use of this software
  • Do not share your API key β€” it can be abused or exploited

By using this software, you agree to all terms and accept full responsibility for your actions.


πŸ’Έ Donations

If you find this tool helpful and would like to support further development:

  • Bitcoin (BTC):
    1MorphXyhHpgmYSfvwUpWojphfLTjrNXc7

  • Monero (XMR):
    86VAmEogaZF5WDwR3SKtEC6HSEUh6JPA1gVGcny68XmSJ1pYBbGLmdzEB1ZzGModLBXkG3WbRv12mSKv4KnD8i9w7VTg2uu

  • Dash (DASH):
    XtNuNfgaEXFKhtfxAKuDkdysxUqaZm7TDX

  • Bytecoin (BCN):
    bcnZNMyrDrweQgoKH6zpWaE2kW1VZRsX3aDEqnxBVEQfjNnPK6vvNMNRPA4S7YxfhsStzyJeP16woK6G7cRBydZm2TvLFB2eeR

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

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

About

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

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages