Skip to content

Latest commit

 

History

History
304 lines (208 loc) · 9.65 KB

README.md

File metadata and controls

304 lines (208 loc) · 9.65 KB

🚀 Solana & Etherum Meme Coin Trading Bot (alpha)

Python Version License

An advanced trading bot for Solana& Etherum-based meme coins, focusing on automated trading strategies, risk management, and high-performance execution.

⚠️ Important Legal Disclaimer

This software is provided strictly for EDUCATIONAL AND RESEARCH PURPOSES ONLY. Users must:

  • Comply with all applicable laws and regulations in their jurisdiction
  • Obtain necessary licenses and registrations before any actual trading
  • Understand that cryptocurrency trading involves substantial risk of loss
  • Accept full responsibility for any use of this software

Features

Core Components

  • ✅ Uniswap DEX Integration
  • ✅ Multi-RPC Fallback System
  • ✅ Wallet Management
  • ✅ Transaction Retry Logic
  • ✅ Price Impact Analysis
  • ✅ Liquidity Monitoring
  • ✅ Real-time Position Tracking
  • ✅ Performance Monitoring

Trading Strategies

  • ✅ Entry Strategy Implementation
  • ✅ Launch Sniping
  • ✅ Scalping Strategy
  • ✅ Position Management
  • ✅ Trend Trading

Risk Management

  • ✅ Price Impact Checks
  • ✅ Liquidity Analysis
  • ✅ Transaction Failure Handling
  • ✅ Network Congestion Management
  • ✅ Multiple RPC Fallbacks
  • ✅ Dynamic Risk Adjustment

Regulatory Compliance Notice

Before using this software, ensure compliance with:

  1. Securities regulations in your jurisdiction
  2. Cryptocurrency trading regulations
  3. Anti-money laundering (AML) requirements
  4. Know Your Customer (KYC) requirements
  5. Tax reporting obligations
  6. Data protection and privacy laws

Installation

git clone https://github.com/lucaskemper/meme-coin-public.git
cd meme-coin-trading
pip install -r requirements.txt

Detailed Installation Steps

# Clone repository
git clone https://github.com/lucaskemper/meme-coin-public.git
cd trading-bot

# Set up virtual environment
python3.12 -m venv venv # Python 3.12 specifically otherwise issues with dependencies
source venv/bin/activate  # Unix
.\venv\Scripts\activate  # Windows

# Install dependencies
pip install -r requirements.txt

# Set up environment variables
cp .env.example .env
# Edit .env with your configuration

Configuration

  1. Create a .env file in the root directory:
RPC_ENDPOINTS=["https://your-rpc-endpoint-1", "https://your-rpc-endpoint-2"]
WALLET_PRIVATE_KEY=your_private_key
TELEGRAM_BOT_TOKEN=your_telegram_bot_token
TELEGRAM_CHAT_ID=your_telegram_chat_id
  1. Configure trading parameters in src/config/settings.py

Usage

from src.core.dex import dex_manager
from src.strategies.entry_strategy import EntryStrategy

# Initialize strategy
strategy = EntryStrategy()

# Execute trades
await strategy.execute_entry(amount=1.0, tranche_index=0, max_slippage=0.02)

Starting the Bot

To start the bot, use the start_bot.py script:

python start_bot.py

Telegram Notifications

The bot includes a Telegram notification system to keep you updated on its status and trades. Configure your Telegram bot token and chat ID in the .env file:

TELEGRAM_BOT_TOKEN=your_telegram_bot_token
TELEGRAM_CHAT_ID=your_telegram_chat_id

The src/monitoring/telegram_handler.py file contains the implementation for Telegram notifications.

Strategies

Launch Sniping

The src/strategies/launch_sniper.py file contains the implementation for the launch sniping strategy. This strategy aims to enter trades at the launch of new tokens.

Scalping

The src/strategies/scalping.py file contains the implementation for the scalping strategy. This strategy aims to take advantage of small price movements to make quick profits.

Testing

The project includes comprehensive test coverage:

pytest # Run all tests
pytest -v # Verbose mode
pytest --cov=src # Coverage report

Project Structure

meme-coin-trading/
├── src/
│   ├── core/
│   │   ├── dex.py     # DEX integration
│   │   └── wallet.py  # Wallet management
│   ├── strategies/
│   │   ├── entry_strategy.py
│   │   ├── launch_sniper.py
│   │   └── scalping.py
│   │   └── trend_trader.py
│   └── utils/
│       └── logger.py
├── tests/
│   ├── test_dex.py
│   ├── test_strategies.py
│   └── test_trading.py
└── README.md

