{"id":19229107,"url":"https://github.com/sleeyax/voltra","last_synced_at":"2025-05-10T08:31:02.941Z","repository":{"id":228102414,"uuid":"759192797","full_name":"sleeyax/voltra","owner":"sleeyax","description":"Cross-market volatile cryptocurrency trading bot","archived":true,"fork":false,"pushed_at":"2024-12-03T14:49:20.000Z","size":213,"stargazers_count":41,"open_issues_count":10,"forks_count":7,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-02-16T18:41:37.110Z","etag":null,"topics":["algorithmic-trading","binance","binance-bot","bitcoin","btc","cryptocurrencies","cryptocurrency","cryptocurrency-trading-bot","go-crypto-volatility-trading-bot","trade","trading-bot"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sleeyax.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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}},"created_at":"2024-02-17T22:38:28.000Z","updated_at":"2025-02-10T12:06:28.000Z","dependencies_parsed_at":"2024-03-17T05:31:57.135Z","dependency_job_id":"991059d0-7b67-4abb-a00e-7a21c59daa9c","html_url":"https://github.com/sleeyax/voltra","commit_stats":null,"previous_names":["sleeyax/voltra"],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sleeyax%2Fvoltra","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sleeyax%2Fvoltra/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sleeyax%2Fvoltra/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sleeyax%2Fvoltra/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sleeyax","download_url":"https://codeload.github.com/sleeyax/voltra/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253389674,"owners_count":21900798,"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":["algorithmic-trading","binance","binance-bot","bitcoin","btc","cryptocurrencies","cryptocurrency","cryptocurrency-trading-bot","go-crypto-volatility-trading-bot","trade","trading-bot"],"created_at":"2024-11-09T15:32:30.389Z","updated_at":"2025-05-10T08:31:02.935Z","avatar_url":"https://github.com/sleeyax.png","language":"Go","readme":"\u003ch1 align=\"center\"\u003e\n  \u003cimg width=\"150\" src=\"https://i.ibb.co/3Y1sJDQ/c175b5cd-93cd-4942-b040-d4f4b5abd2b2.jpg\" alt=\"logo\" /\u003e\n  \u003cp\u003eVoltra\u003c/p\u003e\n\u003c/h1\u003e\n\u003cp align=\"center\"\u003eA cross-market cryptocurrency volatility trading bot written in go.\u003c/p\u003e\n\n\u003e [!WARNING]  \n\u003e Trading cryptocurrency carries risks. This bot is a tool, not financial advice. Use at your own discretion.\n\n![build status](https://github.com/sleeyax/voltra/actions/workflows/run_tests.yml/badge.svg)\n\n## Project status\n\n**NO LONGER MAINTAINED. CONSIDER USING [gocryptotrader](https://github.com/thrasher-corp/gocryptotrader) INSTEAD!**\n\n## Strategy\nThe bot analyses changes in price of all coins across all supported marketplaces and places trades on the most volatile ones.\n\n## Features\n- [x] Supports multiple cryptocurrency marketplaces\n- [x] Highly [configurable](./config.example.yml)\n    - Configurable stop loss (SL) and take profit (TP)\n    - Trailing SL and TP\n    - Limit amount of coins to trade\n    - Option to include or exclude specific pairs\n    - Option to reinvest profits\n    - Configurable intervals, trading fees etc.\n    - ...\n- [x] Optimized for speed and efficiency\n    - Selling and buying coins happens in different goroutines (= lightweight threads)\n    - Marketplace API requests are reduced to a minimum\n- [x] Trade history is stored to a (local) database. \n- [x] Production-grade logging\n- [ ] Receive status updates via Telegram or Discord\n- [ ] [Request a feature!](https://github.com/sleeyax/voltra/issues/new?assignees=\u0026labels=feature\u0026projects=\u0026template=feature_request.md\u0026title=)\n\n## Supported markets\n- [x] Binance\n- [ ] [Request marketplace](https://github.com/sleeyax/voltra/issues/new?assignees=\u0026labels=feature,marketplace+request\u0026projects=\u0026template=feature_request.md\u0026title=)\n\nIf you're a developer, you can add support for a new marketplace by implementing the `Market` interface [here](https://github.com/sleeyax/voltra/blob/main/internal/market/market.go).\nSee the [Binance](https://github.com/sleeyax/gvoltra/blob/main/internal/market/binance.go) implementation as an example. Comment on the relevant issue if you need help.\n\n## Getting started\n\nFirst of all, make sure you have a valid config file. You can use the [example config](./config.example.yml) as a starting point:\n\n```sh\n$ cp config.example.yml config.yml\n```\n\nOpen the file in your text editor of choice and edit it according to your preferred trading strategy. Don't forget to at least configure your API keys!\n\n### Binaries\nThe easiest way to get started is by downloading the latest release for your operating system from the [releases page](https://github.com/sleeyax/voltra/releases). \nExtract the archive, copy your config file to the same directory and finally run the binary in a terminal/command prompt as follows:\n\n```sh\n$ ./voltra\n```\n\n### Docker\nYou can run the bot on any platform or cloud provider that supports Docker.\n\nFirst, pull the latest image from GitHub's container registry as follows:\n```sh\n$ docker pull ghcr.io/sleeyax/voltra:latest\n```\n\n\u003cdetails\u003e\n  \u003csummary\u003eOR click here for instructions to build from source\u003c/summary\u003e\n  Clone the source code and build the docker image locally:\n\n  ```sh\n  $ git clone https://github.com/sleeyax/voltra.git\n  $ cd voltra\n  $ docker build --tag ghcr.io/sleeyax/voltra:latest .\n  ```\n\u003c/details\u003e\n\nThen, to run the bot you have the option to run with our without data persistence. When you opt for the latter, any outputted data such as your database will be deleted as soon as the container is removed.\n\n- With full data persistence:\n\n```sh\n$ docker run --name voltra --volume ./config.yml:/bot/config.yml:ro --volume ./data:/bot/data -it sleeyax/voltra:latest\n```\n\nAlternatively, you can store your config file in the `data` directory and only mount that directory:\n\n```sh\n$ docker run --name voltra --volume ./data:/bot/data -it sleeyax/voltra:latest\n```\n\n- Without data persistence:\n\n```sh\n$ docker run --name voltra --volume ./config.yml:/bot/config.yml:ro -it sleeyax/voltra:latest\n```\n\n## Credits\nInspired by [CyberPunkMetalHead/Binance-volatility-trading-bot](https://github.com/CyberPunkMetalHead/Binance-volatility-trading-bot) and [its many forks](https://useful-forks.github.io/?repo=CyberPunkMetalHead/Binance-volatility-trading-bot).\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsleeyax%2Fvoltra","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsleeyax%2Fvoltra","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsleeyax%2Fvoltra/lists"}