An open API service indexing awesome lists of open source software.

https://github.com/yllvar/smart_money_follower

Using GMGN Smart Degen to analyze top performing wallet and rank it based on profitability and honeypot evaluation
https://github.com/yllvar/smart_money_follower

Last synced: about 1 year ago
JSON representation

Using GMGN Smart Degen to analyze top performing wallet and rank it based on profitability and honeypot evaluation

Awesome Lists containing this project

README

          

# 🚀 Smart Money Follower
---
Screenshot 2025-02-01 at 15 46 44
---

## 📖 Overview

The Smart Money Follower is a Python-based tool designed to analyze and track top-performing wallets in the cryptocurrency space using the GMGN.ai wrapper. It provides valuable insights into wallet activities, evaluates traded tokens, and presents data in a structured, easy-to-analyze format.

## ✨ Features

- 🔍 **Fetch Top Wallets**: Leverages the GMGN.ai API to retrieve top-performing wallets based on customizable criteria like timeframe and walletTag.
- 📊 **Analyze Wallet Activity**: Tracks and analyzes trading activities of identified wallets over a specified period.
- 💰 **Evaluate Tokens**: Retrieves detailed information and USD prices of tokens traded by the analyzed wallets.
- 🖥️ **Output Presentation**: Displays analyzed data in a clean, tabulated format for easy interpretation and decision-making.

## 🛠️ How to Use

Follow these steps to get started with the Smart Money Follower:

1. **Clone the Repository**:
\`\`\`
git clone https://github.com/yllvar/Smart_Money_Follower.git
\`\`\`

2. **Install Dependencies**:
Make sure you have Python installed, then run:
\`\`\`
pip install -r requirements.txt
\`\`\`

3. **Run the Script**:
Execute one of the following commands to start the tool:
\`\`\`
python wallet.py
\`\`\`
or
\`\`\`
python smartMoney.py
\`\`\`

## 📋 Example Output

Here's an example of the tabulated output generated by the tool:

Screenshot 2025-02-01 at 15 58 25

Note: The 'Realized Profit' is represented in SOL.

## 📝 Notes

- ⚠️ **API Rate Limits**: Adjust the rate limits (\`time.sleep(1)\`) in the code to comply with the GMGN.ai API usage guidelines and avoid rate-limiting issues.
- 🛡️ **Logging**: Logging is implemented to track errors and activities, making debugging easier.

## 💡 Acknowledgments

This project is based on the work of 1f1n and their repository: [gmgnai-wrapper](https://github.com/1f1n/gmgnai-wrapper).

Big shoutout to 1f1n for their amazing work! 🙌

## 🤝 Contributing

Feel free to fork this repository, make improvements, and submit a pull request. Contributions are always welcome!

## 📜 License

This project is open-source and free to use. Modify it as you see fit!

## 🌟 Show Your Support

If you find this tool helpful, give the repository a ⭐ on GitHub!