These settings control the buying and selling behavior of the bot for coins. It also contains “trigger” settings to control risk during market swings.


Video Guide to Pairs

NEW: This is an in depth overview of the Pairs file, following the wiki guide below. @RF Radio (~ 29 Minutes).

Use it to deeply understand how the Pairs settings control your buy and sell strategies.


Settings

Flow of the Coins in the Bot

When a coin is being watched closely by the bot due to your buy settings, it appears in the Possible Buy Log in the web user interface. Once it is bought, it appears in the Pairs Log. If you use DCA, it will appear in the DCA log. Once sold, it will appear in the Sales log. If a coin is in a suspended state caused by you creating a buy limit or sell limit order on the exchange, it will appear in the Pending log.

Click on a Section to jump to it


MASTER SETTINGS

 MARKET = BTC 

Define the market we are trading (BTC, ETH, XMR, BNB or USDT)
Note : XMR is valid in Poloniex only. BNB is valid in Binance only


ALL_enabled_pairs = ALL

OR

ALL_enabled_pairs = BTC-NEO, BTC-ADA <-- FOR BITTREX
ALL_enabled_pairs = BTC_NEO, BTC_ADA <-- FOR POLONIEX
ALL_enabled_pairs = NEOBTC, ADABTC <-- FOR BINANCE

Use to define what PAIRS you want the Profit Trailer to use for trading. List all pairs you want separated by comma or specify ALL to trade all pairs in your market


ALL_trading_enabled = true

Valid Entries are “true” or “false”

Enable trading (buying, selling and orders) using defined strategies for all pairs. If trading_enabled = false your running pairs/pending orders and balance will still be displayed in WATCHMODE.

COIN-PAIR ENABLED: This setting works with single coins. See here for more info.


ALL_panic_sell_enabled = false

Valid Entries are “true” or “false”

Set to “true” to sell all of your coins with a balance IMMEDIATELY for current market prices. It does what it says, and does it now. Use with caution.

COIN-PAIR ENABLED: This setting works with single coins. See here for more info.


ALL_sell_only_mode = false

Valid Entries are “true” or “false”

Turn on Sell Only Mode (SOM) for all your coins. No new buys are accepted. Note: The bot will continue to sell Pairs and DCA listed items if set to true.

COIN-PAIR ENABLED: This setting works with single coins. See here for more info.


ALL_DCA_enabled = false

OR

ALL_DCA_enabled = true

OR

ALL_DCA_enabled = -5

Valid Values: true, false, or a decimal value less or equal to 0. In the example above, -5 is -5%, so the coin will not be sent into DCA buying mode until the profit margin falls to -5% or below.

Setting to true or a negative value enables DCA for all pairs with a balance. Will use strategy defined in DCA.properties

DCA will enable if the value (profit % of average bought cost) of a coin drops below the specified amount. The coin will NOT go back to pairs log if it has been DCA'd 1 or more times

COIN-PAIR ENABLED: This setting works with single coins. See here for more info.



Top


BUY SETTINGS


ALL_buy_strategy = LOWBB

Valid Values: GAIN, LOWBB, HIGHBB, EMAGAIN, EMASPREAD, EMACROSS, SMAGAIN, SMASPREAD, SMACROSS, LOSS (See the Buy and Sell Strategies page for more info on each setting.)

The default strategy to use to make buys.

COIN-PAIR ENABLED: This setting works with single coins. See here for more info.


ALL_buy_value = 0

Valid Values: a decimal number 0 or greater.

The default strategy buy value, meaning the value that triggers a “buy.” Example, for LOWBB, if set to 0 (0%), a buy signal is generated when the price of the coin is equal to or lower than the LOWBB line. If it were set to -5 (-5%), the signal would be generated when the price is 5% below LOWBB.

Remember this is just the buy “signal” if you are using trailing. Trailing will follow the price down further and therefore may not buy immediately. See ALL_trailing_buy below.

See the Buy and Sell Strategies page for more info this setting.

COIN-PAIR ENABLED: This setting works with single coins. See here for more info.


ALL_buy_value_limit = 0

Valid Entries: positive or negative decimal numbers

