{"id":29704301,"url":"https://github.com/mindscope-world/acutip-openchat-project","last_synced_at":"2025-07-23T14:10:04.965Z","repository":{"id":290624009,"uuid":"965976147","full_name":"mindscope-world/AcuTip-OpenChat-Project","owner":"mindscope-world","description":null,"archived":false,"fork":false,"pushed_at":"2025-04-29T18:46:09.000Z","size":5,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-29T19:45:46.238Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mindscope-world.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-04-14T07:57:00.000Z","updated_at":"2025-04-29T18:46:15.000Z","dependencies_parsed_at":"2025-04-29T19:45:48.311Z","dependency_job_id":"9dac91ac-41de-42ed-9ea9-16ac4b6ad4c8","html_url":"https://github.com/mindscope-world/AcuTip-OpenChat-Project","commit_stats":null,"previous_names":["mindscope-world/acutip-openchat-project"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/mindscope-world/AcuTip-OpenChat-Project","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mindscope-world%2FAcuTip-OpenChat-Project","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mindscope-world%2FAcuTip-OpenChat-Project/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mindscope-world%2FAcuTip-OpenChat-Project/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mindscope-world%2FAcuTip-OpenChat-Project/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mindscope-world","download_url":"https://codeload.github.com/mindscope-world/AcuTip-OpenChat-Project/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mindscope-world%2FAcuTip-OpenChat-Project/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266691580,"owners_count":23969182,"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-07-23T02:00:09.312Z","response_time":66,"last_error":null,"robots_txt_status":null,"robots_txt_updated_at":null,"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":[],"created_at":"2025-07-23T14:10:03.952Z","updated_at":"2025-07-23T14:10:04.860Z","avatar_url":"https://github.com/mindscope-world.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# AcuTip - OpenChat Crypto Bot\n\nAcuTip is a powerful OpenChat bot designed to help users monitor cryptocurrency prices, set price alerts, and track DEX (Decentralized Exchange) activities. Built with Rust using the OpenChat Bot SDK, it provides real-time cryptocurrency information and alerts.\n\n![AcuTip Bot Screenshot](./static/acutip.png)\n\n## Features\n\n### 1. Price Monitoring (`/price`)\n- Real-time cryptocurrency price checking\n- Supported cryptocurrencies:\n  - Bitcoin (BTC)\n  - Ethereum (ETH)\n  - Internet Computer (ICP)\n- Clean and intuitive interface with dropdown selection\n![AcuTip Bot Price Screenshot](./static/acutip4.png)\n\n### 2. Price Alerts (`/alert`)\n- Set custom price alerts for cryptocurrencies\n- Multiple alert types:\n  - Price above threshold\n  - Price below threshold\n- Alert management commands:\n  - `/alert set` - Create new price alerts\n  - `/alert list` - View all active alerts\n  - `/alert remove` - Remove existing alerts\n- Real-time notifications when price conditions are met\n![AcuTip Bot Alert Screenshot](./static/acutip2.png)\n\n### 3. DEX Monitoring (`/dex`)\n- Track decentralized exchange activities\n- Two monitoring modes:\n  - `whale` - Monitor large transactions\n  - `liquidity` - Track liquidity pools\n- Features:\n  - Whale movement tracking\n  - Liquidity pool monitoring\n  - Transaction volume tracking\n  - Real-time updates\n![AcuTip Bot DEX Screenshot](./static/acutip3.png)\n\n## Installation\n\n1. Clone the repository:\n```bash\ngit clone https://github.com/yourusername/acutip.git\ncd acutip\n```\n\n2. Install the required dependencies:\n```bash\ncargo build\n```\n\n3. Create a new identity for your bot:\n```bash\ndfx identity new acubot_identity --storage-mode=plaintext\n```\n\n4. Export the identity to PEM file:\n```bash\ndfx identity export acubot_identity \u003e identity.pem\n```\n\n5. Create a config.toml file:\n```toml\npem_file = \"./identity.pem\"\nic_url = \"https://icp0.io\"\nport = 13457\noc_public_key = \"YOUR_OC_PUBLIC_KEY\"\nlog_level = \"INFO\"\n```\n\n## Bot Registration\n\n1. Visit [OpenChat](https://oc.app)\n\n2. Create a new group or use an existing one\n\n3. Register your bot:\n   - Type `/bots` in the chat\n   - Click \"Register a Bot\"\n   - Fill in the bot details:\n     - Name: AcuTip\n     - Description: Crypto price monitoring and DEX tracking bot\n     - Avatar: Upload a bot avatar (optional)\n   - For the bot URL, use your local server address:\n     ```\n     http://localhost:13457\n     ```\n   - Click \"Register\"\n\n4. Add the bot to your group:\n   - Type `/add @AcuTip` in the group chat\n   - The bot will join the group and be ready to use\n\n## Detailed Usage Guide\n![AcuTip Bot Screenshot](./static/acutip5.jpg)\n\n\n### Price Checking\n1. Type `/price` in the chat\n2. Select a cryptocurrency from the dropdown (BTC, ETH, or ICP)\n3. Click \"Submit\"\n4. The bot will respond with the current price:\n   ```\n   💰 Current BTC price: $93867.00\n   ```\n\n### Setting Price Alerts\n1. Type `/alert set` in the chat\n2. Fill in the alert details:\n   - Select cryptocurrency (BTC, ETH, or ICP)\n   - Enter target price (e.g., 80000)\n   - Choose condition (above/below)\n3. Click \"Submit\"\n4. The bot will confirm:\n   ```\n   🔔 Price alert set for BTC when price falls below $80000.00\n   ```\n\n### Managing Alerts\n1. List your alerts:\n   ```\n   /alert list\n   ```\n   Response shows all active alerts:\n   ```\n   📋 Your Price Alerts:\n   • BTC below $80000.00 (set 2024-04-30 17:59)\n   ```\n\n2. Remove an alert:\n   ```\n   /alert remove BTC\n   ```\n   Bot confirms:\n   ```\n   ✅ Removed price alert for BTC\n   ```\n\n### DEX Monitoring\n1. Monitor whale movements:\n   ```\n   /dex whale\n   ```\n   Shows large transactions:\n   ```\n   🐋 Whale Alert!\n   • 1000 ICP moved on Sonic DEX\n   • 500 ETH swapped on Uniswap\n   • 10 BTC transferred to exchange\n   ```\n\n2. Check liquidity:\n   ```\n   /dex liquidity\n   ```\n   Shows current liquidity:\n   ```\n   💧 Liquidity Update\n   • Sonic DEX: 1M ICP\n   • Uniswap: 500K ETH\n   • PancakeSwap: 100K BNB\n   ```\n\n### Best Practices\n- Set reasonable price alert thresholds\n- Use the list command to manage multiple alerts\n- Monitor DEX activities for market insights\n- Remove unused alerts to keep your list clean\n\n## Usage\n\n1. Start the bot:\n```bash\ncargo run\n```\n\n2. Available Commands:\n   - Check cryptocurrency prices:\n     ```\n     /price BTC\n     ```\n   - Set a price alert:\n     ```\n     /alert set BTC 80000 below\n     ```\n   - Monitor DEX activities:\n     ```\n     /dex whale\n     /dex liquidity\n     ```\n\n## Configuration\n\nThe bot can be configured through the `config.toml` file:\n- `pem_file`: Path to your identity PEM file\n- `ic_url`: Internet Computer URL\n- `port`: Port number for the bot server\n- `oc_public_key`: OpenChat public key\n- `log_level`: Logging level (INFO, DEBUG, etc.)\n\n## Development\n\n### Prerequisites\n- Rust\n- DFX (for identity management)\n- Internet Computer SDK\n\n### Project Structure\n```\nacutip/\n├── src/\n│   ├── commands/\n│   │   ├── alert.rs\n│   │   ├── dex.rs\n│   │   ├── price.rs\n│   │   └── mod.rs\n│   ├── config.rs\n│   └── main.rs\n├── Cargo.toml\n├── config.toml\n└── README.md\n```\n\n## Contributing\n\n1. Fork the repository\n2. Create your feature branch (`git checkout -b feature/AmazingFeature`)\n3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)\n4. Push to the branch (`git push origin feature/AmazingFeature`)\n5. Open a Pull Request\n\n## Future Developments\n\n### Planned Features\n1. Enhanced Price Alerts\n   - Percentage-based alerts\n   - Multiple condition alerts\n   - Alert expiration settings\n   - Custom notification sounds\n\n2. Advanced DEX Integration\n   - More DEX platforms support\n   - Custom whale threshold settings\n   - Historical transaction analysis\n   - Trading pair analytics\n\n3. Portfolio Management\n   - Portfolio tracking\n   - PnL calculations\n   - Investment performance metrics\n   - Portfolio rebalancing suggestions\n\n4. Technical Analysis\n   - Price trend indicators\n   - Moving averages\n   - RSI and MACD indicators\n   - Trading volume analysis\n\n5. User Experience\n   - Customizable UI themes\n   - Multi-language support\n   - Personalized alert preferences\n   - Dashboard view for all metrics\n\n6. Security Enhancements\n   - End-to-end encryption for alerts\n   - Two-factor authentication\n   - API key management\n   - Rate limiting controls\n\n### Roadmap\n- Q2 2025: Enhanced Price Alerts \u0026 Portfolio Management\n- Q3 2025: Advanced DEX Integration \u0026 Technical Analysis\n- Q4 2025: Security Enhancements \u0026 Multi-language Support\n\n## Contributors\n\n### Core Team\n- [Paul Ndirangu](https://github.com/mindscope) - Project Lead \u0026 Core Developer\n  - Bot Architecture\n  - Price Alert System\n  - DEX Integration\n- [Veranzi](https://github.com/Veranzi) - Project Manager \u0026 Core Planner\n  - Bot Architecture\n  - Price Alert System\n  - DEX Integration\n\n### Special Thanks\n- OpenChat Labs Team for the SDK\n- Internet Computer Community\n- Early testers and users\n\n### How to Contribute\nWe welcome contributions of all kinds! Here are some ways you can help:\n- Report bugs and suggest features\n- Improve documentation\n- Add new cryptocurrency support\n- Enhance DEX monitoring capabilities\n- Write tests and improve code quality\n\nFor detailed contribution guidelines, please see [CONTRIBUTING.md](CONTRIBUTING.md)\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## Acknowledgments\n\n- Built with [OpenChat Bot SDK](https://github.com/open-chat-labs/open-chat-bots)\n- Uses CoinGecko API for cryptocurrency price data\n- Special thanks to the Internet Computer community\n\n## Support\n\nFor support, please open an issue in the GitHub repository or contact the maintainers. \n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmindscope-world%2Facutip-openchat-project","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmindscope-world%2Facutip-openchat-project","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmindscope-world%2Facutip-openchat-project/lists"}