Skip to content

jp-moregain/eth-grid-bot-v231

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

1 Commit
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

ETH-Based Compounding Grid Bot v2.3.1

A profitable cryptocurrency trading bot with ETH-based sizing and pure profit compounding

Python 3.8+ License: MIT Status: Production


🎯 Live Performance Results

Validated with REAL money on Binance:

Runtime: 52 hours (2.2 days)
Starting Capital: $991
Total Trades: 9
Win Rate: 100%
Realized Profit: $13.95
ROI: 1.41% in 52 hours

Extrapolated Returns:
- Daily: 0.65%
- Monthly: 19.5%
- Yearly: 237%

With compounding acceleration: 300-400%+ APY πŸš€


πŸ’‘ What Makes This Special

Unlike traditional grid bots that size trades based on total portfolio value, this bot:

  • Sizes trades in ETH (not USDT portfolio percentage)
  • Compounds 80% of profits into next trades
  • Keeps 20% as buffer (safety + realized gains)
  • Grows exponentially through profit reinvestment

Result: Clean, predictable compounding that's not affected by price fluctuations.


πŸš€ Key Features

βœ… Pure Profit Compounding

  • Base trade size: 10% of USDT balance
  • 80% of each profit β†’ reinvested in next buy
  • 20% of each profit β†’ USDT buffer
  • Buy budget grows exponentially with profits
  • Sell size = last buy amount (perfect pairing)

βœ… Asymmetric Grid Strategy

  • Buy trigger: -1.0% (catch dips)
  • Sell trigger: +1.5% (maximize profits)
  • 50% more profit per sell vs symmetric grids

βœ… Auto Balance Detection

  • No investment input needed
  • Bot detects current ETH + USDT balances
  • Calculates base size automatically
  • Validates 50/50 balance (warns if imbalanced)

βœ… Telegram Notifications (Optional)

  • Trade alerts (buy/sell with profit)
  • Bot halt alerts (insufficient funds)
  • Error notifications
  • Daily summaries at 8:00 AM
  • Startup confirmation

βœ… Security First

  • Zero hardcoded credentials
  • No config files with secrets
  • All input via password prompts (hidden)
  • Everything stored in memory only
  • Secure by design

πŸ“Š How It Works

Live Trading Example:

Starting Balance: 0.26 ETH + $492 USDT @ $1,915/ETH

Trade 1: SELL 0.0261 ETH @ $1,944 (+1.5%)
  β†’ Revenue: $50.74
  β†’ Profit: $0.75
  β†’ 80% reinvested: $0.60
  β†’ Buy budget: $49.22 + $0.60 = $49.82

Trade 2-5: Price keeps rising, 4 more sells
  β†’ Profits accumulate: $12.01 total
  β†’ 80% reinvested: $9.61
  β†’ Buy budget: $49.22 + $9.61 = $58.83

Trade 6: BUY with $58.83 @ $2,050 (-1%)
  β†’ Get: 0.0287 ETH (more than initial 0.0261!)
  β†’ Reset buy budget to $49.22

Trade 7: SELL 0.0287 ETH @ $2,087 (+1.5%)
  β†’ Profit: $1.04
  β†’ Next buy: $49.22 + $0.83 = $50.05

Compounding works perfectly! βœ…

πŸ› οΈ Installation

Prerequisites

  • Python 3.8+
  • Binance account with API access
  • Funded account (recommend 50% ETH + 50% USDT)

Quick Start

  1. Clone the repository
git clone https://github.com/YOUR_USERNAME/eth-grid-bot-v231.git
cd eth-grid-bot-v231
  1. Install dependencies
pip install -r requirements.txt
  1. Fund your Binance account
BEFORE running the bot:
- Deposit ETH and USDT to your Binance account
- Aim for ~50% of each (in value)
- Example: 0.5 ETH + $1,000 USDT @ $2,000/ETH
  1. Run the bot
python3 eth_based_grid_bot_v231.py
  1. Follow the setup wizard
  • Select paper/live trading mode
  • Choose trading pair (ETH/USDT, BTC/USDT, SOL/USDT)
  • Enter API keys (live mode only, hidden input)
  • Optional: Set up Telegram notifications

πŸ“± Telegram Setup (Optional)

Get notifications for all bot activity:

Step 1: Create Bot

  1. Open Telegram, search for @BotFather
  2. Send: /newbot
  3. Follow instructions
  4. Save the token!

Step 2: Get Chat ID

  1. Search for @userinfobot
  2. Start chat
  3. It will show your Chat ID
  4. Save this number!

Step 3: Enable in Bot

When running the bot:

  • Choose "Enable Telegram notifications"
  • Enter bot token (hidden input)
  • Enter chat ID
  • Done!

You'll Get:

  • πŸ“€ Sell alerts with profit
  • πŸ“₯ Buy alerts with amount
  • πŸ›‘ Halt alerts (insufficient funds)
  • ❌ Error alerts
  • πŸ“Š Daily summaries at 8:00 AM

βš™οΈ Configuration

Trading Parameters

Buy Trigger:        -1.0% from reference price
Sell Trigger:       +1.5% from reference price
Base Trade Size:    10% of USDT balance
Profit Split:       80% reinvest / 20% buffer
Fee Rate:           0.1% (Binance standard)