Used with EMA/SMA SPREAD and CROSS strategies. This value limits the range for a buy.

NOTE: If ALL_buy_value is positive, the ALL_buy_value_limit can only be a higher positive value. If ALL_buy_value is negative, the ALL_buy_value_limit can only be a lower negative value.

Example: EMASPREAD ALL_buy_value = -2, ALL_buy_value_limit = -5
The bot will only buy if SPREAD is between -2% and -5%

NOTE: Trailing will not work beyond the limit

COIN-PAIR ENABLED: This setting works with single coins. See here for more info.


ALL_max_cost = 0.0012

Valid Values: Decimal value greater or equal to the lower trading limit set for each exchange.

The amount in the current base currency (BTC, ETH, XMR, BNB, or USDT) we will use to buy a pair. This amount is used for EACH purchase. If this amount is not available, the bot will not buy.

MINIMUM VALUES: The minimum ALL_max_cost for each exchange is shown below:

Binance:
BTC = 0.0012 (Variable depending on coin)
ETH = 0.011
BNB = 1
USDT = 1

Bittrex:
BTC = 0.0011
ETH = 0.00075
USDT = 3.75

Poloniex:
BTC = 0.0011
ETH = 0.0075
XMR = 0.00025
USDT = 1.25

COIN-PAIR ENABLED: This setting works with single coins. See here for more info.


ALL_max_cost_percentage = 2

Valid Values: Decimal value greater or equal to 0.

Indicate % of total current value (TCV) of account we will use to buy.

This property only works if ALL_max_cost = 0. This is useful when your balance changes frequently and you want to keep a minimum balance.

COIN-PAIR ENABLED: This setting works with single coins. See here for more info.


ALL_trailing_buy = 0.3

Valid Values: Decimal value greater or equal to 0.

This works exactly like the trailing profit but in reverse. The buy trigger will keep moving down. This will try to catch the price at its lowest point before buying

NOTE: Trailing does not work with HIGHBB

COIN-PAIR ENABLED: This setting works with single coins. See here for more info.


ALL_hidden_pairs = BTC-ETH, BTC-LTC
BTC-ETH_trading_enabled =  false 
BTC-LTC_trading_enabled =  false

NOTE: This setting is used in version 1.2.6.1 or later

If you would like to hide coin pairs from the bot, use the above “hidden” settings. Trading for each pair must be disabled as shown above.

Note: Remember to change the BTC-XXX to be formatted properly for the exchange. (BTC-XXX is for Bittrex, BTC_XXX is for Poloniex, and XXXBTC is for Binance)



Top


POSSIBLE BUY LOG SETTINGS

These settings influence the number of currencies that the PT bot will use as potential buy candidates (and will therefore place in the Possible Buy Log in the web monitor (GUI)). For a complete discussion of settings that influence the PBL, see the FAQ section.

ALL_max_trading_pairs = 0

Valid Values: Integer greater or equal to 0.

Max amount of pairs that the bot is allowed to own at one time.

Calculated by adding up all the coins in Pairs Log, and DCA Log. Once the max is reached, the bot will not buy any new pairs until we sell, nor will it place any pairs in the Possible Buy Log. DCA is still allowed to buy.

Set to 0 for unlimited pairs.


ALL_min_buy_price = 0.00000500

Valid Values: Decimal values greater or equal to 0

Set to ignore low value coins (like Doge or others) that are sometimes problematic to trade. If you do not want to buy coins that are below a certain price per coin, use this setting.

COIN-PAIR ENABLED: This setting works with single coins. See here for more info.


ALL_max_buy_spread = 2

Valid Values: a decimal number equal or greater than 0.

Max spread % between lowest ask and highest bid to allow a new buy order. If spread is too big, most likely there was a coin dump/pump and you are buying too high. A value of 2 is mildly conservative. 1 is more conservative. 3 would be more aggressive.

COIN-PAIR ENABLED: This setting works with single coins. See here for more info.


ALL_min_buy_volume = 500

Valid Values: Decimal value greater or equal to 0.

Tell the bot to only buy coins with a minimum volume of specified amount. Volume is measured in units of your base currency. If you are trading BTC, 500 = 500 BTC in 24 hour volume. If USDT, 500 = $500 (so you may need to increase this value according to volume levels on USDT on the exchange in question).

