# DCAv2Earn

DCAv2Earn is a companion project for DCAv2. It automates the process of allocating a portion of idle funds on your exchange accounts to earn programs provided by each exchange. The system ensures that your funds are efficiently utilized to generate passive income while maintaining a minimum balance in your trading accounts at all times.

## Features

- **Automatic Allocation**: Automatically transfers a configurable percentage of your idle funds to the earn program of each supported exchange.
- **Configurable Parameters**:
  - **Percentage of Funds**: Specify what percentage of your idle funds should be allocated to the earn program.
  - **Minimum Balance**: Set a minimum balance that must remain in your trading account to prevent over-allocation.
  - **Step Size**: Define the step size for balance adjustments to ensure smooth transitions.
- **Multiple Exchanges Support**: Currently supports Binance, Gate.io, KuCoin and OKX. More exchanges can be added as needed.
- **Logging and Monitoring**: Provides real-time monitoring of your funds' allocation and performance.

## Prerequisites

- **Python 3.8+**: Ensure you have Python 3.8 or higher installed.
- **API Keys**: Obtain API keys from the supported exchanges with the necessary permissions for transferring funds (NOT withdrawing) and accessing earn programs.

## Installation

1. **Clone the Repository**:
   ```bash
   git clone https://gitea.nicosanchez.com.ar/nicolas/DCAv2Earn.git
   cd DCAv2Earn
   ```

2. **Configure the System**:
   - Create a `config.json` file with the necessary configuration parameters.
   - Use `config.json.example` as a template.


3. **Load the credentials to credentials.py**
    ```
    Check credentials.py.example and replace the placeholders with your actual API keys. Then, rename the file to credentials.py.
    ```

4. **Run the System**:
   ```bash
   python main.py
   ```

## Configuration

- **lap_time**: The time in seconds between each lap of the system. During each lap, the system checks and adjusts your funds' allocation.
- **minimum_amount_in_trading_account**: The minimum amount of funds that must remain in your trading account at all times to prevent over-allocation.
- **percentage_of_funds_to_commit**: The percentage of your idle funds to allocate to the earn program.
- **step_size**: The step size for balance adjustments, ensuring smooth transitions between balances.
- **api_keys**: API keys for each supported exchange with the necessary permissions. The API keys are stored in credentials.py

## Usage

### ATTENTION: THIS PROGRAM IS A PERSONAL PROJECT AND IS NOT INTENDED TO BE USED BY ANYONE ELSE. USE AT YOUR OWN RISK.

The system runs continuously in the background, automatically allocating your funds to the earn program according to the specified parameters. You can monitor the system's performance and status through the provided logging and monitoring features.

## Support

For any questions, issues, or feature requests, please create an issue on the Gitea repository (https://gitea.nicosanchez.com.ar/nicolas/DCAv2Earn/issues).

## License

DCAv2Earn is released under the MIT License.

---