Currency Conversion Cog

The Currency Conversion cog provides real-time currency exchange rates using the CurrencyBeacon API, allowing users to convert between different currencies.

Features

Currency Support

  • 40+ Currencies: Major world currencies supported
  • Cryptocurrency: BTC, ETH, and popular altcoins
  • Real-time Rates: Live exchange rate data
  • Historical Rates: Past conversion rates

Conversion Commands

  • Direct Conversion: Convert specific amounts
  • Multi-currency: Convert to multiple currencies
  • Bulk Operations: Convert multiple amounts
  • Rate Display: Show current exchange rates

Safety Features

  • Value Limits: Configurable min/max conversion amounts
  • Role Blacklisting: Prevent certain roles from using
  • Log Channel: Track all conversion activity
  • Rate Limiting: Prevent abuse

Commands

Command Description Permissions
/convert <amount> <from> <to> Convert currency None
/rates <base> Show exchange rates None

Configuration

  • Enabled: Toggle currency conversion
  • Min/Max Values: Conversion amount limits
  • Blacklisted Roles: Roles that cannot convert
  • Log Channel: Where conversions are logged

API Integration

  • CurrencyBeacon API: Professional exchange rate service
  • Rate Caching: Reduce API calls and improve performance
  • Error Handling: Graceful API failure recovery
  • Rate Limits: Respect API usage limits

Best Practices

  1. Reasonable Limits: Set appropriate conversion limits
  2. Monitor Usage: Track for potential abuse
  3. Currency Selection: Support commonly used currencies
  4. User Education: Explain rate fluctuations