𝓑𝓮𝓱𝓲𝓷𝓭 𝓽𝓱𝓲𝓼 𝓫𝓸𝓽, 𝓽𝓱𝓮𝓻𝓮 𝓲𝓼 𝓶𝓸𝓻𝓮 𝓽𝓱𝓪𝓷 𝓳𝓾𝓼𝓽 𝓬𝓸𝓭𝓮. 𝓑𝓮𝓷𝓮𝓪𝓽𝓱 𝓽𝓱𝓲𝓼 𝓫𝓸𝓽, 𝓽𝓱𝓮𝓻𝓮 𝓲𝓼 𝓫𝓵𝓸𝓸𝓭, 𝓼𝔀𝓮𝓪𝓽, 𝓽𝓮𝓪𝓻𝓼, 𝓪𝓷𝓭 𝓪𝓷 𝓲𝓭𝓮𝓪… 𝓐𝓷𝓭 𝓲𝓭𝓮𝓪𝓼 𝓪𝓻𝓮 𝓾𝓷𝓼𝓽𝓸𝓹𝓹𝓪𝓫𝓵𝓮.
under development... to be updated...
RevengeTrade is designed to interact with the Binance API, fetching real-time market data, generating trading signals through advanced technical analysis, and executing trades with precision.The bot employs sophisticated entry and exit strategies utilizing key indicators like RSI, MACD, EMA, ATR, and more, while integrating risk management to maximize profitability and try to eliminate unnecessary losses. 🛡️🔥
- Overview
- Features
- Architecture
- Installation
- Configuration
- Usage
- Logging and Database
- Error Handling and Risk Management
- License
- Fetches historical and real-time data
- Calculates technical indicators
- Predicts price movements
- Uses trend analysis & technical conditions
- Implements dynamic risk management
- Generates BUY or SELL signals
- Adjusts trade size based on account balance
- Sets stop-loss and take-profit levels
- Ensures controlled exposure to the market
- Places market and limit orders
- Manages pending trades and order cancellations
- Records every trade in CSV and a database
- Provides insights for optimization and auditing
Disclaimer: This bot does not guarantee profits. Always trade responsibly and understand the risks involved in cryptocurrency trading.
- Real-time Market Data: Retrieves and processes candlestick data from Binance with error handling and time synchronization.
- Technical Analysis: Uses multiple technical indicators such as RSI, MACD, EMA, ATR, and SuperTrend to assess market conditions.
- Automated Trade Execution: Executes trades based on signals generated by the underlying strategy, including limit and market orders.
- Risk Management: Implements dynamic target calculation, trailing stops, and position sizing based on defined risk per trade.
- Logging and Audit Trail: Logs trade details and signals to both CSV files and a relational database for further analysis.
- EMA Rejection Strategy: Detects rejection at critical EMA levels to trigger sell signals.
- Portfolio Distribution: Monitors portfolio balance (USDT vs. trading coin) to adjust trading status accordingly.
The bot structure is divided into several key modules:
- bot.py: The main entry point that orchestrates data fetching, signal generation, order execution, and active trade management.
- TrendStrategy: Handles market analysis and technical indicator calculations, along with generating buy/sell signals.
- DynamicRiskManager: Computes dynamic targets and trailing stops based on volatility and ATR.
- CSVTradeLogger & TradePositionManager: Responsible for logging trade transactions and managing open positions in the database.
- LimitSellOrderExecutor and limitBuyOrderExecutor: Facilitate placing and managing limit orders on Binance.
- PositionCostCalculator: Computes current trade profitability, position size, and other cost-related metrics.
- EMARejectStrategy: Implements the logic to track EMA rejections to help determine exit decisions.
About helpers Folder
- binance_api_validator.py - Validates Binance API credentials and checks for required permissions.
- min_trade.py - Retrieves the minimum trade size for a specific trading pair.
- min_trade_coins.py - Lists the minimum trade values for various USDT trading pairs.
- precision.py - Fetches precision and filter details for a given trading pair.
- sqllite.py - Connects to an SQLite database to view stored trade positions.
- tick_size.py - Retrieves the tick size (minimum price movement) for a specific trading pair.
To improve buy conditions threshold check this Optimizasiton Threshold repo.
The project uses internal organization modules, configuration constants (via a Config class), and exception handling to ensure resilience during trading.
-
Clone the repository:
[email protected]:klncgty/Cryptocurrency-Trading-Bot.git -
Install dependencies:
The project depends on several Python packages including
pandas,numpy,talib, and thebinancepython client, among others. Install them via pip:pip install -r requirements.txt -
Environment Setup:
Create a
.envfile in the project root with your API credentials and other sensitive configurations:API_KEY=your_binance_api_key_here API_SECRET=your_binance_api_secret_here -
Database Setup:
The bot uses an SQLite database (or other supported SQL databases). Ensure proper permissions for creating and modifying the database file.
All configuration settings (such as risk parameters, timeframes, symbol names, and thresholds) are managed in the Config class. Key parameters include:
- SYMBOL: The trading pair symbol (e.g.,
SHIB). - TIMEFRAME: The candlestick interval (e.g.,
5m). - RISK_PER_TRADE: The percentage of the account balance risked per trade.
- MIN_RISK_REWARD: The minimum risk/reward ratio for a trade to be considered.
- PROFIT_TARGET: The profit percentage target for triggering limit sell orders.
- PREDICT_BASED_ORDERS: Boolean toggle for using predicted price orders.
- LENGTH_BAR: The duration between trade cycles, influencing the progress bar timing.
Ensure you customize these values in the configuration file to suit your trading strategy before running the bot.
To start the trading bot, run the main script bot.py:
The bot.py will:
- Synchronize the local time with the Binance server.
- Load active positions from the database.
- Fetch real-time market data and perform analysis.
- Generate trade signals based on the analyzed data.
- Place buy orders when market conditions are favorable and sell orders based on profit targets, technical conditions, or stop-loss triggers.
- Log all transactions and updates in real-time.
The console outputs provide a detailed status report including market data, portfolio distribution, EMA rejection signals, and a summary of recent trades.
- CSV Logging: All trades are recorded in a CSV file (
trade_log.csv), capturing details like timestamp, trade type, quantity, price, and profit/loss. - Database Management: The bot uses a
TradePositionManagerto store open positions and update them when trades are executed or closed. This persists historical trade data for performance analysis.
Ensure the logging paths and database connections are correctly configured in the project.
The bot implements robust error handling routines including:
- Retry mechanisms for fetching market data.
- Handling Binance API exceptions and synchronizing time if discrepancies are detected.
- Dynamic calculation of stop losses and trailing stops.
- Trade validation before order execution based on account balance and risk parameters.
These features help ensure that the bot can adapt to volatile market conditions and execute trades without manual intervention.
This project is licensed under the MIT License. See the LICENSE file for details.
Contributions and improvements are welcome. Please open an issue or submit a pull request for any enhancements or bug fixes.
WARNING: Trading cryptocurrency involves significant risk. The trading bot is provided "as is" without any warranties. Always test with small amounts and on testnet environments before trading with significant capital. Use at your own risk.