Stable release

To install Cointrader, run this command in your terminal:

$ pip install cointrader

This is the preferred method to install Cointrader, as it will always install the most recent stable release.

If you don’t have pip installed, this Python installation guide can guide you through the process.

From sources

The sources for Cointrader can be downloaded from the Github repo.

You can either clone the public repository:

$ git clone git://

Or download the tarball:

$ curl  -OL

Once you have a copy of the source, you can install it with:

$ python install


Contraider uses a configuration file to set some important settings like the key and the secret for the API on the configured exchange. A configuration looks like this and must be located in your $HOME directory with the filename .cointrader.ini. Please make sure you have created a configuration file.:

# Set default exchange which will be used for trading.
# Currently onyl Poloniex is supported!
exchange = poloniex

# See for more details.

## Default logging configuration of the application.
keys = root, cointrader

keys = console

keys = generic

level = ERROR
handlers = console

level = INFO
handlers =
qualname = cointrader

class = StreamHandler
args = (sys.stderr,)
level = NOTSET
formatter = generic

format = %(asctime)s %(levelname)-5.5s [%(name)s][%(threadName)s] %(message)s