Ichimoku

This page describes how margin trading on Bitmex works with the ichimoku strategy. The triggers for trades are slightly different than in the same strategy for regular trading.

How to work with this strategy

Expected behavior for margin trading

Gunbot will open one position, either long or short, and close this position when the target is reached. When the stop is hit before profitably closing a trade, Gunbot will place a stop order at loss. After closing a position, Gunbot will again look to open a new long or short position. Gunbot will not add to existing open positions.

Please don't manually add to or reduce positions opened by Gunbot, unless you stop running Gunbot on this trading pair until you've closed this position.

​

For this strategy it is recommended to use an additional momentum indicator to confirm long and short entries.

Long / Buy

Before a long position is opened, one of the following conditions must occur to put Gunbot on "long alert":

1. The current candle crosses over Kumo. This means that all of open, close, high and low must be above Kumo.

2. Tenkan-sen crosses over Kijun-sen, above Kumo.

A long position is then opened when both of the following confirmations happens in a later cycle, they do not have to happen in the same cycle:

1. Chikou-span crosses over the "past Kumo" (Kumo value of x periods ago, defined by DISPLACEMENT).

2. The "future Kumo" is bullish/green (Kumo value of x periods in the future, defined by DISPLACEMENT).

Short / Sell

Before a short position is opened, one of the following conditions must occur to put Gunbot on "short alert":

1. The current candle crosses below Kumo. This means that all of open, close, high and low must be below Kumo.

2. Tenkan-sen crosses under Kijun-sen, below Kumo.

A short position is then opened when both of the following confirmations happens in a later cycle, they do not have to happen in the same cycle:

1. Chikou-span crosses under the "past Kumo" (Kumo value of x periods ago, defined by DISPLACEMENT).

2. The "future Kumo" is bearish/red (Kumo value of x periods in the future, defined by DISPLACEMENT).

Close

A long position is closed when the current candle crosses under Tenkan-sen, Kijun-sen or Kumo. This means that all of open, close, high and low must be below the selected item. Alternatively, you can set a ROE target for closing a position.

A short position is closed when the current candle crosses over Tenkan-sen, Kijun-sen or Kumo. This means that all of open, close, high and low must be above the selected item. Alternatively, you can set a ROE target for closing a position.

You can configure which of the three items is used for closing a position, with TENKAN_CLOSE, KIJUN_CLOSE, KUMO_CLOSE or ROE_CLOSE. If multiple of these parameters are set to true, the first of which occurs will close the position.

Stop

A long position is stopped when the current candle crosses under Tenkan-sen, Kijun-sen or Kumo. This means that all of open, close, high and low must be above the selected item.

A short position is stopped when the current candle crosses over Tenkan-sen, Kijun-sen or Kumo. This means that all of open, close, high and low must be over the selected item.

You can configure which of the three items is used for stopping a position, with TENKAN_STOP, KIJUN_STOP or KUMO_STOP. If multiple of these parameters are set to true, the first of which occurs will close the position. Make sure to use different lines for closing and stopping a position.

After a stop is hit, the "alert" conditions for a long or short must happen again before another position is opened.

Strategy parameters

Following settings options are available for ichimoku and can be set in the strategy configurator of the GUI or the strategies section of the config.js file.

These settings are global and apply to all pairs running this strategy. When you want a specific parameter to be different for one or more pairs, use an override at the pair level.

Using the BUY_METHOD and SELL_METHOD parameters you can combine different methods for buying and selling. This strategy page assumes both BUY_METHOD and SELL_METHOD are set to ichimoku. Accepted values are all strategy names as listed here.

Margin settings

Margin settings control settings like leverage and the target for ROE. These parameters are relevant when using ichimoku as buy and/or sell method.

ROE

This sets the target for closing a position.

ROE is the Return On Equity for a position, the percentage profit and loss on your invested margin. This value is calculated in a similar way to how Bitmex calculates it, it does include leverage and does not include fees.

Examples: Long position, 1x leverage. When price moves 1% above the average entry price, 1% ROE is reached.

Long position, 100x leverage (or cross leverage). When price moves 1% above the average entry price, 100% ROE is reached.

Short position, 20x leverage When price moves 1% below the average entry price, 20% ROE is reached.

Values: numerical – represent a percentage.

Default value: 1

Parameter name in config.js: ROE

Leverage

Sets the leverage for opening any position. Setting 0 places the order with cross margin.

Values: numerical

Default value: 0

Parameter name in config.js: LEVERAGE

Stop Buy

Places a market stop order for a long position, at the same time as the position is opened.

When set to 1 and a long order is opened at a price of 100, a stop market order will be placed at 99.

Values: numerical - represents a percentage.

Default value: 0

Parameter name in config.js: STOP_BUY

Stop Sell

Places a market stop order for a short position, at the same time as the position is opened.

When set to 1 and a short order is opened at a price of 100, a stop market order will be placed at 101.

Values: numerical - represents a percentage.

Default value: 0

Parameter name in config.js: STOP_SELL

ROE Trailing

Use this to enable tssl-style trailing for ROE.

Values: true or false

Default value: false

Parameter name in config.js: ROE_TRAILING

ROE Limit

This sets the range for ROE trailing.

Setting a range of 5% at a ROE target of 1 would set an initial range between 0.95 and 1.05.

As long as ROE keeps increasing, the range moves along with ROE. As soon as ROE start decreasing, the lower range gets frozen. A close order is placed when ROE crosses the lower limit.

