{"id":50851750,"url":"https://github.com/anthonystepvoy/sol-wallet-analyzer","last_synced_at":"2026-06-14T14:03:09.598Z","repository":{"id":311492536,"uuid":"1019215885","full_name":"anthonystepvoy/sol-wallet-analyzer","owner":"anthonystepvoy","description":"Professional Solana wallet analyzer with real-time trader discovery. Advanced FIFO PnL calculations, multi-API redundancy, and comprehensive trading metrics for DeFi analysis.","archived":false,"fork":false,"pushed_at":"2025-08-24T19:09:50.000Z","size":175,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-08-24T23:21:05.824Z","etag":null,"topics":["copytrading","crypto","solana","trading","wallets"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","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/anthonystepvoy.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":"SECURITY_IMPROVEMENTS.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-07-14T01:36:59.000Z","updated_at":"2025-08-24T14:08:01.000Z","dependencies_parsed_at":"2025-08-24T23:21:17.718Z","dependency_job_id":"ca431afa-331b-4f76-810b-e1aab032b22b","html_url":"https://github.com/anthonystepvoy/sol-wallet-analyzer","commit_stats":null,"previous_names":["anthonystepvoy/sol-wallet-analyzer"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/anthonystepvoy/sol-wallet-analyzer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anthonystepvoy%2Fsol-wallet-analyzer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anthonystepvoy%2Fsol-wallet-analyzer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anthonystepvoy%2Fsol-wallet-analyzer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anthonystepvoy%2Fsol-wallet-analyzer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/anthonystepvoy","download_url":"https://codeload.github.com/anthonystepvoy/sol-wallet-analyzer/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anthonystepvoy%2Fsol-wallet-analyzer/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34324004,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-14T02:00:07.365Z","response_time":62,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["copytrading","crypto","solana","trading","wallets"],"created_at":"2026-06-14T14:03:08.890Z","updated_at":"2026-06-14T14:03:09.592Z","avatar_url":"https://github.com/anthonystepvoy.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🚀 Solana Wallet Analyzer \u0026 Trader Discovery\n\n\u003e **Professional-grade Solana wallet analysis tool with real-time trader discovery capabilities**\n\u003cdiv align=\"center\"\u003e\n    \n[![MIT License](https://img.shields.io/badge/License-MIT-green.svg)](https://choosealicense.com/licenses/mit/)\n[![TypeScript](https://img.shields.io/badge/TypeScript-007ACC?logo=typescript\u0026logoColor=white)](https://www.typescriptlang.org/)\n[![Solana](https://img.shields.io/badge/Solana-9945FF?logo=solana\u0026logoColor=white)](https://solana.com/)\n    \n\u003c/div\u003e\n\nA sophisticated, enterprise-grade tool for analyzing Solana wallet trading performance and discovering profitable traders in real-time. Built with advanced FIFO accounting, multi-API redundancy, and comprehensive security features.\n\n## Features\n\n### 📊 Wallet Analysis\n- **PnL Calculation**: Accurate profit/loss using FIFO methodology\n- **Trading Metrics**: Win rates, trade counts, volume analysis\n- **Multi-API Support**: InstantNodes (primary) + Helius + BlockDaemon\n- **Token Filtering**: Focuses on legitimate projects, filters stablecoins\n- **Confidence Scoring**: Data quality assessment\n\n### 🔍 Live Trader Discovery\n- **Real-time Monitoring**: WebSocket connection to DEX transactions\n- **Auto-discovery**: Identifies active traders with significant volume\n- **Smart Filtering**: Queues promising wallets for analysis\n- **Platform Detection**: Jupiter, Raydium, pump.fun support\n\n## 🎯 Key Features\n\n### 🏆 **Professional-Grade Analysis**\n- **FIFO Accounting**: Industry-standard First-In-First-Out methodology for accurate PnL calculations\n- **Multi-API Redundancy**: Seamless failover between InstantNodes, Helius, and BlockDaemon\n- **Real-time Discovery**: Live monitoring of DEX transactions to identify profitable traders\n- **Security-First**: Built-in rate limiting, input validation, and secure API handling\n\n### 📈 **Advanced Analytics**\n- **Comprehensive Metrics**: Win rates, trade frequency, volume analysis, and risk assessment\n- **Token Intelligence**: Automatic filtering of legitimate projects vs. scam tokens\n- **Platform Detection**: Support for Jupiter, Raydium, pump.fun, and other major DEXs\n- **Confidence Scoring**: Data quality assessment for reliable analysis\n\n### ⚡ **Performance Optimized**\n- **Intelligent Caching**: Reduces API calls and improves response times\n- **Batch Processing**: Efficient handling of large transaction datasets\n- **Memory Management**: Optimized for analyzing high-volume traders\n\u003cdiv align=\"center\"\u003e\n\u003cimg width=\"602\" height=\"764\" alt=\"image\" src=\"https://github.com/user-attachments/assets/5150ec30-31f9-4d0c-9529-7bce1a18737b\" /\u003e\n\n\u003cimg width=\"594\" height=\"842\" alt=\"image\" src=\"https://github.com/user-attachments/assets/68088015-5742-489c-a8c9-587b4aa4706a\" /\u003e\n\u003c/div\u003e\n\n## 🚀 Quick Start\n\n### Prerequisites\n```bash\nnpm install\n```\n\n### Environment Setup\nCopy `.env.example` to `.env` and configure:\n```bash\n# Required\nHELIUS_API_KEY=your_helius_api_key\n\n# Optional but recommended\nINSTANTNODES_RPC_URL=your_instantnodes_url\nHELIUS_RPC_URL=your_helius_rpc_url\nBLOCK_DAEMON_KEY=your_blockdaemon_key\nJUPITER_API_KEY=your_jupiter_key\n```\n\n## Usage\n\n### Analyze Specific Wallet\n```bash\n# Interactive mode\nnpm run analyze\n\n# Single wallet analysis\nnpm run analyze \u003cwallet_address\u003e [days]\n\n# Example\nnpm run analyze FzMxzVHtfEfQBNNHGV4cKdpL6GZmG5mWxr3LVrWxsKL 30\n```\n\n### Discover Profitable Traders\n```bash\n# Start live discovery engine\nnpm run discover\n```\n\nThe discovery engine will:\n1. Monitor live DEX transactions\n2. Identify wallets with significant trading volume\n3. Automatically analyze promising traders\n4. Highlight potential copytrading candidates\n\n## API Configuration\n\n### Single API (Helius only)\n- Basic functionality with Helius API key only\n\n### Dual API (Recommended)\n- InstantNodes for signature fetching (faster, cost-effective)\n- Helius for transaction parsing and WebSocket monitoring\n\n### Triple API (Enterprise)\n- Adds BlockDaemon for validation and fallback\n\n## Core Services\n\n### Data Acquisition (`dataAcquisition.ts`)\n- Multi-provider transaction fetching\n- Automatic fallback between APIs\n- Rate limit optimization\n\n### PnL Engine (`pnlEngine.ts`)\n- FIFO-based profit/loss calculation\n- Handles complex swap scenarios\n- SOL/WSOL normalization\n\n### Swap Processor (`swapProcessor.ts`)\n- Transaction parsing and classification\n- Platform identification\n- Token transfer analysis\n\n### Live Monitoring (`liveSwapMonitor.ts`)\n- WebSocket-based real-time monitoring\n- DEX program log subscriptions\n- Large transaction detection\n\n## Project Structure\n\n```\nsrc/\n├── index.ts              # Main wallet analyzer\n├── services/\n│   ├── walletAnalyzer.ts     # Core analysis engine\n│   ├── dataAcquisition.ts    # Multi-API data fetching\n│   ├── pnlEngine.ts          # PnL calculations\n│   ├── swapProcessor.ts      # Transaction processing\n│   ├── liveSwapMonitor.ts    # Real-time monitoring\n│   ├── analyticsService.ts   # Trading metrics\n│   ├── reportFormatter.ts    # Output formatting\n│   └── ...\n└── types/\n    └── index.ts          # TypeScript definitions\n\nwallet-discovery.ts       # Live trader discovery engine\n```\n\n## Analysis Output\n\nThe analyzer provides:\n- **Trading Performance**: Win rate, total PnL, trade frequency\n- **Token Analysis**: Most traded tokens, performance per token\n- **Platform Usage**: DEX platform distribution\n- **Risk Metrics**: Confidence scores and data quality indicators\n- **Time-based Insights**: Performance trends over time\n\n## Discovery Criteria\n\nWallets are automatically analyzed if they meet any of:\n- Total volume \u003e 20 SOL\n- Number of swaps \u003e 3\n- Single swap \u003e 10 SOL\n\nPromising traders are identified with:\n- Win rate \u003e 70%\n- Total PnL \u003e 10 SOL\n- Minimum 5 completed trades\n\n## FIFO Methodology\n\nThe analyzer uses First-In-First-Out (FIFO) accounting:\n- When buying: Creates new \"lots\" with purchase price and quantity\n- When selling: Consumes oldest lots first to calculate cost basis\n- Tracks holding duration from first purchase to sale\n- Calculates realized PnL as: (Sale Proceeds - Cost Basis)\n\n## Supported Platforms\n\n- **Jupiter**: `JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4`\n- **Raydium**: `675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8`\n- **pump.fun**: `6EF8rrecthR5Dkzon8Nwu78hRvfCKubJ14M5uBEwF6P`\n\n## Contributing\n\nThis project focuses on defensive security and trading analysis. Contributions should maintain this focus and avoid any functionality that could be used maliciously.\n\n## License\n\nMIT License\n\n**Note**: This project was originally built for personal use and is now being shared publicly to contribute to the developer community.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fanthonystepvoy%2Fsol-wallet-analyzer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fanthonystepvoy%2Fsol-wallet-analyzer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fanthonystepvoy%2Fsol-wallet-analyzer/lists"}