It is more risky to trade low volume coins because it is more difficult to sell them quickly or buy them quickly due to the lower available trading partners, which can lead to negative price impacts.

COIN-PAIR ENABLED: This setting works with single coins. See here for more info.


ALL_min_buy_balance = 0.5

Valid Values: Decimal value greater or equal to 0.

Tell the bot to only buy coins if the buy cost will not let your balance go below specified amount. In the example above, if we are trading BTC, the bot will keep at least 0.5BTC in your account.

Note: You also still need to set this value (min_buy_balance in DCA.properties) in DCA if you always want some balance left from DCA buying activites


ALL_min_buy_balance_percentage = 60

Valid Values: Decimal value greater or equal to 0.

Tell the bot to only buy coins if the buy cost will not let your balance go below specified amount in % of your TCV (Total Current Value).

Example. To always leave 60% of my account untouched. set value to 60% (This will spend 40% of your balance on buying outside of DCA).

This property only works if ALL_min_buy_balance = 0

Note : You also still need to set this value in DCA.properties if you always want some balance left, as that selling process is completely separate from the Pairs buying process.

COIN-PAIR ENABLED: This setting works with single coins. See here for more info.


ALL_buy_available_volume_trigger = 150

Valid Values: Decimal value greater or equal to 0.

Allow initial buys if there's enough volume in order book to fill the order. This helps against partial buys.

100 means there should be at least 100% of the amount we want to buy in the orderbook. 150 means there should be 150% of the amount we want to buy in the orderbook to issue the buy order. So if you need 5 coins at price A, at 150, the orderbook should have at least 7.5 coins at price A or lower before it will be allowed to buy.

COIN-PAIR ENABLED: This setting works with single coins. See here for more info.



Top


SELL SETTINGS

ALL_sell_strategy = GAIN

Valid Values: GAIN, HIGHBB.

The strategy to use to sell. The GAIN strategy uses a simple % gain over average bought price (set by ALL_sell_value) to look for the opportunity to sell the coin. HIGHBB sells when the average bought price of the coin reaches the level (set by ALL_sell_value) near the HIGH BB line.

COIN-PAIR ENABLED: This setting works with single coins. See here for more info.


ALL_sell_value = 1

Valid Values: a decimal number (can be positive or negative)

The strategy sell value. The value that triggers a sell to begin (which may also include trailing profit).

For GAIN:
Valid Values: Decimal values greater than or equal to 0.

For GAIN it is the profit % over the bought price.

For HIGHBB:
Valid Values: from -100 to 100. Default is 0. Lower is more aggressive. Higher is more conservative.

Represents the percentage over the high BB line. 0 is equal to the high BB line. 50 is 50% between the high and low BB, or the middle line. 100 is the Low BB line, or 100% from the high BB line. -10 is 10% ABOVE the high BB line.

COIN-PAIR ENABLED: This setting works with single coins. See here for more info.


ALL_min_profit = 1

Valid Values: Decimal numbers greater than or equal to 0.

Use the value to ensure you have reached a suitable profit level when using HIGHBB as a sell strategy.

NOTE: Not used with GAIN strategy.


ALL_trailing_profit = 0.5

Valid Values: Decimal number greater than or equal to zero.

Use with gain strategy to try and maximize your profit.

In short, tries to trail the profit upwards to gain better profits. More detail in on how Trailing works here in A Trailing Story.

NOTE: trailing does not work with HIGHBB

COIN-PAIR ENABLED: This setting works with single coins. See here for more info.



Top


TRIGGERS

Triggers are used to control risk with the bot. Set these carefully if you wish to control when the bot buys. Often when the market makes a swing, it is caused by the underlying currency (BTC) moving up or down wildly. When it does so, these triggers will help to turn on “Sell Only Mode” (SOM).


ALL_btc_price_drop_trigger = 4

Valid Values: Decimal values greater or equal to 0

Turn on sell only mode (SOM) if BTC price drops the percentage in the setting (Uses 24h % change in price).

You will receive a telegram message to inform you of this.


ALL_btc_price_drop_recover_trigger = 1

