Chapter 3: Client Configuration
Important: Neither the developer of this software, nor the liquidity operation on NuPool.net is in any way related to the official Nu core-team.
This chapter describes how to install and configure the console based client.
After completing the steps described in Chapter 2 you will have two values from Bittrex we will need now: Key and Secret. Please don’t forget to set the permissions as shown below:
Installing Python
If you are on Linux or Mac OS, then you don’t need to install Python because it comes with the operating system. On Windows you can download and install Python from here:
Installing the Client
- Download the client software from here: Release TLLP-v1.0 · verc/trustless-liquidity-pool · GitHub
- Extract the archive and switch to the folder extracted
- If you are on Windows then go to the
windows
folder, otherwise go to theunix
folder
Note: The software is completely platform independent. The only purpose of different folders for Windows and Unix based systems is to provide specialized starting scripts. You can also just call the script within the python
folder if you prefer.
Configuring the Client
Open the file pool.conf
in a text editor of your choice (on Windows please use Notepad). On the top of the file you will see three parameters:
# NuBits payout address
address = XXX
# API key from the exchange
apikey = XXX
# API secret from the exchange
apisecret = XXX
Enter your Key obtained in the previous chapter as value for apikey
and your Secret as value for apisecret
.
The value for address
must be a valid NuBits address. No other payout addresses are possible.
Important: For security reasons it is impossible to change the payout address of a registered key. If you want to change your payout address, please create a new API key and secret pair and use it together with your new payout address.
Optional Parameters
-
interest
: The minimal interest rate at which you want to get payouts in percent (0.25% = 0.25). Set this value to 0 to only allow for the pool’s maximum (this will lead to minimal payout). You can specify two interest rates for the bid and ask side by separating them with a comma, e.g.0.25,0.1
-
ordermatch
: This tells the trading bot to place orders even if they would match with an existing order. Set this value only to True if you know what you are doing. The default value is False. -
trading
: The trading bot used to place and reset the orders. Possible values arepybot
, which is the internal bot,nubot
, which is the official trading bot of the Nu dev team, ornone
to disable the trading bot completely. Note that your client will work 100% correctly if you just place your orders manually in the correct price range. Thenubot
is furthermore not supported yet but it should be the case soon.
Please do not change the remaining parameters (server
, unit
, exchange
). If you change any of these parameters, then you won’t be able to connect to the pool anymore
Starting the Client
With a fully configured pool.conf
you can start the client by making a double click on the file client
. On Windows this file might be shown as client.bat
and it might be the case that smart screen won’t allow the program to start, unless you click “further information” and then on “run anyway”.
Finally a terminal should open showing an output like this:
2015/04/09-02:18:23 INFO: bittrex - balance: 0.01775243 rate: 0.25% ppm: 0.00053809 efficiency: 100.00% rejects: 0 missings: 0 - btc - bid: 294.0214 x 0.25% - ask: 15.9180 x 0.25% - xxxxxxxxxxxxxxxxxxxxxxx
-
balance
:
The total amount of unpaid NBT. -
rate
:
Your effective interest rate, which corresponds to the expected daily interest rate you will get for the orders currently placed. -
ppm
:
Payout per minute. The amount of NBT that were added to your balance over the last minute. -
efficiency/rejects/missings
:
If the connection to the server or to the exchange is bad, then the server will not be able to validate your orders and therefore cannot compensate your liquidity. If a request never reached the server, you will see it by a non-zero number ofmissings
. If your requests reach the server, but cannot be validated at the exchange, then you will see a non-zero number ofrejects
. The efficiency corresponds to the fraction of all requests which are neither amissing
nor areject
. Your client will automatically try to fix efficiency issues, so if you are experiencing low efficiency values then please give the client up to 30 minutes to optimize its behavior. -
bid/ask
:
The total sum of your orders as recognized and compensated by the server on the corresponding side of the market.
The client will always ensure that the effective interest does not stay below the minimal interest rate specified. If the required interest rate cannot be obtained, then the bot will remove orders from the market. If you are not planning to decrease your minimal interest rate, then you should consider removing these funds from the exchange.
Please allow the client up to 5 minutes to output data.
Remark for former beta users: The old system with the users.dat
can still be used. You just have to pass the users.dat as first parameter to client.py
and use eu.nupool.net
as second parameter. Alternatively the data can also be read from the standard input by providing - as input file. You can even apply the multi-line format in the pool.conf and it will be read correctly.
Stopping the Client
You can stop the client by hitting CTRL+C. It will not terminate immediately! This is because it will need to remove all orders from your exchange which can take several seconds. In your own interest, please allow the client to shutdown correctly.