{"id":27535610,"url":"https://github.com/zazu252/rebalancer","last_synced_at":"2025-07-05T15:14:04.620Z","repository":{"id":287400856,"uuid":"964578219","full_name":"zazu252/rebalancer","owner":"zazu252","description":"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.","archived":false,"fork":false,"pushed_at":"2025-06-15T01:36:41.000Z","size":1479,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-15T02:33:28.638Z","etag":null,"topics":["automation","degiro-api","ethereum","ethereumglobal","hackmoney2021","lightning","lightning-network","passive-investing","portfolio","portfolio-rebalancer","rebalance","rebalancing-bot","rust","trading"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zazu252.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-04-11T12:45:07.000Z","updated_at":"2025-06-15T01:36:45.000Z","dependencies_parsed_at":"2025-05-17T09:29:12.716Z","dependency_job_id":"4ccd31df-5bc6-4b55-ba0b-62549e47cd0a","html_url":"https://github.com/zazu252/rebalancer","commit_stats":null,"previous_names":["zazu252/rebalancer"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/zazu252/rebalancer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zazu252%2Frebalancer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zazu252%2Frebalancer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zazu252%2Frebalancer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zazu252%2Frebalancer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zazu252","download_url":"https://codeload.github.com/zazu252/rebalancer/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zazu252%2Frebalancer/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260590308,"owners_count":23033035,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["automation","degiro-api","ethereum","ethereumglobal","hackmoney2021","lightning","lightning-network","passive-investing","portfolio","portfolio-rebalancer","rebalance","rebalancing-bot","rust","trading"],"created_at":"2025-04-18T19:07:51.918Z","updated_at":"2025-06-18T16:36:55.408Z","avatar_url":"https://github.com/zazu252.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Rebalancer: Automated Crypto Portfolio Management 🤖💰\n\n![GitHub Release](https://img.shields.io/badge/Latest_Release-v1.0.0-brightgreen) [![GitHub Repo](https://img.shields.io/badge/GitHub-Repo-blue)](https://github.com/zazu252/rebalancer)\n\nWelcome 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. \n\n## Table of Contents\n\n- [Features](#features)\n- [Installation](#installation)\n- [Usage](#usage)\n- [Configuration](#configuration)\n- [How It Works](#how-it-works)\n- [Technologies Used](#technologies-used)\n- [Contributing](#contributing)\n- [License](#license)\n- [Contact](#contact)\n\n## Features 🌟\n\n- **Automated Portfolio Rebalancing**: Keep your investments aligned with your goals without constant manual adjustments.\n- **Scheduled Scans**: The system checks your wallet at regular intervals to ensure timely actions.\n- **Deviation Calculation**: Understand how far your portfolio strays from your desired allocation.\n- **Uniswap Integration**: Execute swaps seamlessly using Uniswap smart contracts.\n- **User-Friendly Configuration**: Simple setup and easy customization options.\n\n## Installation 🛠️\n\nTo get started with Rebalancer, follow these steps:\n\n1. Clone the repository:\n   ```bash\n   git clone https://github.com/zazu252/rebalancer.git\n   cd rebalancer\n   ```\n\n2. Install the required dependencies:\n   ```bash\n   npm install\n   ```\n\n3. Download the latest release from the [Releases section](https://github.com/zazu252/rebalancer/releases) and execute the necessary files.\n\n## Usage 🚀\n\nTo use Rebalancer, follow these instructions:\n\n1. **Start the Application**:\n   ```bash\n   npm start\n   ```\n\n2. **Monitor Your Portfolio**: The system will automatically scan your wallet and make necessary adjustments based on your predefined ratios.\n\n3. **Check the Logs**: Monitor the console output for information on swaps and balances.\n\n## Configuration ⚙️\n\nYou can customize Rebalancer to fit your needs by editing the `config.json` file. Here are some key parameters you can adjust:\n\n- **Wallet Address**: Specify your wallet address for balance checks.\n- **Target Ratios**: Set your desired allocation ratios for WBTC and WETH.\n- **Scan Interval**: Define how often the system should check your wallet.\n\n### Example Configuration\n```json\n{\n  \"walletAddress\": \"0xYourWalletAddress\",\n  \"targetRatios\": {\n    \"WBTC\": 0.6,\n    \"WETH\": 0.4\n  },\n  \"scanInterval\": 3600\n}\n```\n\n## How It Works 🔍\n\nRebalancer operates through a series of steps:\n\n1. **Scheduled Scans**: The system runs at set intervals, checking your wallet for current balances.\n2. **Deviation Calculation**: It calculates how much your current balances deviate from your target ratios.\n3. **Swap Execution**: If deviations exceed a certain threshold, the system interacts with Uniswap smart contracts to execute swaps and restore your target weights.\n\n## Technologies Used 🛠️\n\n- **Node.js**: The backend is built using Node.js for efficient server-side operations.\n- **Infura API**: Connects to the Ethereum network for wallet interactions.\n- **Uniswap V3**: Utilizes Uniswap smart contracts for executing trades.\n- **Express**: Serves as the web framework for the application.\n\n## Contributing 🤝\n\nWe welcome contributions! If you want to improve Rebalancer, please follow these steps:\n\n1. Fork the repository.\n2. Create a new branch:\n   ```bash\n   git checkout -b feature/YourFeature\n   ```\n3. Make your changes and commit them:\n   ```bash\n   git commit -m \"Add your message\"\n   ```\n4. Push to the branch:\n   ```bash\n   git push origin feature/YourFeature\n   ```\n5. Create a pull request.\n\n## License 📄\n\nThis project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.\n\n## Contact 📬\n\nFor questions or feedback, please reach out:\n\n- **Email**: support@example.com\n- **Twitter**: [@YourTwitterHandle](https://twitter.com/YourTwitterHandle)\n\n## Conclusion 🎉\n\nRebalancer 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. \n\nFor more information and updates, check the [Releases section](https://github.com/zazu252/rebalancer/releases) and start optimizing your crypto investments today!","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzazu252%2Frebalancer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzazu252%2Frebalancer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzazu252%2Frebalancer/lists"}