Bagsapp Copytrading Bot

A Solana copytrading bot that monitors target wallets on Bagsapp and automatically copies their buy/sell transactions. The bot includes optional automatic sell logic with stop loss and take profit features.

Features

• 🔍 Wallet Monitoring: Monitors multiple target wallets for transactions on Bagsapp
• 📋 Transaction Copying: Automatically copies buy and sell transactions from target wallets
• 🎯 Smart Sell Logic: Optional automatic sell with stop loss and take profit
• ⚙️ Configurable: Easy configuration via environment variables
• 📊 Logging: Comprehensive logging for monitoring and debugging

Prerequisites

• Node.js 18+ installed
• TypeScript 5.3+ (installed via npm)
• A Solana wallet with SOL for trading
• Access to a Solana RPC endpoint (recommended: Helius, QuickNode, or Alchemy)

Installation

1. Clone the repository:

git clone <repository-url>
cd Bagsapp-Copytrading-Bot

2. Install dependencies:

npm install

3. Build the TypeScript project:

npm run build

4. Copy the example environment file:

cp .env.example .env

5. Configure your .env file with your settings:
   • Add your wallet's private key (base58 encoded)
   • Add target wallet addresses to monitor
   • Configure sell logic settings
   • Set your Solana RPC URL

Configuration

Environment Variables

Variable	Description	Required
SOLANA_RPC_URL	Solana RPC endpoint URL	Yes
PRIVATE_KEY	Your wallet's private key (base58)	Yes
TARGET_WALLETS	Comma-separated list of wallet addresses to monitor	Yes
BAGSAPP_PROGRAM_ID	Bagsapp program ID on Solana	Yes
ENABLE_OWN_SELL_LOGIC	Enable/disable automatic sell logic (true/false)	No (default: false)
STOP_LOSS_PERCENT	Stop loss percentage (only if own sell logic enabled)	No (default: 5)
TAKE_PROFIT_PERCENT	Take profit percentage (only if own sell logic enabled)	No (default: 10)
SLIPPAGE_BPS	Slippage tolerance in basis points (100 = 1%)	No (default: 100)
MIN_SOL_AMOUNT	Minimum SOL amount per trade	No (default: 0.01)
MAX_SOL_AMOUNT	Maximum SOL amount per trade	No (default: 10)
LOG_LEVEL	Logging level (error, warn, info, debug)	No (default: info)

Sell Logic Modes

Mode 1: Copy Target Wallet Sells (Default)

Set ENABLE_OWN_SELL_LOGIC=false

• Bot copies all buy transactions from target wallets
• Bot copies all sell transactions from target wallets
• No automatic stop loss or take profit

Mode 2: Own Sell Logic Enabled

Set ENABLE_OWN_SELL_LOGIC=true

• Bot copies buy transactions from target wallets
• Bot ignores target wallet sells
• Automatically sells based on stop loss and take profit thresholds
• Continuously monitors positions and executes sells when thresholds are met

Usage

Build the project (required before first run):

npm run build

Start the bot:

npm start

For development with auto-reload (TypeScript):

npm run dev

Type check without building:

npm run type-check

How It Works

1. Wallet Monitoring: The bot continuously monitors specified target wallets for new transactions
2. Transaction Detection: When a transaction involving Bagsapp is detected, it's parsed to determine if it's a buy or sell
3. Buy Execution: When a target wallet buys a token, the bot executes a similar buy transaction
4. Sell Execution:
   • If own sell logic is disabled: Bot copies the target wallet's sell
   • If own sell logic is enabled: Bot monitors positions and sells based on stop loss/take profit

Important Notes

⚠️ Security

• NEVER share your private key or commit it to version control
• Keep your .env file secure and never share it
• Use a dedicated trading wallet, not your main wallet

⚠️ Risk Warning

• Trading bots involve financial risk
• Always test with small amounts first
• Monitor the bot regularly
• The bot is provided as-is without warranty

🔧 Implementation Notes

The current implementation includes placeholder methods for:

• Jupiter API integration for swaps
• Price fetching for stop loss/take profit

You'll need to complete these integrations based on:

• Bagsapp's actual swap mechanism
• Available price oracles or DEX APIs
• Your preferred DEX aggregator (Jupiter, Orca, etc.)

Project Structure

.
├── src/
│   ├── index.ts              # Entry point
│   ├── bot.ts                # Main bot logic
│   ├── wallet-monitor.ts     # Wallet transaction monitoring
│   ├── transaction-executor.ts # Transaction execution
│   ├── sell-logic.ts         # Stop loss/take profit logic
│   ├── types/
│   │   └── index.ts          # TypeScript type definitions
│   └── utils/
│       └── logger.ts         # Logging utility
├── dist/                     # Compiled JavaScript (generated)
├── logs/                     # Log files (auto-created)
├── .env.example             # Example environment configuration
├── .gitignore               # Git ignore rules
├── tsconfig.json            # TypeScript configuration
├── package.json             # Dependencies and scripts
└── README.md                # This file

Logging

Logs are written to:

• logs/combined.log - All logs
• logs/error.log - Error logs only
• Console output - Real-time monitoring

Troubleshooting

Bot not detecting transactions

• Verify target wallet addresses are correct
• Check RPC endpoint is working
• Ensure Bagsapp program ID is correct

Transactions failing

• Check wallet has sufficient SOL balance
• Verify slippage settings are appropriate
• Check RPC endpoint rate limits

Price monitoring not working

• Complete the price fetching implementation in sell-logic.ts
• Integrate with a price oracle or DEX API

TypeScript compilation errors

• Run npm run type-check to see detailed type errors
• Ensure all dependencies are installed: npm install
• Check that tsconfig.json is properly configured

Contact Information

• Telegram: https://t.me/DevCutup
• Twitter: https://x.com/devcutup