{"id":29173386,"url":"https://github.com/wangwilly/solana-trading-bot","last_synced_at":"2026-04-29T04:34:40.074Z","repository":{"id":279213320,"uuid":"938055009","full_name":"WangWilly/solana-trading-bot","owner":"WangWilly","description":"Solana Trading Bot / sol-trading-service / Solana 交易机器人 / Jupiter embedded","archived":false,"fork":false,"pushed_at":"2025-06-14T10:04:05.000Z","size":5146,"stargazers_count":15,"open_issues_count":0,"forks_count":6,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-11-18T14:39:18.206Z","etag":null,"topics":["auto-trading","blockchain","copytrade-bot","copytrading","crypto","jito","jupiter-aggregator","open-source","solana","solana-token-bot","trade-bot","web3"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/WangWilly.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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,"zenodo":null}},"created_at":"2025-02-24T10:53:45.000Z","updated_at":"2025-10-29T16:23:41.000Z","dependencies_parsed_at":"2025-02-24T12:33:39.151Z","dependency_job_id":"e6eb1576-8cff-4819-8ce9-510faa72cf9e","html_url":"https://github.com/WangWilly/solana-trading-bot","commit_stats":null,"previous_names":["wangwilly/sol-trading-service","wangwilly/solana-trading-bot"],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/WangWilly/solana-trading-bot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WangWilly%2Fsolana-trading-bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WangWilly%2Fsolana-trading-bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WangWilly%2Fsolana-trading-bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WangWilly%2Fsolana-trading-bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/WangWilly","download_url":"https://codeload.github.com/WangWilly/solana-trading-bot/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WangWilly%2Fsolana-trading-bot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32050451,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-20T11:35:06.609Z","status":"ssl_error","status_checked_at":"2026-04-20T11:34:48.899Z","response_time":94,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["auto-trading","blockchain","copytrade-bot","copytrading","crypto","jito","jupiter-aggregator","open-source","solana","solana-token-bot","trade-bot","web3"],"created_at":"2025-07-01T14:14:48.906Z","updated_at":"2026-04-20T14:03:01.272Z","avatar_url":"https://github.com/WangWilly.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🚀 Solana Copy Trading Service\n\n[中文說明](README.zh-CN.md)\n\n**Advanced multilingual copy trading platform with intelligent CLI interface for automated Solana token strategies**\n\n## ✨ Key Features\n\n### 🌐 **Multilingual Interface**\n- **🔄 Live Language Switching** - Change between English/Chinese instantly without restart\n- **📝 Complete Localization** - 60+ UI strings fully translated\n- **⚡ Real-time Updates** - Language changes apply immediately\n\n### 🎯 **Intelligent Copy Trading**\n- **👥 Wallet Following** - Monitor and copy successful trader strategies\n- **💰 Automated Buy/Sell** - Execute trades based on target wallet activities  \n- **🛡️ Risk Management** - Built-in position sizing and safety controls\n- **📊 Strategy Analytics** - Track performance and trading patterns\n\n### 🖥️ **Professional CLI Experience**\n- **🎨 Hierarchical Menu System** - Organized main menu with specialized submenus\n- **📱 Real-time Monitoring** - Live service status and strategy tracking\n- **📈 Portfolio Management** - Complete wallet and asset overview\n- **📋 Transaction History** - Detailed logging with searchable records\n- **💱 Direct Trading Interface** - Immediate buy/sell operations with advanced controls\n\n### ⚙️ **Enterprise-Grade Management**\n- **🔐 Secure Key Handling** - Military-grade private key protection\n- **🔧 Strategy Configuration** - Flexible buy/sell rule customization\n- **🚨 Service Control** - Complete start/stop/restart capabilities\n- **💾 Data Persistence** - Reliable strategy and log storage\n\n## 🏃‍♂️ Quick Start\n\n```bash\n# 1. Install dependencies\nnpm install\n\n# 2. Configure environment\ncp .env.example .env\n# Edit .env file and set your PRIVATE_KEY_BASE58\n\n# 3. Launch CLI (English)\nnpm run cli\n\n# 3a. Launch CLI (Chinese)\nnpm run cli:zh\n```\n\n### 🔧 Command Line Options\n\nThe CLI application supports the following command-line options:\n\n- `-k, --private-key \u003cstring\u003e` - Private key (base58 encoded) for the wallet (required)\n- `-l, --language \u003cstring\u003e` - Interface language (`en` for English, `zh` for Chinese, default: `en`)\n\n### 📋 Environment Variables\n\nConfigure your `.env` file with the following variables:\n\n- `PRIVATE_KEY_BASE58` - Your Solana wallet private key in base58 format\n- `LOG_LEVEL` - Logging level (default: `info`)\n- `ENABLE_PERSISTENCE` - Enable strategy persistence (default: `true`)\n- `PERSISTENCE_DATA_PATH` - Path for strategy data storage (default: `data/strategies.json`)\n\n## 🎛️ CLI Navigation\n\n### Main Menu Options:\n\n| Option | Feature | Description |\n|--------|---------|-------------|\n| 1️⃣ | **📊 Service Status** | Real-time monitoring of copy trading service health |\n| 2️⃣ | **📋 Strategy Management** | Complete strategy management submenu |\n| 3️⃣ | **💱 Token Trading** | Direct trading and swap operations submenu |\n| 4️⃣ | **📜 View Log History** | Comprehensive trading history and analytics |\n| 5️⃣ | **💼 View Wallet Assets** | Complete portfolio overview and token balances |\n| 6️⃣ | **🌐 Change Language** | Switch interface language (EN ↔ 中文) |\n| 7️⃣ | **❌ Exit Application** | Graceful shutdown with data persistence |\n\n### Strategy Management Submenu:\n\n| Option | Feature | Description |\n|--------|---------|-------------|\n| 1️⃣ | **📋 List Active Strategies** | View all running copy trading strategies |\n| 2️⃣ | **💰 Create Buy Strategy** | Set up automated buying based on target wallets |\n| 3️⃣ | **🔄 Create Sell Strategy** | Configure intelligent selling rules and triggers |\n| 4️⃣ | **🗑️ Remove Strategy** | Safely delete existing trading strategies |\n| 5️⃣ | **🔙 Back to Main Menu** | Return to main navigation |\n\n### Token Trading Submenu:\n\n| Option | Feature | Description |\n|--------|---------|-------------|\n| 1️⃣ | **💰 Direct Buy Token** | Execute immediate token purchase |\n| 2️⃣ | **💸 Direct Sell Token** | Execute immediate token sale |\n| 3️⃣ | **⚡ Quick Buy Token** | Fast token purchase with preset amounts |\n| 4️⃣ | **⚡ Quick Sell Token** | Fast token sale with preset amounts |\n| 5️⃣ | **⚙️ View Swap Config** | Display current swap configuration |\n| 6️⃣ | **🔧 Update Swap Config** | Modify swap settings and parameters |\n| 7️⃣ | **📊 View Swap History** | Review historical swap transactions |\n| 8️⃣ | **🔙 Back to Main Menu** | Return to main navigation |\n\n### 🌍 Supported Languages:\n- **🇺🇸 English** - Complete feature set with detailed help\n- **🇨🇳 中文** - Full Chinese localization with native UX\n- **🔄 Dynamic Switching** - Change languages without restarting\n\n## 🏗️ Technical Architecture\n\n### Core Technologies:\n- **⚡ TypeScript** - Type-safe development with modern ES features\n- **🔗 Solana Web3.js** - Native blockchain integration\n- **🎨 Inquirer.js** - Rich interactive CLI components\n- **🌐 i18n System** - Professional internationalization framework\n\n### Project Structure:\n```\nsrc/\n├── 🖥️  cli/               # Advanced CLI application\n│   ├── app.ts             # Main application controller\n│   ├── commands/          # Feature command modules\n│   ├── i18n/              # Multilingual support system\n│   │   ├── en.ts          # English translations\n│   │   ├── zh.ts          # Chinese translations\n│   │   └── types.ts       # Translation interfaces\n│   └── utils/             # CLI utilities and helpers\n├── 🎯 helpers/            # Copy trading engine\n└── 🔧 utils/              # Shared utilities\n```\n\n## 🛡️ Security \u0026 Reliability\n\n- **🔐 Private Key Protection** - Secure key handling, never logged or exposed\n- **✅ Transaction Validation** - Multi-layer verification before execution\n- **🚨 Error Recovery** - Comprehensive error handling with user guidance\n- **💾 Data Integrity** - Reliable strategy and transaction data storage\n\n## 📚 Getting Started Guide\n\n1. **Environment Setup**: Configure your `.env` file with `PRIVATE_KEY_BASE58` and other settings\n2. **First Run**: Launch the CLI using `npm run cli` or `npm run cli:zh` and explore the main menu\n3. **Strategy Management**: Navigate to Strategy Management to create and manage copy trading strategies\n4. **Direct Trading**: Use Token Trading submenu for immediate buy/sell operations\n5. **Monitoring**: Check Service Status and View Log History for real-time monitoring\n6. **Language Preference**: Use Change Language option to switch between English and Chinese\n\n---\n\n**📄 License**: OSNC-1.0 | **🔧 Node.js**: 18+ Required | **⚡ Runtime**: Node.js/Bun Compatible\n\n## 🔧 Development \u0026 Technical References\n\n### Jupiter Exchange Integration\n\nThe service utilizes [Jupiter](https://jup.ag/) for transaction processing on the Solana blockchain.\n\n#### Documentation\n- [General Documentation](https://station.jup.ag/docs/)\n- [API Overview](https://station.jup.ag/docs/swap-api/get-quote)\n- [Comprehensive API Documentation](https://station.jup.ag/docs/api/introduction)\n- [Supported Decentralized Exchanges](https://api.jup.ag/swap/v1/program-id-to-label)\n\n#### API Resources\n- [Fee Structure Information](https://station.jup.ag/guides/general/faq#does-jupiter-swap-charge-any-fees)\n- [Platform Fee Clarification](https://www.bbx.com/news-detail/1898146)\n- [Legacy API Documentation](https://station.jup.ag/docs/old/apis/landing-transactions)\n- [Swap Instructions Documentation](https://station.jup.ag/docs/api/swap-instructions)\n\n### Fee and Priority Optimization\n\n#### Transaction Fee Management\n- [Implementing Priority Fees on Solana](https://solana.com/developers/guides/advanced/how-to-use-priority-fees)\n- [Helius Priority Fee API Documentation](https://docs.helius.dev/solana-apis/priority-fee-api)\n- [Transaction Fee Optimization Discussion](https://www.reddit.com/r/solana/comments/1hudi6t/how_do_you_only_get_a_transaction_fee_of_0000005/)\n\n#### Compute Budget Optimization\n- [Official Solana Transaction Fee Documentation](https://solana.com/docs/core/fees)\n- [Requesting Optimal Compute Budget](https://solana.com/developers/guides/advanced/how-to-request-optimal-compute)\n- [JavaScript/TypeScript Helpers for Solana](https://github.com/solana-developers/helpers)\n\n### Additional Resources\n- [QuickNode Transaction Documentation](https://www.quicknode.com/docs/solana/transactions)\n- [Jito Low Latency Transaction Documentation](https://docs.jito.wtf/lowlatencytxnsend/#tip-amount)\n- [Jupiter API Trading Bot Guide](https://www.quicknode.com/guides/solana-development/3rd-party-integrations/jupiter-api-trading-bot)\n- [Copy Trading Implementation Guide](https://www.quicknode.com/guides/solana-development/defi/pump-fun-copy-trade)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwangwilly%2Fsolana-trading-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwangwilly%2Fsolana-trading-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwangwilly%2Fsolana-trading-bot/lists"}