Supported Pairs

  • ETH/USDT βœ… (recommended, most tested)
  • BTC/USDT βœ…
  • SOL/USDT βœ…

πŸ“ˆ Performance Data

Live Trading Results (52 hours):

Metric Value
Starting Capital $991.16
Total Trades 9
Profitable Trades 7/7 sells (100%)
Total Profit $13.95
ROI 1.41% (52h)
Daily Return 0.65%
Monthly (projected) 19.5%
Yearly (projected) 237%

Trade Size Growth:

Initial: $49.22 (base)
After compounding: $59.70
Growth: +21.3% in 2 days!

Profit Per Trade:

Average profit per sell: $1.99
Trade frequency: ~5.8 hours
Win rate: 100%

🎯 Why v2.3.1?

Fixed from v2.3.0:

v2.3.0 Issues:

  • ❌ Base = 10% of total portfolio (too high)
  • ❌ Ran out of USDT after 9 trades
  • ❌ First sells showed $0 profit
  • ❌ Buy budget never reset
  • ❌ Not sustainable

v2.3.1 Fixes:

  • βœ… Base = 10% of USDT only (correct!)
  • βœ… Can handle 10+ consecutive buys
  • βœ… All sells show correct profit
  • βœ… Buy budget resets after each use
  • βœ… Sustainable long-term

πŸ” Security

Best Practices:

  1. API Keys

    • Create API with SPOT trading only
    • Enable IP whitelist
    • NO withdrawal permissions
    • Store keys securely
  2. Bot Security

    • Never commit API keys to git
    • Use password input (hidden)
    • No config files with secrets
    • Memory-only storage
  3. Risk Management

    • Start small ($500-1,000)
    • Test in paper mode first
    • Monitor regularly
    • Use Telegram alerts

⚠️ Risks & Disclaimers

Trading involves risk:

  • You can lose money
  • Past performance β‰  future results
  • Crypto markets are highly volatile
  • Start small, scale gradually

Not financial advice:

  • Educational software only
  • Do your own research
  • Trade at your own risk
  • Only invest what you can afford to lose

Technical risks:

  • API failures possible
  • Network issues can occur
  • Exchange downtime happens
  • Monitor your bot regularly

πŸ“‹ Optimal Market Conditions

Best: Ranging/sideways markets

  • Lots of trades
  • Frequent compounding
  • Consistent profits

Good: Moderate volatility (Β±2-5% daily)

  • Regular triggers hit
  • Steady compounding
  • Good profits

Okay: Trending markets

  • Fewer triggers
  • Accumulates position
  • Eventual profit on reversal

πŸ”§ Troubleshooting

Bot halts with "Insufficient USDT":

  • Normal behavior during prolonged downtrends
  • Bot preserves capital by not overtrading
  • Wait for price to rise and trigger sells
  • Or add more USDT to account

No trades happening:

  • Check if price is within trigger range
  • Verify triggers in logs
  • Ensure sufficient balance on both sides

Telegram not working:

  • Verify bot token is correct
  • Check chat ID is accurate
  • Ensure bot is started (message it first)

πŸ“ Project Structure

eth-grid-bot-v231/
β”œβ”€β”€ eth_based_grid_bot_v231.py  # Main bot
β”œβ”€β”€ requirements.txt             # Dependencies
β”œβ”€β”€ .gitignore                  # Security
β”œβ”€β”€ README.md                   # This file
β”œβ”€β”€ LICENSE                     # MIT License
└── logs/                       # Generated at runtime
    └── ETHUSDT_live_*.log      # Trade logs

πŸ“œ License

MIT License - see LICENSE file for details

Free to use, modify, and distribute!


πŸ™ Acknowledgments


πŸ“Š Live Stats

Track your bot's performance:

  • Check logs/ directory for detailed trade history
  • Monitor Telegram for real-time updates
  • Review daily summaries each morning

πŸš€ What's Next?

Scaling:

  • Start with $500-1,000
  • Test for 1-2 weeks
  • Scale to $5,000-10,000
  • Let compounding accelerate

Future Enhancements:

  • Multi-pair support (coming in APEX v3.0)
  • Advanced regime detection
  • Multiple strategies
  • Web dashboard

⭐ Support This Project

If this bot makes you money:

  • ⭐ Star this repo
  • 🍴 Fork and improve
  • πŸ› Report bugs
  • πŸ’‘ Suggest features

πŸ“ž Support

  • Issues: Open a GitHub issue
  • Questions: Check logs in logs/ directory
  • Updates: Watch this repo for new releases

Happy Trading! πŸš€πŸ’°

Built with ❀️ for profitable automated trading

Codename: PureProfit-v2.3.1


πŸ“ˆ Example Live Session

Starting bot...
βœ“ Balance detected: 0.26 ETH + $492 USDT
βœ“ Portfolio value: $991
βœ“ Base trade size: $49.22 (10% of USDT)
βœ“ Entry price: $1,915
βœ“ Bot is now running!

[6 hours later]
βœ“ SELL 0.0261 ETH @ $1,944 | Profit: $0.75

[15 hours later]
βœ“ SELL 0.0261 ETH @ $1,975 | Profit: $1.52

[Total: 52 hours, 9 trades, $13.95 profit]
Win rate: 100% βœ…

Start making money with proven, tested, profitable grid trading! πŸ’ͺ

About

ETH-Based Compounding Grid Bot - Production Tested

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors