https://github.com/zazu252/rebalancer
The system performs scheduled scans of the user's wallet to retrieve current WBTC and WETH balances, computes deviations from predefined allocation ratios, and executes the necessary swap operations via Uniswap smart contracts to restore target portfolio weights.
https://github.com/zazu252/rebalancer
automation degiro-api ethereum ethereumglobal hackmoney2021 lightning lightning-network passive-investing portfolio portfolio-rebalancer rebalance rebalancing-bot rust trading
Last synced: 11 months ago
JSON representation
The system performs scheduled scans of the user's wallet to retrieve current WBTC and WETH balances, computes deviations from predefined allocation ratios, and executes the necessary swap operations via Uniswap smart contracts to restore target portfolio weights.
- Host: GitHub
- URL: https://github.com/zazu252/rebalancer
- Owner: zazu252
- Created: 2025-04-11T12:45:07.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-06-15T01:36:41.000Z (12 months ago)
- Last Synced: 2025-06-15T02:33:28.638Z (12 months ago)
- Topics: automation, degiro-api, ethereum, ethereumglobal, hackmoney2021, lightning, lightning-network, passive-investing, portfolio, portfolio-rebalancer, rebalance, rebalancing-bot, rust, trading
- Language: Python
- Size: 1.41 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Rebalancer: Automated Crypto Portfolio Management 🤖💰
 [](https://github.com/zazu252/rebalancer)
Welcome to **Rebalancer**, your go-to solution for automated management of your crypto portfolio. This system scans your wallet on a schedule, retrieves your current WBTC and WETH balances, computes deviations from your target allocation ratios, and executes swap operations via Uniswap smart contracts.
## Table of Contents
- [Features](#features)
- [Installation](#installation)
- [Usage](#usage)
- [Configuration](#configuration)
- [How It Works](#how-it-works)
- [Technologies Used](#technologies-used)
- [Contributing](#contributing)
- [License](#license)
- [Contact](#contact)
## Features 🌟
- **Automated Portfolio Rebalancing**: Keep your investments aligned with your goals without constant manual adjustments.
- **Scheduled Scans**: The system checks your wallet at regular intervals to ensure timely actions.
- **Deviation Calculation**: Understand how far your portfolio strays from your desired allocation.
- **Uniswap Integration**: Execute swaps seamlessly using Uniswap smart contracts.
- **User-Friendly Configuration**: Simple setup and easy customization options.
## Installation 🛠️
To get started with Rebalancer, follow these steps:
1. Clone the repository:
```bash
git clone https://github.com/zazu252/rebalancer.git
cd rebalancer
```
2. Install the required dependencies:
```bash
npm install
```
3. Download the latest release from the [Releases section](https://github.com/zazu252/rebalancer/releases) and execute the necessary files.
## Usage 🚀
To use Rebalancer, follow these instructions:
1. **Start the Application**:
```bash
npm start
```
2. **Monitor Your Portfolio**: The system will automatically scan your wallet and make necessary adjustments based on your predefined ratios.
3. **Check the Logs**: Monitor the console output for information on swaps and balances.
## Configuration ⚙️
You can customize Rebalancer to fit your needs by editing the `config.json` file. Here are some key parameters you can adjust:
- **Wallet Address**: Specify your wallet address for balance checks.
- **Target Ratios**: Set your desired allocation ratios for WBTC and WETH.
- **Scan Interval**: Define how often the system should check your wallet.
### Example Configuration
```json
{
"walletAddress": "0xYourWalletAddress",
"targetRatios": {
"WBTC": 0.6,
"WETH": 0.4
},
"scanInterval": 3600
}
```
## How It Works 🔍
Rebalancer operates through a series of steps:
1. **Scheduled Scans**: The system runs at set intervals, checking your wallet for current balances.
2. **Deviation Calculation**: It calculates how much your current balances deviate from your target ratios.
3. **Swap Execution**: If deviations exceed a certain threshold, the system interacts with Uniswap smart contracts to execute swaps and restore your target weights.
## Technologies Used 🛠️
- **Node.js**: The backend is built using Node.js for efficient server-side operations.
- **Infura API**: Connects to the Ethereum network for wallet interactions.
- **Uniswap V3**: Utilizes Uniswap smart contracts for executing trades.
- **Express**: Serves as the web framework for the application.
## Contributing 🤝
We welcome contributions! If you want to improve Rebalancer, please follow these steps:
1. Fork the repository.
2. Create a new branch:
```bash
git checkout -b feature/YourFeature
```
3. Make your changes and commit them:
```bash
git commit -m "Add your message"
```
4. Push to the branch:
```bash
git push origin feature/YourFeature
```
5. Create a pull request.
## License 📄
This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
## Contact 📬
For questions or feedback, please reach out:
- **Email**: support@example.com
- **Twitter**: [@YourTwitterHandle](https://twitter.com/YourTwitterHandle)
## Conclusion 🎉
Rebalancer simplifies crypto portfolio management by automating the rebalancing process. With its user-friendly interface and powerful features, you can maintain your desired asset allocation with ease.
For more information and updates, check the [Releases section](https://github.com/zazu252/rebalancer/releases) and start optimizing your crypto investments today!