{"id":25152466,"url":"https://github.com/yllvar/gmgn-trendinganalyzer","last_synced_at":"2026-04-28T11:04:00.008Z","repository":{"id":275575329,"uuid":"926496353","full_name":"yllvar/gmgn-TrendingAnalyzer","owner":"yllvar","description":"Analyze gmgn.ai token data over multiple timeframes, groups by token address, computes the aggregated metrics (including a consistency count), filters out tokens based on volume and market cap thresholds, and then sorts the results.","archived":false,"fork":false,"pushed_at":"2025-02-03T11:52:55.000Z","size":536,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-03T09:44:49.574Z","etag":null,"topics":["cryptocurrency","gmgnai","memecoin","solana"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/yllvar.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-02-03T11:07:42.000Z","updated_at":"2025-03-28T04:12:35.000Z","dependencies_parsed_at":"2025-02-03T12:37:47.989Z","dependency_job_id":null,"html_url":"https://github.com/yllvar/gmgn-TrendingAnalyzer","commit_stats":null,"previous_names":["yllvar/gmgn-trendinganalyzer"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yllvar%2Fgmgn-TrendingAnalyzer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yllvar%2Fgmgn-TrendingAnalyzer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yllvar%2Fgmgn-TrendingAnalyzer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yllvar%2Fgmgn-TrendingAnalyzer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yllvar","download_url":"https://codeload.github.com/yllvar/gmgn-TrendingAnalyzer/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246981147,"owners_count":20863825,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cryptocurrency","gmgnai","memecoin","solana"],"created_at":"2025-02-08T23:17:40.066Z","updated_at":"2026-04-28T11:03:59.910Z","avatar_url":"https://github.com/yllvar.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🚀 GMGN Trending Token Analyzer\n\n---\n\n\u003cimg width=\"1138\" alt=\"Screenshot 2025-02-03 at 19 11 42\" src=\"https://github.com/user-attachments/assets/61dfce39-417d-47ef-b166-0b6c108fe815\" /\u003e\n\nA sophisticated tool for analyzing trending cryptocurrency tokens across multiple timeframes using the GMGN.ai wrapper. The analyzer aggregates data, filters tokens based on key metrics, and provides visual analytics along with expert analysis.\n\n\u003cimg width=\"1360\" alt=\"Screenshot 2025-02-03 at 19 19 18\" src=\"https://github.com/user-attachments/assets/6bdcf69e-8c7f-4a0e-b6d4-f0d1b8501363\" /\u003e\n\n---\n\n## 🔥 Features\n\n- 📊 **Multi-timeframe token trend analysis** (1m, 5m, 1h, 6h, 24h)\n- 📈 **Data aggregation and filtering** based on volume, market cap, and consistency\n- 🎨 **Automated visualization generation**\n- ⏳ **Continuous monitoring** with automated refresh\n\n## 📌 Technical Analysis Components\n\n### 🏷️ Token Analysis Logic\n- Fetches trending tokens across multiple timeframes\n- Collects key metrics:\n  - 🆔 Token ID, 🔗 Chain, 🏠 Address\n  - 🔤 Symbol, 💰 Price, 📊 Volume\n  - 🌎 Market Cap, 📉 Price Change Percentage\n- 🚨 Error handling for API requests\n- 🔍 Validation of token data integrity\n\n### 📊 Aggregation Logic\n- Groups tokens by address\n- Calculates key aggregated metrics:\n  - 📈 Average price and volume\n  - 📏 Median market cap\n  - 🔀 Price change trends\n  - 🔁 **Consistency count** (appearance across timeframes)\n- **Filtering criteria:**\n  - ✅ Minimum **volume threshold**: 1000\n  - ✅ Minimum **market cap threshold**: 10000\n  - ✅ Minimum **consistency count**: 3 timeframes\n\n### 📉 Visualization Logic\n- Generates **scatter plot visualization**:\n  - 📍 X-axis: **Median Market Cap** (log scale)\n  - 📍 Y-axis: **Average Volume** (log scale)\n  - 🎈 Bubble size: **Consistency count**\n  - 🎨 Color gradient: **Average price change**\n- 🔤 Includes **token symbol annotations**\n- 🖼️ Saves **high-resolution plot** (300 DPI)\n\n## 🛠 Installation\n\n1️⃣ Clone the repository:\n```bash\ngit clone https://github.com/yllvar/gmgn-TrendingAnalyzer.git\ncd gmgn-TrendingAnalyzer\n```\n\n2️⃣ Create and activate a **virtual environment** (optional but recommended):\n```bash\npython -m venv venv\nsource venv/bin/activate  # On Windows: venv\\Scripts\\activate\n```\n\n3️⃣ Install dependencies:\n```bash\npip install -r requirements.txt\n```\n\n## 🚀 Usage\n\nRun the analyzer:\n```bash\npython analyzer.py\n```\n\nThe script will:\n- 📡 Fetch trending tokens **every 60 seconds**\n- 🧠 Generate **analysis and visualizations**\n- 🖼️ Save plots as **'trending_analysis_plot.png'**\n- 📑 Save analysis as **'trending_analysis.csv'**\n- 🖥️ Display token data and analysis in the **console**\n\nTo stop the script, press **Ctrl+C**.\n\n## 📤 Output\n\nThe analyzer produces:\n- 📑 **Tabulated token data** with key metrics\n- 🔗 **List of token addresses** for easy reference\n- 📊 **Visual plot saved** as `'trending_analysis_plot.png'`\n\n## 📦 Dependencies\n\n- 🐍 `pandas` – Data manipulation and analysis\n- 📊 `matplotlib` – Data visualization\n- 📜 `tabulate` – Console table formatting\n- 🔑 `python-dotenv` – Environment variable management\n\n# ⚠️ Notes\n\n## 💡 Acknowledgments\n\nThis project is based on the work of 1f1n and his repository: [gmgnai-wrapper](https://github.com/1f1n/gmgnai-wrapper).\n\nBig shoutout to 1f1n for his amazing work! 🙌\n\n## 🤝 Contributing\n\nFeel free to fork this repository, make improvements, and submit a pull request. Contributions are always welcome!\n\n## 📜 License\n\nThis project is open-source and free to use. Modify it as you see fit!\n\n---\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyllvar%2Fgmgn-trendinganalyzer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyllvar%2Fgmgn-trendinganalyzer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyllvar%2Fgmgn-trendinganalyzer/lists"}