Skip to content

Latest commit

 

History

History
116 lines (79 loc) · 6.95 KB

README-en.md

File metadata and controls

116 lines (79 loc) · 6.95 KB

zenbot logo

“To follow the path, look to the master, follow the master, walk with the master, see through the master, become the master.” – Zen Proverb

Zenbot Deutsch Build/Test Status

This German version of Zenbot corresponds to the original English version v4.1.0 of [DeviaVir] (https://github.com/DeviaVir/zenbot).

System requirements:

3GB minimum memory.
On Raspberry Pi ARM 1 core with 1.5 GHz with 100% utilization.
or Raspberry Pi ARM 4 cores with 1.5 GHz each result in a utilization of 25%.

My update

The "ccxt" dependency has been changed and updated in package-lock.json from version "1.33.64" to version "1.40.1". The original dependency is still in the "package-lock-org.json" file and serves as a backup. Other versions of "ccxt" can be found at "https://registry.npmjs.org/ccxt/".

My work:

  1. I am rebuilding and reorganizing the Zenbot documentation. In terms of content, this remains the same and should be clearer. Errors during the installation on Raspberry Pi 4B 8GB are corrected.
  2. NPM is updated and reduced to the current status of all necessary NPMs.
  3. A rebuild of all existing Zenbot's will be done and released as a new branch.
  4. An integration of interesting forks is brought about.

Current Status

Zenbot 4 is functional, but is having trouble reliably making profit. At this point, I would recommend against trading with large amounts until some of these issues can be worked out:

  • Many people are reporting losses in live trading even if the simulation results and/or paper trading is positive.
  • This is my highest priority right now, since an unprofitable bot is not worth much, but please understand that reliably making profit is hard, and so is making a realistic simulator.
  • The losses may be due to the default strategy not working well in sideways (non-trending) market conditions, slippage during limit order execution, or both. Currently I would recommend against using Zenbot on a market that is non-trending or trending generally downwards.
  • The limit-order strategy that Zenbot uses to avoid taker fees, is prone to race conditions and delays. A mode for using market-type orders will probably need to be made, which may make frequent-trade strategies less viable due to fees, but more reliable execution overall.
  • An upcoming feature will allow Zenbot to use a limited amount of your balance, which will help with experimenting with live trading, but mitigating the possible losses from the issues above.

Zenbot is a hobby project for me and I'm sorry that I can't devote myself full-time to it. Since I'm getting busier, development may slow down a bit from here, so please be patient if issues aren't fixed right away.

Description

Zenbot is a command-line cryptocurrency trading bot using Node.js and MongoDB. It features:

Disclaimer

  • Zenbot is NOT a sure-fire profit machine. Use it AT YOUR OWN RISK.
  • Crypto-currency is still an experiment, and therefore so is Zenbot. Meaning, both may fail at any time.
  • Running a bot, and trading in general requires careful study of the risks and parameters involved. A wrong setting can cause you a major loss.
  • Never leave the bot un-monitored for long periods of time. Zenbot doesn't know when to stop, so be prepared to stop it if too much loss occurs.
  • Often times the default trade parameters will underperform vs. a buy-hold strategy, so run some simulations and find the optimal parameters for your chosen exchange/pair before going "all-in".

Documentation

The extensive documentation is located at the docs-folder.

Questions

First have a look at the docs and there are also FAQs which may answer your questions. If not, please ask (programming) questions related to Zenbot on Reddit (subreddit zenbot).

Community

Join the Zenbot community on Reddit!

Donate

P.S., some have asked for how to donate to Zenbot development. We accept donations at Bitcoin addresses below:

carlos8f's BTC (original Zenbot author)

187rmNSkSvehgcKpBunre6a5wA5hQQop6W

DeviaVir's BTC (current maintainer)

3A5g4GQ2vmjNcnEschCweJJB4umzu66sdY

zenbot logo

Thanks!

Noteworthy forks

These forks can also be found very easily with the herokuapp.


License: MIT

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.