Bubblemaps for Top Traders of a token

Bounty Description: Create a tool that mirrors the existing Bubblemaps visualization, focusing on connecting the top traders of a specific token, rather than the top holders. The objective is to reveal relationships between top traders.

Key functions: Upon receiving a contract address, your tool should:

1. Generate a visual that shows the top traders of a token as bubbles (that mirrors the existing Bubblemaps visualization).

2. Display connections between those top traders as lines.

3. Bonus points would be given to modularity and interchangeability.

4. The tool could be hosted in custom websites or other tools, as long as it provides a friendly UI/UX.

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: