hamster-bot

RU EN PT

Strategy Trend Zig Zag (zigzag, selected by default when a bot is created) - a simple version with a minimum of settings, the counterpart of the «Simple trend strategy» script on TradingView. Levels are built the same way as in ZZ2, and the position is flipped by stop orders. The modifiers and filters from the «Parameters and modifiers» block are not used in it.

• length - reversal search depth (default 5)
• detection - length of the smoothing EMA (default 3)

ZZ (zz) - the full version: two level types (ZZ2 and ZZ6) and all the modifiers, filters and position size settings described below.

ZZ2 (default) - levels are built from the reversal points of the smoothed price. The algorithm is explained in detail in the «For the curious» block.
depth - reversal search depth (default 5)
detection, detection_type, detection_source - length, type (EMA by default) and price source of the smoothing line whose reversals define the points
rsi_len, rsi_value - an additional RSI condition for a reversal point. Not used when rsi_value = 0

ZZ6 - levels are built from two high/low channels: a fast one of length zz6_len and a slow one of length zz6_len_slow (if not set, zz6_len * 3). A level is fixed when the fast and slow channels coincide (the price made a new extreme) and the fast channel starts to turn.
In ZZ6 the position size depends on risk: the wider the distance between levels (and so the farther the stop), the smaller the lot.

• zz6_risklong, zz6_riskshort - risk per trade in %. Lot = base lot * (risk % / distance between levels in %)
• zz6_risk_one - use the same risk for short as for long (zz6_risklong)
• zz6_risk_max - upper limit for this lot multiplier

Operating mode

• reverse - reverse (counter-trend) mode. When the upper level is broken the bot opens a short, when the lower level is broken - a long. Orders in this mode are market orders
• always_in_position - if there is no position and the price has already moved beyond a level (for example after closing by stop or take profit), the bot enters immediately with a market order in the direction of the breakout
• one_entry_long, one_entry_short - one entry per new level. If the position from a level has already been closed (for example by take profit or stop), the bot does not enter again on the same level
• single_entry - strengthens the previous option: the ban on re-entry is lifted not by a new level but only after an entry in the opposite direction

Level settings

• level_offset_long, level_offset_short - shift the level by a fixed price amount
• level_multiplier_long, level_multiplier_short - shift the level in percent. 1 - no shift, 1.01 - 1% higher
• angle_long, angle_short - level slope. The level is multiplied by this value on every new candle and gradually moves toward the price. 1 - a horizontal level

Entry filters

When a filter blocks an entry, the bot does not open a new position, but the order to close the current position at the opposite level stays in place.

• use_distance_filter, distance_filter - do not enter if the distance between levels is greater than the given % (the stop is too far)
• use_flat_filter, flat_filter - do not enter if the distance between levels is less than the given % (a sign of a sideways market)
• use_narrowing - trade only when the levels are narrowing: the last high is lower than the previous one and the last low is higher than the previous one
• use_ma_filter, ma_filter - do not flip if the fast MA has already moved away from the slow MA by more than the given % against the new direction
• use_ma_distance_filter, ma_distance_filter - do not enter if the fast and slow MAs are closer to each other than the given % (no momentum)
• ma_fast_*, ma_slow_* - type, length and source of the fast and slow MA for the two filters above
• filter_only_open - the distance filters apply only to opening a position; flipping from an already open position is allowed
• Trend filter (the filter block, shared by ZZ and HiDeep) - see the «Position closing and common options» section

Position size

• use_auto_risk - auto risk for ZZ2. The lot multiplier changes smoothly from auto_risk_coeff_start to auto_risk_coeff_end depending on the distance between levels: from auto_risk_procent_start to auto_risk_procent_end %. A narrow channel means a bigger lot, a wide one a smaller lot
• count_pnl_profit, count_pnl_loss - on a flip, add the profit or loss of the current position to the size of the new one
• size_control - protection against doubling: if the position accidentally becomes larger than two entries, the excess is closed with a market order

Position closing

• use_tp_between_levels, tp_between_levels_value - close the position in profit if the price has returned inside the channel between the levels and the profit is at least the given %
• stop_by_new_level - stop at a new level. If after entry the price broke a new level in the direction of the position and then came back to it, the position is closed
• close_on_wrong_side - close the position if the price has gone beyond the opposite level by more than 1% (for example the stop order did not trigger because of a gap)
• use_close_on_levels_crossing - close the position if the levels have crossed (the upper one became lower than the lower one)
• from_level_price - calculate take profit and minimum profit from the level price instead of the actual entry price