Valid Values: Decimal values greater or equal to 0

Turn off sell only mode if it was activated by price drop and BTC price recovers by the percentage in the setting. (Uses 24h % change in price).

You will receive a telegram message to inform you of this.


ALL_btc_price_rise_trigger = 5

Valid Values: Decimal values greater or equal to 0

Turn on sell only mode if BTC price rises x% amount (Uses 24h change price). Useful to protect against large market swings if a big BTC price swing changes the market dynamics.

You will receive a telegram message to inform you of this


ALL_btc_price_rise_recover_trigger = 2

Valid Values: Decimal values greater or equal to 0

Turn off sell only mode if it was activated by price rise and BTC price goes back down to x% amount (Uses 24h change price).
You will receive a telegram message to inform you of this


ALL_consecutive_buy_trigger = 5

Valid Values: Decimal values greater or equal to 0

Turn on sell only mode if we got x consecutive buys and no sells in between (market is going down). Useful to protect against large market swings if something changes the market dynamics.

You will receive a telegram message to inform you of this.


ALL_consecutive_sell_trigger = 3

Valid Values: Decimal values greater or equal to 0

Turn off sell only mode if we got x consecutive sells with no buys in between (market is recovering)

You will receive a telegram message to inform you of this


ALL_pending_order_wait_time = 360

Valid Values: Integer values greater or equal to 0

If x amount of time in minutes has passed since we bought a coin, create a pending order for that pair. Set to 0 to disable.

This enables the bot to buy this pair again. Therefore, if you want the bot to continue to purchase this pair while you have a purchase that is currently held at a loss, then set this parameter to some value that is a day or two away from the original purchase date (2880 minutes = 48 hours). Then the bot will place a sell order at the sell_value (for GAIN) or min_profit (for HIGHBB) % and will place your pair in the “Pending” log.

At that time, the bot will begin to buy more of the pair at the current “Pairs log buy strategy”, and will report the Profit % and the Comb Profit % in the Pending Log.

Note: Coins that sell from a pending order are not recorded in the sales log.


ALL_combined_cancel_pending_trigger = 0

Valid Values: Decimal value greater or equal to 0.

Cancel pending order for specified coin if avg profit reaches specified amount


ALL_stop_loss_trigger = -10

Set the value that will trigger a stop loss order.

If the value of a coin drops below stop loss trigger, it will be automatically sold, potentially FOR A LOSS. Use carefully. Research Stop Loss from a financial website before using it.

NOTE: stop loss positive values are automatically converted to negative value

COIN-PAIR ENABLED: This setting works with single coins. See here for more info.


ALL_stop_loss_timeout = 5

Valid Values: Integer values greater or equal to 0

Set the amount of minutes that the bot is not allowed to buy a coin after it was sold by stop loss trigger

COIN-PAIR ENABLED: This setting works with single coins. See here for more info.


ALL_rebuy_timeout = 5

Valid Values: Integer values greater or equal to 0

Set the amount of minutes that the bot is not allowed to buy a coin after it was sold. ex: We just sold ETH so do NOT buy ETH again for x minutes after we sold it

COIN-PAIR ENABLED: This setting works with single coins. See here for more info.



Top


COIN SPECIFIC SETTINGS

Pairs.properties file is the location for all coin specific settings. Here are some examples of how they can be used. Settings that can be added for coin specific pairs are denoted above with: COIN-PAIR ENABLED

Detailed explanation has been relocated to FAQs.


BTC_SYS_DCA_enabled = false

Enables or Disables DCA for specified coin
If ALL_DCA_enabled is true this will disable DCA only for this coin


BTC_SC_trading_enabled = false

Enable or Disable trading for specified coin If ALL_trading_enabled is true this setting will disable trading only for this coin


BTC_SC_sell_value = 0.6

See ALL_sell_value for further explanation, but this says “sell SC when it's price is 0.6% above the buy price.”

Represents a sell value for the specified coin to specified percentage. If ALL_sell_value is specified, this setting will override it.

Coin settings always take precedence over “ALL_” settings.



Top


  • pairs.properties1.txt
  • Last modified: 7 months ago
  • by solanthus