Core Components

TradingBot Class

The TradingBot class in main.py is the core component of the bot. It handles the main trading logic, including setup, execution, and monitoring of trades. The bot uses various strategies and risk management techniques to ensure optimal performance.

TelegramNotifier Class

The TelegramNotifier class in prod/scripts/handlers/telegram_handler.py is responsible for sending notifications to a Telegram channel. It provides real-time updates on the bot's status, trades, and other important events.

RiskManager Class

The RiskManager class in prod/scripts/risk_manager.py is responsible for managing the risk associated with trades. It ensures that the bot adheres to predefined risk parameters and prevents excessive losses.

PriceTracker Class

The PriceTracker class in prod/scripts/price_tracker.py is responsible for tracking the prices of various tokens. It provides real-time price data to the bot, enabling it to make informed trading decisions.

NotificationSystem Class

The NotificationSystem class in prod/scripts/notifications.py is responsible for managing notifications. It ensures that the bot sends timely and relevant notifications to the user, keeping them informed about the bot's activities.

Development Status

Completed

  • ✅ DEX Integration (Uniswap)
  • ✅ Wallet Integration
  • ✅ Basic Trading Strategies
  • ✅ Test Framework
  • ✅ Error Handling
  • ✅ Logging System

In Progress

  • 🔄 Advanced Strategy Implementation
  • 🔄 Performance Optimization
  • 🔄 Additional DEX Support
  • 🔄 UI/Dashboard Development

Contributing

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add some amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

Risk Disclosure

Trading cryptocurrency involves substantial risk of loss and is not suitable for all investors. Users should:

  • Never trade with funds they cannot afford to lose
  • Understand all risks involved in cryptocurrency trading
  • Be aware of the high volatility in cryptocurrency markets
  • Understand that past performance is not indicative of future results
  • Be aware of potential technical failures and network issues
  • Understand that this software provides no guarantees of profit

Legal Disclaimer

PROPRIETARY SOFTWARE Copyright © 2025 Lucas Kemper and Adrien Clement. All Rights Reserved.

This advanced trading bot for Ethereum-based meme coins is proprietary software focusing on automated trading strategies, risk management, and high-performance execution.

⚠️ Important: Proprietary Software Notice

This software and its documentation are proprietary and confidential property of Lucas Kemper and Adrien Clement. Any unauthorized use, reproduction, or distribution is strictly prohibited and may result in severe civil and criminal penalties.

License and Legal Notice

Proprietary Software License Agreement

This software is protected by copyright laws and international treaties. Access to and use of this software is subject to the following terms:

Ownership

  • All rights, title, and interest in the software remain with Lucas Kemper and Adrien Clement
  • All intellectual property rights are reserved
  • No transfer of ownership is granted or implied

Usage Restrictions

You may not:

  • Copy, distribute, or modify any part of this software
  • Reverse engineer, decompile, or disassemble the software
  • Remove any copyright or other proprietary notices
  • Transfer the software to any third party
  • Use the software to create derivative works

Termination

  • License is effective until terminated
  • Rights automatically terminate if any terms are violated
  • All software and documentation must be destroyed upon termination

Legal Compliance

Users must:

  • Comply with all applicable laws and regulations
  • Maintain confidentiality of the software
  • Report any unauthorized use or disclosure
  • Obtain necessary licenses and registrations for trading activities

No Warranty

THE SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. LUCAS KEMPER AND ADRIEN CLEMENT EXPRESSLY DISCLAIM ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.

Limitation of Liability

IN NO EVENT SHALL LUCAS KEMPER AND ADRIEN CLEMENT BE LIABLE FOR ANY DAMAGES (INCLUDING, WITHOUT LIMITATION, LOST PROFITS, BUSINESS INTERRUPTION, OR LOST INFORMATION) ARISING OUT OF THE USE OF OR INABILITY TO USE THE SOFTWARE.

Governing Law

This License shall be governed by and construed in accordance with the laws of France, without giving effect to any principles of conflicts of law.

Users must:

  • Conduct their own due diligence
  • Comply with all applicable laws and regulations
  • Obtain necessary licenses and registrations
  • Maintain appropriate records
  • Report all required tax obligations
  • Implement appropriate security measures
  • Not use this software for any illegal activities

By using this software, you acknowledge that you have read, understood, and agreed to all terms and conditions outlined in this README and accompanying documentation.