Values: numerical – represent a percentage of ROE.

Default value: 1

Parameter name in config.js: ROE_LIMIT

Pre Order

When set to true, limit orders will placed at a configurable rate beyond the best bid/ask price to get ahead of the order book.

Values: true or false

Default value: false

Parameter name in config.js: PRE_ORDER

Pre Order Gap

Sets the gap between the best bid/ask price in the orderbook and the rate at which a limit order gets placed. Long orders are placed at ask + gap. Short orders are placed at bid - gap.

It is possible to use negative values, this will increase the chance of receiving maker fees.

Example when set to 1 and a buy signal occurs at an ask price of 100: a limit order gets placed at a rate of 101. When set to -1 and a buy signal occurs at an ask price of 100: a limit order gets placed at a rate of 99.

Don't use a negative gap together with STOP_BUY and/or STOP_SELL, as these stops do not combine well with position that do not always fill.

Values: numerical - represents a percentage.

Default value: 0

Parameter name in config.js: PRE_ORDER_GAP

Buy settings

Buy settings are the primary trigger for opening long positions. These parameters control the execution of buy orders when using ichimoku as buy method.

Buy enabled

Set this to false to prevent Gunbot from placing buy orders.

Values: true or false

Default value: true

Parameter name in config.js: BUY_ENABLED

NBA

"Never Buy Above". Use this to only allow buy orders below the last sell rate.

This sets the minimum percentage difference between the last sell order and the next buy. The default setting of 0 disables this option.

When set to 1, Gunbot will only place a buy order when the strategy buy criteria meet and price is at least 1% below the last sell price.

Values: numerical, represents a percentage.

Default value: 0

Parameter name in config.js: NBA

Sell settings

Sell settings are the primary trigger for opening short positions. These parameters control the execution of sell orders when using ichimoku as sell method.

Sell enabled

Set this to false to prevent Gunbot from placing sell orders.

Values: true or false

Default value: true

Parameter name in config.js: SELL_ENABLED

Indicator settings

Relevant indicators for trading with EMA spread.

These settings have a direct effect on trading with ichimoku.

Period

This sets the candlestick period used for trading, this affects all indicators within the strategy.

Only use supported values.

Setting a short period allows you to trade on shorter trends, but be aware that these will be noisier than longer periods.

Values: numerical– represents candlestick size in minutes.

Default value: 15

Parameter name in config.js: PERIOD

Tenkan Period

Set this to the number of candlestick periods you want to use for calculating Tenkan-sen.

Values: numerical, represents a number of candlestick periods.

Default value: 9

Parameter name in config.js: TENKAN_PERIOD

Kijun Period

Set this to the number of candlestick periods you want to use for calculating Kijun-sen.

Values: numerical, represents a number of candlestick periods.

Default value: 26

Parameter name in config.js: KIJUN_PERIOD

Senkouspan Period

Set this to the number of candlestick periods you want to use for calculating Senkou span.

Values: numerical, represents a number of candlestick periods.

Default value: 52

Parameter name in config.js: SENKOUSPAN_PERIOD

Displacement

Set this to the number of candlestick periods you want to use for displacing Kumo and Chikou-span.

Values: numerical, represents a number of candlestick periods.

Default value: 26

Parameter name in config.js: DISPLACEMENT

Kumo Close

Enable this to close a position when the current candle moves completely below (long) or above (short) Kijun-sen.

Do not enable multiple close triggers.

Values: true or false

Default value: false

Parameter name in config.js: KUMO_CLOSE

Tenkan Close

Enable this to close a position when the current candle moves completely below (long) or above (short) Tenkan-sen.

Do not enable multiple close triggers.

Values: true or false

Default value: true

Parameter name in config.js: TENKAN_CLOSE

Kijun Close

Enable this to close a position when the current candle moves completely below (long) or above (short) Kijun-sen.

Do not enable multiple close triggers.

Values: true or false

Default value: false

Parameter name in config.js: KIJUN_CLOSE

ROE Close

Enable this to stop a position when ROE is reached.

Do not enable multiple close triggers.

Values: true or false

Default value: false

Parameter name in config.js: ROE_CLOSE

Kumo Stop

Enable this to stop a position when the current candle moves completely below (long) or above (short) Kumo.

Do not enable multiple stop triggers.

Values: true or false

Default value: true

Parameter name in config.js: KUMO_STOP

Tenkan Stop

Enable this to close a position when the current candle moves completely below (long) or above (short) Tenkan-sen.

Do not enable multiple stop triggers.

Values: true or false

Default value: false

Parameter name in config.js: TENKAN_STOP

Kijun Stop

Enable this to stop a position when the current candle moves completely below (long) or above (short) Kijun-sen.

Do not enable multiple stop triggers.

Values: true or false

Default value: false

Parameter name in config.js: KIJUN_STOP

Ichimoku Protection

Enable this to only allow trades when they are confirmed by the cloud. Set this to false to ignore Kumu trends.

When enabled, buy orders can only happen above Kumo, sell orders can only happen below Kumo.

Values: true or false

Default value: true

Parameter name in config.js: ICHIMOKU_PROTECTION

Balance settings

Confirming indicators + advanced indicator settings

Misc settings

Dollar cost avg settings

DCA is not intented to be used for margin trading.

Reversal trading settings

RT is not intented to be used for margin trading.

TrailMe settings

TrailMe is not intended to be used with this strategy.

Placeholders

The following parameters in config.js have no function for this strategy and act as placeholder.