Decryptu / Retardio

Retardio is a Discord bot designed to keep cryptocurrency enthusiasts within your server informed about significant market movements. Leveraging the CoinGecko API, it monitors the top 100 cryptocurrencies, notifying your channel with a detailed embed message whenever a coin's value moves up or down by 20%.

Retardio Bot

Retardio is an advanced Discord bot that provides real-time alerts on significant cryptocurrency market movements. Powered by the CoinGecko API, it tracks the top 100 cryptocurrencies, delivering beautifully crafted embed messages directly to your designated Discord channel. These alerts include vital information such as the coin's name, price, market cap, and percentage change, offering a comprehensive overview of major market shifts.

Features

• Real-time tracking of the top 100 cryptocurrencies on CoinGecko.
• Automatic alerts for any coin that moves up or down by 20%.
• Detailed embed messages containing the coin's data, including price and market cap.
• Easy to configure and deploy on any Discord server.

Installation

1. Clone the repository:

   git clone https://github.com/Decryptu/Retardio.git

2. Install dependencies:

   cd Retardio
   npm install

3. Configure your bot:

   Create a .env file in the root directory and add your Discord bot token like so:

   DISCORD_TOKEN=your_discord_bot_token_here
   

   Edit the config.json file to include the channel ID where alerts should be posted and other configurations. Here's an example with explanations for each configuration:

   {
     "channelId": "your_discord_channel_id_here", // Discord channel ID where notifications will be sent.
     "fetchInterval": 600000, // Interval between data fetches in milliseconds (600000ms = 10 minutes).
     "perPage": 200, // Number of coins to fetch per page from the CoinGecko API.
     "minChangePercentage": 20, // Minimum percentage change in coin price to trigger a notification.
     "cooldownPeriod": 43200000 // Cooldown period in milliseconds before a coin can be notified about again (43200000ms = 12 hours).
   }

4. Start the bot:

   npm run start

Demonstration

This screenshot demonstrates how alerts appear in your Discord channel, providing real-time updates on significant market movements.

Usage

Once deployed, Retardio will monitor cryptocurrency movements and automatically post alerts in the specified channel. There's no further action required; just watch for alerts and stay ahead of the market!

Contributing

Contributions are welcome! Please feel free to submit a pull request or open an issue on the GitHub repository.

License

This project is licensed under the ISC License. See the LICENSE file for details.

Support

If you encounter any problems or have suggestions, please open an issue on GitHub.