{"id":24571167,"url":"https://github.com/hamzahamidi/solscan-analyzer","last_synced_at":"2025-03-17T08:26:38.416Z","repository":{"id":270774762,"uuid":"911385259","full_name":"hamzahamidi/solscan-analyzer","owner":"hamzahamidi","description":"Solscan Token Analyzer","archived":false,"fork":false,"pushed_at":"2025-01-04T22:33:53.000Z","size":5,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-23T17:59:35.083Z","etag":null,"topics":["cryptocurrency","solana","solana-token","token-analyzer"],"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/hamzahamidi.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-01-02T22:25:50.000Z","updated_at":"2025-01-04T22:33:56.000Z","dependencies_parsed_at":"2025-01-03T02:28:47.778Z","dependency_job_id":"77d1c4fb-c728-47ab-ac8b-a98b2341e5a4","html_url":"https://github.com/hamzahamidi/solscan-analyzer","commit_stats":null,"previous_names":["hamzahamidi/solscan-analyzer"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hamzahamidi%2Fsolscan-analyzer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hamzahamidi%2Fsolscan-analyzer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hamzahamidi%2Fsolscan-analyzer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hamzahamidi%2Fsolscan-analyzer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hamzahamidi","download_url":"https://codeload.github.com/hamzahamidi/solscan-analyzer/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243997966,"owners_count":20381128,"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","solana","solana-token","token-analyzer"],"created_at":"2025-01-23T17:59:51.126Z","updated_at":"2025-03-17T08:26:38.389Z","avatar_url":"https://github.com/hamzahamidi.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Solscan Token Analyzer\n\nThis api uses Solscan to analyze specific tokens on the Solana blockchain. The agent takes a token's address as input and provide detailed insights about the top N wallets holding that token (where N is a variable I can configure).\n\nThe analysis includes the following for each wallet:\n\n- How long the wallet has been active.\n- Patterns of token holding (long-term holder vs. frequent flipper).\n- How much of the specified token the wallet holds.\n- How active the wallet is in transactions involving this token.\n- Other tokens held by the wallet.\n\n## Requirements\n\n- Python 3.8+\n- Solscan account pro subscription (for API access)\n\n## Installation\n\n1. **Fork and Clone the Repository**\n\n   ```bash\n   git clone \u003cyour-forked-repo-url\u003e\n   cd \u003crepository-folder\u003e\n   ```\n\n2. **Create a Virtual Environment**\n\n   ```bash\n   python -m venv venv\n   source venv/bin/activate  # On Windows, use venv\\Scripts\\activate\n   ```\n\n3. **Install Dependencies**\n\n   ```bash\n   pip install -r requirements.txt\n   ```\n\n4. **Set Up Environment Variables**\n   Create a `keys.env` file in the root directory with the following format:\n\n   ```env\n    # SOLSCAN API credentials\n    SOLSCAN_API_KEY=\u003cYOUR_SOLSCAN_API_KEY\u003e\n\n    # OPENAI API credentials\n    OPENAI_API_KEY=\u003cYOUR_OPENAI_API_KEY\u003e\n\n    # Top N wallets holding that token\n    # Default: 10\n    # N should be 10, 20, 30 or 40\n    TOP_N=10\n   ```\n\n5. **Run the application**\n\n   ```bash\n   python index.py\n   ```\n\n## File Structure\n\n- `index.py`: Main script that handles solscan API requests and data analysis.\n- `keys.env`: Contains sensitive credentials and configurations.\n- `requirements.txt`: Python dependencies for the project.\n\n## Contributing\n\n1. **Fork the Repository**: Click the fork button at the top of this page.\n2. **Clone Your Fork**: Clone your forked repository to your local machine.\n\n   ```bash\n   git clone \u003cyour-forked-repo-url\u003e\n   ```\n\n3. **Create a New Branch**: Create a feature branch for your changes.\n\n   ```bash\n   git checkout -b feature/your-feature-name\n   ```\n\n4. **Make Changes and Commit**:\n\n   ```bash\n   git add .\n   git commit -m \"Add your message\"\n   ```\n\n5. **Push to Your Fork**:\n\n   ```bash\n   git push origin feature/your-feature-name\n   ```\n\n6. **Submit a Pull Request**: Open a pull request to merge your changes into the main repository.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhamzahamidi%2Fsolscan-analyzer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhamzahamidi%2Fsolscan-analyzer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhamzahamidi%2Fsolscan-analyzer/lists"}