A PineScript script for testing the strategy on historical data in the TradingView strategy tester:

Links:
• A simple trend strategy with a minimum of settings
• hamster-bot-ZZ

Recommendations: (not strict, you can break them for research purposes)
Working timeframe: 4h and higher.

The level-building algorithm of the ZZ2 strategy. It does not use the standard ZigZag indicator. The code shows how simple it is and that repainting is ruled out. But the levels are built with a delay of a few candles (this does not hurt the strategy at all)

Three sequentially smoothed EMAs are used. This gives strong smoothing and reduces noise.
The variable z records reversal points. If the EMA turns up → a local low (l) is taken. If it turns down → a local high (h). These points (l and h) become the basis for building the levels.

• long_length, long_detection - reversal search depth and EMA length for the long level (default 5 and 3)
• short_length, short_detection - the same for the short level (default 5 and 3)

ZZ-Double-Market-Filter only

• screener_up_threshold_pct, screener_bars_back - screener signal: the price has risen by the set % from the lowest close of the last screener_bars_back candles (default 5% over 3 candles). 0 - the screener never triggers
• screener_use_24h_vol_filter, screener_min_24h_vol_usdt - additionally require a 24h turnover of at least the set amount in USDT (default 1 000 000)
• screener_use_vol_growth_filter, screener_vol_growth_candles, screener_vol_growth_threshold_pct - the current candle's volume must exceed the lowest volume of N candles by the set % (default 15 candles, 50%)
• screener_use_low_filter - enter long only if the current candle touched the level
• use_tema_filter, tema_length, tema_src - TEMA trend filter (default 200, close): long only when TEMA is rising, short only when it is falling

When the screener triggers, the "gate opens" for the bot and one trade on ZigZag signals is allowed. After that trade closes, the gate closes until the next screener signal.

• channel_len - channel length in candles (default 25)
• use_tp, tp - enable the take-profit and its offset in % from the channel border (default 10%)
• If the price has moved beyond the opposite channel border by more than 1%, the position is closed with a market order (protection against gaps)

The script code (PineScript) for the TradingView strategy tester "[TV] Donchian Channel" is available in the bot interface on the strategy page.

• len - channel length in candles (default 10)
• If the price has moved beyond the opposite channel border by more than 1%, the position is closed with a market order

• slow_channel_len - length of the slow channel whose borders are used for entry orders (default 50)
• fast_channel_len - length of the fast channel whose middle is used for the protective close (default 25)
• risk_long, risk_short - risk per trade in %
• risk_max - maximum lot multiplier, so that the position does not get too big on a very narrow channel
• level_offset_long, level_offset_short - shift of the entry levels by a fixed amount in price

Moving Average Crossover

• fast_ma_type, fast_ma_source, fast_ma_len - fast MA (default EMA, close, 9)
• slow_ma_type, slow_ma_source, slow_ma_len - slow MA (default EMA, close, 21)

Price vs MA

• ma_type, ma_source, ma_len - MA (default SMA, close, 200)
• use_cross_entry - enter only at the moment of the crossover (default). If off - enter on any candle when the price is above the MA (long) or below it (short)

MACD Trend

• ma_source, fast_len, slow_len, signal_len - price source and EMA lengths for MACD (default close, 12, 26, 9)
• use_trend_filter - long only in an uptrend, short only in a downtrend. Works together with the enabled trend filter block filter (see "Trend filter")

Common to all three

• count_max - maximum number of entries into the position, including the first (default 1 - no adding). Adding happens on a repeated signal in the same direction (in Price vs MA - only with use_cross_entry off)
• entry_gap - minimum step for adding: the next entry only if the price is below the previous entry price * entry_gap (for long; mirrored for short). For example 0.98 - no closer than 2%. 0 - no limit

The strategy runs two bots - one for each coin of the pair. The levels are built on the synthetic price ratio chart and calculated with the settings of the first bot.

• index - which coin of the pair this is: 1 - numerator (XXXUSDT), 2 - denominator (xxxusdt)
• strategy - which levels to trade the synthetic chart on: zigzag (default) or donchian
• zigzag - ZigZag settings block: length, detection, detection_source (as in Strategy Trend Zig Zag)
• donchian - Donchian channel settings block: channel_len, use_tp, tp, detection_source (as in Donchian Channel)
• reverse - reverse mode: trade directions are swapped

Script (PineScript) for testing the strategy on historical data in the TradingView strategy tester:

Link:
• A simple trend strategy with a minimum of settings

But as the input in the strategy tester we choose a synthetic chart instead of a single trading pair.
The synthetic ratio chart BYBIT:XXXUSDT.P/BYBIT:xxxusdt.P (where XXX is any cryptocurrency priced higher than xxx)

Strategy tester result for 2025, BYBIT:ETHUSDT.P/BYBIT:APTUSDT.P on the 1D timeframe:

There can be several opening lines for each side (ma_long, ma_short) - this gives a grid of orders with averaging in (MultiMA). There is one closing line for each side (ma_close_long, ma_close_short) - the whole position is closed with one order.

• id - line sequence number, no repeats
• type - moving average type SMA, EMA, GMA, HARMONIC, TEMA, DEMA, ZLEMA, WMA, VWMA, RMA, EHMA, THMA, HMA, DMA, ATR, H, L
• source - price source open, high, low, close, hl2, hlc3, ohlc4, hlcc4, oc2
• len - MA length
• multiplier - offset. 1 means no offset, 0.99 means -1%, 1.01 means +1%
• lot_x - lot multiplier: order size = base lot * lot_x. Not used for the closing order
• order_type - limit or market. A market order is sent when the price reaches the line
• post_only - limit order as maker only
• hidden - hidden limit order (BitMEX only)

Lot setup. In the basic settings set balance_percentage = 100 and risk = 1. Then lot_x = 1 - an order for 100% of the balance, 0.5 - for 50%, 1.5 - for 150%.

• entry_on_close - for market opening orders: check the entry condition against the last candle's close price instead of the current price
• trade_offset - for market opening orders: take the MA value N candles back
• reverse_mode - for market opening orders: enter not when the price crosses the line, but when the price is above the line (for a buy) or below it (for a sell), no further than 1% from it
• recalculate - recalculate order sizes on every update, even if a position is already open
• close_on_signal - starting from the second candle after entry, close the position with a market order as soon as the price touches the closing line
• close_on_wrong_side - if the price has moved beyond the closing line by more than 0.5% and the limit order was not filled, close the position with a market order
• emergency_stop - emergency stop: if the opening line ends up on the other side of the closing line (the lines crossed), the bot cancels all orders and closes the position
• notification_trade_report - a Telegram report for each closed trade: average entry price, exit price and the result in %
• position_priority - position priority for the position limiter (see below)

The limiter is set for an API key with the "open_positions_limiter": 64 parameter in the key file in the settings_account folder. Default 0 - off. Only MRS bots whose position_priority is not 0 take part in the limiter.

• position_priority from 1 to 5. 5 is the lowest priority, such a position closes first
• If there are as many open positions as set in the limiter, opening orders are cancelled on pairs without a position - no new positions are opened
• If more positions opened than the limit (for example at the same time), the extra ones are closed: first with priority 5, then 4, 3, 2, 1. With equal priority - a random one
• Positions with priority 0 are not counted and not closed by the limiter

In the interface the limiter is shown like this: [100 | (4/64)] - 100 bots on this API, 4 positions open, limit 64.

The same open_positions_limiter parameter also limits the HiDeep, RedFlag, SmartProfit and ShadowOverlap strategies: when there are as many open positions on them as the limit, bots without a position do not open new trades. Priorities are not used for them.

A closing option that turns MRS into ColorBox: the position closes at the close of the N-th candle after entry. You can add a candle color condition, for example close after the 2nd green candle. Set separately for long and short. Details are in the "Position closing and common options" section.

Script (PineScript) for testing the strategy on historical data in the TradingView strategy tester. The strategy is popular, and you can find many variations under different names.

Links:
• A simple version of the strategy with a minimum of settings. I recommend starting with this script.
• A script with a large set of parameters that can be reproduced in the trading bot.
• A script that can place many opening orders (increasing the position | averaging in).

Recommendations: (not strict, you can break them for research purposes)
● A limit order limits the strategy's capacity. On low-liquidity instruments the tester result will be overstated.
● On spot, test long only. Long and short at the same time is for experienced users.
● On futures a counter-trend strategy carries a liquidation risk.
● Typical timeframe - 1h. Altcoin/bitcoin or altcoin/altcoin pairs.

• ma_long, ma_short, ma_close_long, ma_close_short - opening and closing lines. Configured the same way as lines in MRS
• use_settings_from_open_long, use_settings_from_open_short - build the closing line with the type, source and length of the opening MA (the offset is taken from the closing line)
• distance_filter - minimum distance in % between the opening and closing line (default 0.3). If closer, orders are cancelled (the potential profit is too small)
• filter_pump_1 - post-pump filter. When the price (source) crosses the closing line upwards, the level of that line offset candles back is remembered. While the buy line is above this level, the bot does not buy
• filter_pump_2 - sharp rise filter. If over the last count candles the high is value times bigger than the low and the high came after the low, trading is paused
• filter_close_position - when a filter triggers, not only cancel orders but also close the open position
• unconditional_placement - always place orders, without checking the relative position of the lines
• allow_close_by_market_order - if the whole candle went above the closing line and the limit order was not filled, close the position with a market order
• only_profit - do not move the closing order below the entry price (for long) - close only in profit
• replace_open_order - with an open position, the size of the opening order is reduced by the position size
• cancel_if_half_filled - if the opening order is partially filled and the remaining part is less than twice the position, it is cancelled

• ma_long, ma_short - lists of opening lines. Configured the same way as in MRS (id, type, source, len, multiplier, lot_x, order_type, post_only, hidden)
• ma_close_long, ma_close_short - one closing line per side
• distance_filter, filter_close_position, unconditional_placement, allow_close_by_market_order, only_profit - as in MRS2
• replace_open_order - with an open position, the position is spread across the grid levels starting from the one nearest to the price: filled levels are not re-placed, a partially filled level gets the remainder, untouched ones get the full lot
• use_id_tracking - track grid orders by ID (no more than one request to the exchange per pass). Useful when the exchange limits request rates
• notification - a Telegram report for each closed trade: entry price, exit price and the result in %

A buy signal (green ▲) appears on a candle that at the same time:
● is red (closed below its open)
● has its body below the body of the previous candle
● has a deviation of the close price from the SMA larger than the average deviation over recent candles (the move is "overloaded")
● has a fast RSI below 10 (strong short-term oversold)
A sell signal (red ▼) is the mirror: a green candle, body above the previous one, a strong upward deviation, fast RSI above 90.

Signals are calculated with two independent sets of settings, and either one triggers. In addition, the close price must be below the MA low line (for a buy) or above MA high (for a sell).

MA lines

• ma_low_*, ma_high_* - type, length and source of the entry filter lines. ATR can be used instead of an MA
• ma_low_1, ma_high_1 - offset of the filter lines. 0.995 - 0.5% lower, 1.011 - 1.1% higher
• ma_high_trigger_*, ma_low_trigger_* - closing trigger lines: long closes when the candle High is above ma_high_trigger, short when the Low is below ma_low_trigger

Signal

• up_1, dn_1, mac_1, sma_1, sma_up_1, sma_dn_1 - first set: fast RSI length up/down, SMA length for the deviation, deviation averaging length, threshold multipliers
• up_2 ... sma_dn_2 - second set with the same parameters

Averaging in and closing

• count_max_long, count_max_short - maximum number of entries into the position, including the first (default 5)
• entry_gap - minimum averaging step: the next buy only if the price is below the previous buy price * entry_gap. For example 0.98 - no closer than 2%. 0 - no limit
• only_profit, min_profit - close on the trigger line only in profit. min_profit - multiplier to the entry price, e.g. 1.01 - profit of at least 1%
• allow_reduce - close the position on the opposite signal (for long - on the red ▼)
• reduce_ma_1 - close on the opposite signal only if the price is beyond the opposite MA line
• allow_reverse - on the opposite signal, reverse the position instead of just closing it

Modes

• use_pdd - inverted mode: buy on an overbought signal above the MA high line, sell on an oversold signal below MA low. The strategy becomes a momentum strategy
• disable_trade_on_reverse_trend - with the trend filter enabled, do not open trades on the candle where the trend changed
• use_auto_size_hedge, auto_size_hedge_ratio - automatic size for hedging. The entry size depends on the total size of trend positions of other bots on this account: the more trend shorts, the bigger the HiDeep buy, and vice versa
• delay - pause between checks in ms (at least 3000)

The bot starts trading only when enough candles are loaded to calculate the indicators. With the trend filter enabled, at least 500 candles are needed.

Scripts (PineScript) for testing the strategy on historical data in the TradingView strategy tester. The hamster-bot-HiDeep script contains three different variants of the strategy - pick the one you need with a preset in the settings.

Links:
• hamster-bot-HiDeep strategy
• HD simple v5

• drop_percent - how many % the price must drop to enter (default 10%)
• from - which price of the previous candle to measure the drop from: open, high, low, close
• count - maximum number of entries, including the first
• timer - minimum pause between entries in minutes. 0 - no pause
• each_tp - each entry gets its own limit take-profit at take_profit_long % from that entry's price. Without this option there is one take-profit for the whole position

• take_profit - take-profit in % of the average position price (default 2)
• averaging - averaging levels in % below the first entry price, separated by semicolons (default 3;6;9)
• martingale - lot multiplier for each next averaging order (default 1 - all orders the same size)
• filter_bb - Bollinger Bands filter: use, len, type, source, std_dev, condition - which line the price must be below: upper, basis or lower
• filter_ma - MA filter: use, type, len, source, multiplier. Buy only when the price is below MA * multiplier
• filter_max_price - do not buy above this price. 0 - off
• only_exit - exit mode: no new cycles are opened, the bot only closes the current position
• trade_on_exit_bar - allow a new entry on the same candle where the previous position closed (on by default)

Settings are set separately for the short and long blocks:

• percent_input - minimum wick length in % of the price at the edge of the candle body (default 5)
• wick_level_percent - at which part of the wick the entry level is built: 0% - edge of the body, 100% - end of the wick (default 90)
• size_candle - enter only if the distance between the level and the current price is more than the set % (default 7)
• days_to_wait - how many days must pass after the level appears before it can be traded (default 1)
• use_new_filter, wick_level_percent2 - trade only a "fresh" level: if the price has already reached the wick_level_percent2 % level of the wick (default 20), the level counts as used up
• tp1_dist, tp1_qty - first take-profit: distance in % from the entry price and share of the position in % (default 4% and 70%)
• tp2_dist, tp2_qty - second take-profit (default 6% and 15%)
• tp3_dist - final take-profit for the rest of the position (default 9%)
• sl_dist - stop-loss in % of the entry price (default 18)
• no_loss_trigger, no_loss_value - breakeven: when the profit reaches no_loss_trigger %, the stop is moved into profit by (no_loss_trigger - no_loss_value) %. 0 - off

Common settings:

• use_market - enter with a market order when the price reaches the level (default). If off, a limit order at the level is placed in advance when the price comes closer than size_candle %
• notify_only - signal mode: the bot does not trade, it only sends entry and exit notifications to Telegram

• fast_len, slow_len - lengths of the fast and slow signal lines (default 300 and 600)
• averaging_step - averaging step in % of the first entry price (default 2.5)
• max_entry_count - maximum number of entries, including the first (default 3)
• lot_x - lot multiplier for each next averaging order (default 1)
• tp_long, tp_short - take-profit in % of the average position price (default 10)

• channel_size - channel size in price units (default 10000 - adjust it to the coin price)
• mul_trigger - trigger level: fraction of the channel from the local low (default 0.1)
• mul_limit_1 - level of the limit entry order (default 0.05)
• mul_tp_1 - take-profit level (default 0.5)
• mul_control - control level: if the price reached it and came back to the entry level, the position is closed (default 0.25)
• mul_sl - stop-loss: offset from the local low as a fraction of the price (default 0.001 = 0.1%)
• martingale - lot multiplier after a losing trade (default 1 - off)

• delay_bars - pause in candles between closing a position and the next entry (default 0)
• use_smart_close - smart close: enables the parameters below
• tp_pct, sl_pct - close earlier on a profit or loss in % of the entry price. 0 - off
• max_daily_loss_pct - stop trading until the end of the day (UTC) if the balance has dropped by more than the set % of the balance at the start of the day. 0 - off
• threshold_profit - profit threshold. 1 - off. Above 1 (e.g. 1.01) - close only with a profit of at least 1%. Below 1 (e.g. 0.98) - do not close if the loss is more than 2%