NOTE: BitDo2 is still under development, and can't execute rules quite yet. It can display and track your holding history to a local database. Please wait a little bit longer until it can execute rules.
A cryptocurrency automated trader (not an intelligent trader!) and set of utilities.
The intention of this is to provide a configurable platform for performing automated trades at preset points.
Make sure to use at least node 6.x. You can always find the version of node I'm using in the .nvmrc file.
If you get an error about installing/loading the exchanges or plugins, make sure you're running an up-to-date version of
can update npm by running
npm update -g npm.
npm install -g bitdo2
You will need a file
bitdo.conf that contains your exchange configuration.
It should look something like this (Fill in your own secrets):
exchanges:gdax:passphrase: xxxkey: yyyb64secret: zzzbittrex:apikey: wwwapisecret: dddrobinhood:username: xxxpassword: yyyverbose: false
Along with being a platform library, there are several utilities you can use that ship with bitdo2.
Using as a Library
By default, you can use bitdo2 as a library in your own applications. It exports the common exchange abstraction, so you can operate on various exchanges without having to worry about their specific APIs.
const bitdo2 = ;bitdo2;ORbitdo2;
Make sure you have configuration in the current directory.
You will be presented with a UI showing your current holdings and orders.
Watches prices or orders for completion or failure cases. Meant to be chained with something else, eg:
# Watch an order and alertbitdo-watch -p gdax:BTC-USD --crosses 20000 --timeout 1d && notify-send "Bitcoin crossed 20000!" || notify-send "Bitcoin didnt cross after a day"# Trigger an order when a price dips below a valuebitdo-watch -p gdax:BTC-USD --below 18000 --timeout 1d && bitdo-order buy -p gdax:BTC-USD --price 18000 --amount 0.1 || echo "Order timed out"# And can even be chained for more complex scenarios (Crosses below, then back up)bitdo-watch -p gdax:BTC-USD --below 18000 && bitdo-watch -p gdax:BTC-USD --above 18500 || bitdo-order ...
This allows you to execute buy/sell/trail orders via command line on any configured exchanges.
DO SO AT YOUR OWN RISK!
This will (by default) poll your holdings in exchanges and write them to a sqlite DB so you can track them over time.
Uses Sequelize to write to DB, so can use any database it supports (mysql, postgres, etc)
There are two abstracted parts of bitdo2 that support plugins: exchanges and plugins
Although bitdo2 comes with a set of exchanges builtin (though internally, they're just plugins), you
can extend this by creating a global package (or installing a global package) with the name
XXX is the name of your exchange.
When loading, bitdo will search for a local exchange first, and if one is not found, will check the global packages.
If you want to implement a new exchange, look at the plugin constract for required methods and contracts.
Some pieces of bitdo use plugins to extend the application without needing to pull the dependencies into the main app.
Similar to the exchange, these plugins will first be loaded internally, and then searched for in the global
node modules with the pattern
To develop a plugin look at plugin contract
Copyright (c) 2017 Christopher LaPointe
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.