Bubblemaps Telegram Bot

Bubblemaps Telegram Bot

Bounty Description: Develop a Telegram bot that allows users to input the contract address of any token supported by Bubblemaps.

Key functions: Upon receiving the contract address, the bot should:

1. Generate and return a screenshot of the token's bubble map.

2. Provide relevant token information, including: Market cap, price, volume, etc.

3. Decentralization score

4. Any additional insightful data that would be valuable to everyday users.
   

Submission Requirements:

• Deadline: Submissions are due by April 30th, 2025, in alignment with the hackathon's timeline.

• Deliverables:

  1. Fully functional tool with source code.

  2. Comprehensive documentation detailing installation, usage, dependencies, and any methodologies employed.

  3. Demonstration of the bot's capabilities and effectiveness using a real token, preferably one from Bubblemaps’ past investigations. This can be done in a variety of ways:

     1. A recorded video

     2. Detailed case study

Evaluation Criteria:

The bounty will be given to one submission only.

• Functionality: The solution performs as intended without significant issues.

• User Experience: The interface is intuitive and accessible to users with varying levels of expertise.

• Innovation: The solution offers unique features or insights beyond existing tools.

• Documentation: Clear and thorough documentation that facilitates understanding and replication.

• Performance: Efficient data processing and visualization without undue latency.

Additional Resources:

• Bubblemaps Website

• iframe integration: Bubble maps can be embedded into a site as a widget. You can see some examples on CoinGecko, DexScreener, pump.fun, etc.

• Bubblemaps API: Provides all details from a bubble map, including the list of holders, their holdings (amounts and percentages), and transfers between them.

  • Score API: Measures the decentralization of a token based on its distribution. More clusters and large individual holders result in a lower score. Check Etherscan as an example: