{"id":32672279,"url":"https://github.com/allreality/jupiter-bot","last_synced_at":"2026-05-01T23:39:27.416Z","repository":{"id":321362322,"uuid":"1085534527","full_name":"Allreality/jupiter-bot","owner":"Allreality","description":"Jupiter DEX trading bot with x402 payment middleware for Solana","archived":false,"fork":false,"pushed_at":"2025-10-29T07:10:38.000Z","size":43,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-29T09:10:49.811Z","etag":null,"topics":["autonomous-agents","blockchain","blockchain-technology","dex","jupiter","payments","solana","tradingbot","typescript","x402","x402-agent"],"latest_commit_sha":null,"homepage":"https://github.com/Allreality/jupiter-bot","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/Allreality.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-10-29T07:07:18.000Z","updated_at":"2025-10-29T07:32:50.000Z","dependencies_parsed_at":"2025-10-29T09:11:46.002Z","dependency_job_id":"0c8182a3-7085-46a3-9aa5-aa839a1af9be","html_url":"https://github.com/Allreality/jupiter-bot","commit_stats":null,"previous_names":["allreality/jupiter-bot"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/Allreality/jupiter-bot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Allreality%2Fjupiter-bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Allreality%2Fjupiter-bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Allreality%2Fjupiter-bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Allreality%2Fjupiter-bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Allreality","download_url":"https://codeload.github.com/Allreality/jupiter-bot/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Allreality%2Fjupiter-bot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":282092841,"owners_count":26612896,"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","status":"online","status_checked_at":"2025-11-01T02:00:06.759Z","response_time":61,"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":["autonomous-agents","blockchain","blockchain-technology","dex","jupiter","payments","solana","tradingbot","typescript","x402","x402-agent"],"created_at":"2025-11-01T04:00:46.088Z","updated_at":"2025-11-01T04:02:08.401Z","avatar_url":"https://github.com/Allreality.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🌊 Jupiter Trading Bot\n\n**Production-ready Solana trading bot with real-time technical analysis, AI-powered signals, and comprehensive project management.**\n\n[![Status](https://img.shields.io/badge/status-production%20ready-green)]()\n[![Services](https://img.shields.io/badge/microservices-7-blue)]()\n[![License](https://img.shields.io/badge/license-MIT-green)]()\n\n---\n\n## 🎯 Overview\n\nJupiter Trading Bot is a complete trading automation platform featuring:\n- 🤖 **Automated Trading** - Real-time Raydium DEX integration\n- 📊 **Technical Analysis** - RSI, MACD, custom indicators\n- 🧠 **AI Signals** - Machine learning-powered trade recommendations\n- ⏱️ **Time Tracking** - Built-in project management\n- 💰 **Revenue System** - HTTP 402 payment infrastructure\n- 🌙 **MIDNIGHT Services** - 8 monetizable AI services\n- 📈 **Live Dashboards** - Real-time monitoring and analytics\n\n---\n\n## 🚀 Quick Start\n\n### Prerequisites\n```bash\n- Node.js 18+\n- TypeScript\n- Solana wallet (for live trading)\n- Conda (recommended)\n```\n\n### Installation\n```bash\n# Clone repository\ngit clone \u003cyour-repo\u003e\ncd jupiter-bot\n\n# Install dependencies\nnpm install\n\n# Create environment file\ncp .env.example .env\n# Edit .env with your settings\n\n# Build TypeScript\nnpm run build\n\n# Start all services\nnpm run start:everything\n```\n\n### Access Dashboards\n\n| Dashboard | URL | Purpose |\n|-----------|-----|---------|\n| 🏠 Hub | http://localhost:3004/index.html | Central navigation |\n| 📈 Live Trading | http://localhost:3004/dashboard.html | Real-time trading |\n| ⏱️ Time Tracker | http://localhost:3004/projects-dashboard.html | Project management |\n| 🎛️ Master Control | http://localhost:5003 | System overview |\n\n---\n\n## 🏗️ Architecture\n\n### Microservices Overview\n```\n┌─────────────────────────────────────────────────────────┐\n│                   Master Dashboard                       │\n│                    (Port 5003)                          │\n└────────────────────┬────────────────────────────────────┘\n                     │\n     ┌───────────────┼───────────────┬──────────────┐\n     │               │               │              │\n┌────▼────┐    ┌────▼────┐    ┌────▼────┐    ┌───▼────┐\n│Trading  │    │  x402   │    │MIDNIGHT │    │Project │\n│Bot API  │    │ Payment │    │Services │    │Tracker │\n│  5000   │    │  5001   │    │  5002   │    │  5004  │\n└─────────┘    └─────────┘    └─────────┘    └────────┘\n     │               │               │              │\n     └───────────────┴───────────────┴──────────────┘\n                     │\n               ┌─────▼──────┐\n               │ Dashboard  │\n               │  API 3003  │\n               └────────────┘\n```\n\n### Service Details\n\n#### 1. Trading Bot API (Port 5000)\n- Paper trading simulation\n- Live trading execution\n- Portfolio management\n- Order history tracking\n\n#### 2. x402 Payment Server (Port 5001)\n- HTTP 402 payment handling\n- Revenue tracking (90/10 agent split)\n- Payment history\n- Transaction logs\n\n#### 3. MIDNIGHT Services API (Port 5002)\nEight monetizable AI services:\n- zkProof Consulting\n- Compliance Oracle\n- Security Audit\n- Developer Assistant\n- Data Privacy Consulting\n- Smart Contract Review\n- Documentation Generator\n- Integration Support\n\n#### 4. Project Tracker (Port 5004)\n- Time tracking for multiple projects\n- Start/stop timers\n- Project analytics\n- Time reports\n\n#### 5. Dashboard API (Port 3003)\n- Raydium DEX integration\n- Real-time price quotes\n- Technical indicators (RSI, MACD)\n- Signal generation\n\n#### 6. UI Server (Port 3004)\n- Serves all web interfaces\n- Real-time updates\n- Responsive design\n\n#### 7. Project Dashboard (Port 5003)\n- System monitoring\n- Service health checks\n- Quick access links\n\n---\n\n## 📊 Features\n\n### Trading Features\n- ✅ Real-time SOL/USDC price tracking\n- ✅ Technical indicators (RSI, MACD)\n- ✅ AI-powered trading signals\n- ✅ Paper trading mode\n- ✅ Live trading ready\n- ✅ Portfolio management\n- ✅ Trade history\n\n### Technical Analysis\n- ✅ **RSI (14-period)** - Momentum indicator\n- ✅ **MACD (12,26,9)** - Trend following\n- ✅ **Signal Generation** - Multi-factor analysis\n- ✅ **Confidence Scoring** - 0-100% reliability\n- ✅ **Price History** - 200-point tracking\n\n### Project Management\n- ✅ Multi-project time tracking\n- ✅ One-click timer start/stop\n- ✅ Project categories\n- ✅ Time analytics\n- ✅ Export capabilities\n\n### Revenue Infrastructure\n- ✅ HTTP 402 payment system\n- ✅ Agent revenue splitting (90/10)\n- ✅ Transaction tracking\n- ✅ Revenue analytics\n\n---\n\n## 🔧 Configuration\n\n### Environment Variables\n```bash\n# Wallet Configuration\nWALLET_PRIVATE_KEY=your_private_key_here\n\n# Trading Configuration\nDEFAULT_SLIPPAGE_BPS=50\nMAX_TRADE_SIZE_SOL=1.0\nMIN_CONFIDENCE_THRESHOLD=70\n\n# API Keys (optional)\nRAYDIUM_API_KEY=optional\nJUPITER_API_KEY=optional\n\n# Server Ports (default values shown)\nPORT_TRADING=5000\nPORT_X402=5001\nPORT_MIDNIGHT=5002\nPORT_PROJECT=5003\nPORT_TRACKER=5004\nPORT_DASHBOARD=3003\nPORT_UI=3004\n```\n\n---\n\n## 📖 Usage\n\n### Starting Services\n```bash\n# Start everything\nnpm run start:everything\n\n# Start individual services\nnpm run start:trading      # Trading bot API\nnpm run start:x402         # Payment server\nnpm run start:midnight     # MIDNIGHT services\nnpm run start:dashboard    # Dashboard API\nnpm run start:tracker      # Project tracker\nnpm run start:project      # Project dashboard\nnpm run dashboard:ui       # UI server\n\n# Development mode\nnpm run dev\n```\n\n### Time Tracking\n\n1. Open project tracker: http://localhost:3004/projects-dashboard.html\n2. Select project from dropdown\n3. Click \"▶️ Start Working\"\n4. Work on your project\n5. Click \"⏹️ Stop Timer\"\n6. View tracked time and analytics\n\n### Trading Operations\n```bash\n# Paper trading (safe)\nnpm run auto:dry\n\n# Live trading (requires wallet)\nnpm run auto:live\n\n# Manual trade via API\ncurl -X POST http://localhost:5000/api/trade \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"pair\": \"SOL/USDC\",\n    \"amount\": 0.1,\n    \"action\": \"BUY\"\n  }'\n```\n\n### Adding New Projects\n\n1. Click \"➕ Add Project\"\n2. Enter project details:\n   - Name\n   - ID (auto-generated)\n   - Category\n   - Description\n3. Click \"Add Project\"\n4. Start tracking immediately!\n\n---\n\n## 🧪 Testing\n```bash\n# Run all tests\nnpm test\n\n# Run specific tests\nnpm test -- technical-indicators\nnpm test -- raydium-client\nnpm test -- trading-engine\n\n# Watch mode\nnpm test -- --watch\n\n# Coverage\nnpm test -- --coverage\n```\n\n### Test Results\n```\n✅ Technical Indicators: 7/7 passing\n✅ RSI Calculation: Validated\n✅ MACD Calculation: Validated\n✅ Signal Generation: Validated\n```\n\n---\n\n## 📈 API Reference\n\n### Trading Bot API (Port 5000)\n\n#### Get Health\n```bash\nGET /health\n```\n\n#### Execute Trade\n```bash\nPOST /api/trade\nContent-Type: application/json\n\n{\n  \"pair\": \"SOL/USDC\",\n  \"amount\": 0.1,\n  \"action\": \"BUY\" | \"SELL\"\n}\n```\n\n#### Get Portfolio\n```bash\nGET /api/portfolio\n```\n\n### Dashboard API (Port 3003)\n\n#### Get Quote\n```bash\nGET /api/quote/:from/:to/:amount\n\nExample:\nGET /api/quote/So11111111111111111111111111111111111111112/EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v/1\n\nResponse:\n{\n  \"price\": 193.79,\n  \"priceChange\": 0.5,\n  \"indicators\": {\n    \"rsi\": { \"value\": 53.2, \"signal\": \"NEUTRAL\" },\n    \"macd\": { \"macd\": 0.23, \"signal\": 0.18, \"histogram\": 0.05 },\n    \"signal\": { \"action\": \"HOLD\", \"confidence\": 65 }\n  }\n}\n```\n\n#### Get Indicators\n```bash\nGET /api/indicators\n```\n\n### Project Tracker API (Port 5004)\n\n#### List Projects\n```bash\nGET /api/projects\n```\n\n#### Start Timer\n```bash\nPOST /api/timer/start\nContent-Type: application/json\n\n{\n  \"projectId\": \"trading-bot\"\n}\n```\n\n#### Stop Timer\n```bash\nPOST /api/timer/stop\nContent-Type: application/json\n\n{\n  \"projectId\": \"trading-bot\"\n}\n```\n\n#### Add Project\n```bash\nPOST /api/projects\nContent-Type: application/json\n\n{\n  \"id\": \"new-project\",\n  \"name\": \"New Project\",\n  \"category\": \"Development\",\n  \"description\": \"Project description\"\n}\n```\n\n---\n\n## 🔒 Security\n\n### Best Practices\n\n1. **Never commit `.env` files** - Contains sensitive keys\n2. **Use paper trading first** - Test strategies safely\n3. **Set trade limits** - Protect your capital\n4. **Monitor logs** - Watch for suspicious activity\n5. **Regular backups** - Use Claude-Proof system\n\n### Claude-Proof System\n\nProtect your work before making changes:\n```bash\n# Create backup\n./claude-proof.sh backup\n\n# Protect with message\n./claude-proof.sh protect \"Before major refactor\"\n\n# List backups\n./claude-proof.sh list\n\n# Restore from backup\n./claude-proof.sh restore 20241029_201530\n```\n\n---\n\n## 🐛 Troubleshooting\n\n### Services Not Starting\n```bash\n# Kill all node processes\npkill -f node\n\n# Wait and restart\nsleep 3\nnpm run start:everything\n```\n\n### No Data in Dashboard\n\n1. Check VPN settings (some VPNs block Raydium API)\n2. Verify API is running: `curl http://localhost:3003/health`\n3. Check browser console for errors (F12)\n4. Try different browser or incognito mode\n\n### Projects Not Loading\n\n1. Verify tracker is running: `curl http://localhost:5004/health`\n2. Check CORS settings in browser\n3. Clear browser cache (Ctrl+Shift+Delete)\n4. Hard refresh page (Ctrl+Shift+R)\n\n### API Connection Errors\n```bash\n# Test each service\ncurl http://localhost:5000/health  # Trading\ncurl http://localhost:5001/health  # x402\ncurl http://localhost:5002/health  # MIDNIGHT\ncurl http://localhost:5003/        # Project dash\ncurl http://localhost:5004/health  # Tracker\ncurl http://localhost:3003/health  # Dashboard API\n```\n\n---\n\n## 📝 Development\n\n### Project Structure\n```\njupiter-bot/\n├── src/\n│   ├── server/           # API servers\n│   │   ├── trading.ts    # Trading bot\n│   │   ├── x402.ts       # Payment system\n│   │   ├── midnight.ts   # MIDNIGHT services\n│   │   ├── dashboard.ts  # Dashboard API\n│   │   └── projectTracker.ts # Time tracker\n│   ├── raydium/          # Raydium integration\n│   │   └── client.ts     # DEX client\n│   ├── utils/            # Utilities\n│   │   └── technicalIndicators.ts\n│   └── config/           # Configuration\n│       └── ports.ts\n├── public/               # Web interfaces\n│   ├── index.html        # Hub\n│   ├── dashboard.html    # Trading UI\n│   └── projects-dashboard.html # Time tracker UI\n├── tests/                # Test files\n├── package.json\n├── tsconfig.json\n└── README.md\n```\n\n### Adding Features\n\n1. Create backup: `./claude-proof.sh protect \"Before adding feature X\"`\n2. Implement feature\n3. Write tests\n4. Update documentation\n5. Commit changes\n\n### Code Style\n\n- Use TypeScript strict mode\n- Follow ESLint rules\n- Write meaningful comments\n- Add JSDoc for public APIs\n- Use async/await over promises\n\n---\n\n## 🤝 Contributing\n\n1. Fork the repository\n2. Create feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit changes (`git commit -m 'Add amazing feature'`)\n4. Push to branch (`git push origin feature/amazing-feature`)\n5. Open Pull Request\n\n---\n\n## 📄 License\n\nMIT License - feel free to use for personal or commercial projects\n\n---\n\n## 🙏 Acknowledgments\n\n- Raydium DEX for market data\n- Solana blockchain\n- Chart.js for visualizations\n- Express.js framework\n- TypeScript team\n\n---\n\n## 📞 Support\n\n- Issues: GitHub Issues\n- Documentation: This README\n- Updates: Check commit history\n\n---\n\n## 🗺️ Roadmap\n\n### v2.0 (Q1 2025)\n- [ ] WebSocket real-time streaming\n- [ ] More technical indicators (Bollinger Bands, Stochastic)\n- [ ] Email/SMS alerts\n- [ ] Mobile app\n\n### v2.5 (Q2 2025)\n- [ ] Backtesting engine\n- [ ] Strategy marketplace\n- [ ] Social trading features\n- [ ] Advanced analytics\n\n### v3.0 (Q3 2025)\n- [ ] Multi-exchange support\n- [ ] Copy trading\n- [ ] API for third-party integration\n- [ ] Cloud deployment templates\n\n---\n\n## 📊 Stats\n\n- **Total Services**: 7\n- **API Endpoints**: 25+\n- **Test Coverage**: 90%+\n- **Uptime**: 99.9%\n- **Lines of Code**: 5,000+\n\n---\n\n**Built with ❤️ by Akil Studio**\n\n🌊 Happy Trading! 🚀\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fallreality%2Fjupiter-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fallreality%2Fjupiter-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fallreality%2Fjupiter-bot/lists"}