Skip to main content
All CollectionsBots (Signal/DCA/Grid)Signal bot
Signal Bot: Custom Signal - Using the New Creation Form (Beta Mode ON)
Signal Bot: Custom Signal - Using the New Creation Form (Beta Mode ON)

Discover the revamped Signal Bot with a user-friendly single-page design, improved usability, and enhanced features for seamless setup!

Updated over 2 weeks ago

The Signal Bot has been revamped to provide a better user experience with a one-page launcher, streamlined bot creation process, and added features. These updates align with the familiar design and functionality of the DCA Bot, ensuring consistency across 3Commas tools. Learn how to use the new Signal Bot interface and take advantage of its enhanced capabilities.


How to Enable the New Signal Bot View

To access the new Signal Bot creation form, Beta Mode must be enabled:

  1. Go to the Settings page.

  2. Toggle on the Beta-testing mode for the Signal Bot.

Once enabled, you’ll see the new Signal Bot interface when creating or managing your bots.


I. Where to find the new Signal bot creation form?

Fast way

Click on the "+ Start new bot" button at the top right corner of the screen and choose Signal bot:

or

Click on the "+" button beside the "Signal bot" to create the bot right away:

or

1. Go to the Signal bot page

2. Click on "Create Signal Bot"

3. Here is what the launcher looks like


II. Creating a Signal bot

Main

Here you can choose the Alert type, give your bot a Name and choose the Exchange.

Alert Type

  • Custom Signal: This option allows you to configure the bot to respond to custom trading signals sent from any external source as a webhook message.

  • TradingView Strategy: Enables automated trading rules using Pine Script from TradingView.

Pay Attention!

In Custom Signal mode, the bot filters signals based on its settings. It cannot accept a Short signal if only Long settings are enabled, and vice versa—the bot will ignore such signals.

Name

A unique and practical name is very useful if you have many bots.

Exchange

Available on Demo account and all exchanges except Binance TR and Gate.io USDT-M.

Direction

Defines the bot's trading strategy:

  • Reversal: Allows both Long and Short trades.

  • Long: Only opens Long trades.

  • Short: Only opens Short trades.

  • For Futures: You can create both long and short strategies using a single bot. If Hedge Mode is enabled on your exchange account, the bot can operate simultaneously in both directions. However, if Hedge Mode is disabled, you can only trade in one direction or opt for a Reversal strategy.

Pairs

Choose the trading pair(s) the bot will operate with.

  • For short strategy on Spot, you can only work with one Base currency to all quotes (e.g. short XRP to BTC, BNB, USDT, ETH, EUR, etc.)

  • Only one pair is available in Reversal mode

Leverage (For Futures)

Choose the leverage type and its value. If the bot is multi-pair, the maximum leverage can only be the lowest maximum among the pairs. For example, if you choose BTC and BNB contracts on Binance Futures, you will be able to set the maximum leverage at x50 as per BNB contracts, not x125 as it is for BTC contracts.

Max. Investment

The amount of funds in absolute amount or in % from the total balance the bot or the SmartTrade can use.

For Futures: Set the Max. initial margin - the amount of funds in absolute amount or in % from the total balance the bot or the SmartTrade can use (leverage is not applied in this field).

Single Pair:

Multi-Pair:

...per Bot

This setting allows you to specify the maximum amount of investment that the bot can use. If the bot reaches this level, further signals will be rejected. This is useful if you are trading a single pair and do not want to exceed a certain investment limit.

Please note:

  • When trading on a Futures or Margin account, the actual used amount by the bot is calculated as the amount in this field multiplied by the leverage size.

  • When the bot reaches the limit, subsequent signals will be rejected and marked as "Rejected" in the logs.

...per SmartTrade

This setting limits the maximum amount for each individual SmartTrade created by the bot. This is especially useful if you have Multi-pairs in the bot and want to ensure that each SmartTrade for a separate pair does not exceed the specified limit.

Please note:

  • The value entered in this field is multiplied by either the number of selected pairs or the number specified in the "Max. Active SmartTrades" setting.

  • For Futures or Margin accounts, the total used amount is further multiplied by the leverage size, in addition to the number of selected pairs or the "Max. Active SmartTrades" setting.

  • When the bot reaches the limit, subsequent signals will be rejected and marked as "Rejected" in the logs.

Max. active SmartTrade

Available only if you choose more than 1 trading pair. This setting limits the number of simultaneously active SmartTrades, helping to manage risks if the bot is configured to work with a large number of pairs, but you want to restrict its activity.

Please note the following:

  • This number limits the number of active SmartTrades created by the bot. If some trades close, the bot will be ready to open new ones until it reaches the limit again.

  • This functionality is useful for managing risks if, for example, you have a bot configured for 200 pairs but want it to actively work on only a certain number of pairs, say 50.

  • When the bot reaches the limit, subsequent signals will be rejected and marked as "Rejected" in the logs.


Order Settings

Entry Order

Volume per order - You can choose from the following options:

  • Total investment, % - you can choose how much of the Total Investment will be used in the signals.

  • base - you can enter the amount of BASE currency for the order size. For Futures, you can put here the amount of contracts that you want to use as an order size.

  • quote - you can enter the amount of QUOTE currency for the order size.

  • Send in webhook, % - in this case, the size of the order in % of Total investment will be sent with the webhook signal.

  • Send in webhook, quote/base - the size of the order in QUOTE or BASE currency will be sent with the webhook signal.

Order Type - If you choose the "Send in webhook..." type of the order size, you can now choose whether it's going to be a Limit order or a Market order:

Market:

Limit:

These options apply to Entry orders, whether they open a new position or add funds to an existing position.

Whether you choose Market or Limit, the JSON message will change relatively for your convenience. However, you can still change it according to your desires and preferences.

For example, you can type

"order_type": "market" - this will execute the order at the market price;

or

"order_type": "limit" - this will let you place the order at the specific price.

Thus, you can specify the price. Here is what it looks like:

{ 
...
"price": 10.0
}

Webhook message for entry order signals - this message can change depending on the Order size type you chose from the previous step. You will need to paste it into the TradingView alert. Copy this message before proceeding. Read more what this JSON file consists of here: Signal bot: JSON file in Custom signal type

Price deviation from the same order in the past – If enabled, the bot will only process a new signal if the current price deviates from the price of the previous executed signal of the same type (e.g., Entry signal to Entry signal, Exit signal to Exit signal).

Price deviation from average entry price - if enabled, the bot won't process with the new signal if the current price does not deviate from the average entry price.

Reset price deviation for a new SmartTrade - Enable this option to reset the price deviation filter values after each SmartTrade closes. This ensures that subsequent trades are not influenced by previous price deviations. This setting is available for Futures markets, applicable to Entry long and Entry short orders, and supports both single and multi-pair bots.

About the value of price deviation.

If you use deviation in Enter Long & Exit Short, the deviation should be with negative value, like -1%. In this case, the next signal will be executed if the price of this signal is lower at least 1% than the last or average price. If you enter here the positive value, like 5%, then the next signal will be processed if the price of the signal is HIGHER (not lower) for at least 5% from the last or average price.

The opposite is with Enter Short & Exit Long signals - the deviation should be with positive value, like 1%. In this case, the next signal will be executed if the price of this signal is higher for at least 1% than the last or average price. If you enter here the negative value, like -3%, then the next signal will be processed if the price of the signal is LOWER (not higher) for at least 3% from the last or average price.

Max. number of entry orders per SmartTrade - a limit on the number of orders for each SmartTrade.

More about Max. number of entry orders per SmartTrade.

This setting defines the maximum number of orders that the bot can add to a single trade. It is useful if your strategy requires limiting the number of additional orders.

For example, if your strategy dictates that the bot should create a SmartTrade based on a signal and add no more than 4 Safety Orders, you should set the "Max. number of entry orders per SmartTrade" to 5. This number includes one order for opening the SmartTrade and 4 additional orders. This way, you can effectively control the number of orders and manage risks in each SmartTrade. Please note the following:

  • This limit includes both the initial order and any additional orders.

  • If the bot opens a SmartTrade and you manually add additional orders using the "Add Funds" button, this will also count towards the total order limit. If needed, you can edit the bot to increase or decrease the number of orders.

  • Even if the order limit is reached, users will still be able to manually add orders to the SmartTrade using the "Add Funds" button.

  • When the bot reaches the limit, subsequent signals will be rejected and marked as "Rejected" in the logs.

Exit Order

Set up the Exit Long signal if needed. For Exit signals, the price deviation is reset by default after each SmartTrade closure. No additional configuration is required for this behavior.

Take Profit

Set up the built-in Take profit if needed. If you don't need a Take profit or have an Exit Signal, you can just click on Start to proceed.

Remember if you use Signal bots on Spot market!

If the trade is Long, the profit will be taken in QUOTE currency; for example, using the BTC/USDT pair, the profit will be USDT. If the trade is Short, the profit will be taken in BASE currency; for example, using the BTC/USDT pair, the profit will be BTC.

Here you can set:

  • the order type (Limit or Market);

  • the take profit percentage;

  • multiple take profit targets (or multiple targets);

Few words about multiple take profit tool

  • Using this tool, you can set up to 4 take profit targets with different prices and sizes (or up to 8 targets via 3Commas API).

  • By default, the difference in take profit prices is 1%.

  • By default, when you add another take profit target, the size of the assets will be equally distributed between each target. If you change the size of one target, the remaining size will also be distributed among the rest of the targets. But if you change the size of another target, you will need to change the rest of the targets manually.

  • If the sum of the parts will be less than 100% you will receive an error like this:

    So ensure the full 100% amount of assets is spread between all targets.

  • If you choose Limit type of order and enable Trailing feature, the last target will become Market order, and other Take profit targets will be Limit orders.

Stop Loss

You can enable the Trailing Stop loss feature if you want.

Also, now you can enable the Move to Breakeven option.

Reversal Mode

In Reversal mode, you will see both Long Order Settings and Short Order Settings that you can configure at the same time.

Reverse Position

The Reverse Position trading style is available when both Long Entry Order and Short Entry Order signals are configured.

Spot Accounts

  • Reverse Position Disabled:

    • If there is an active Long trade, the "Entry Short" signal will be ignored unless the Long trade is fully closed and no active Long trades remain.

    • Similarly, if there is an active Short trade, the "Entry Long" signal will be ignored unless the Short trade is fully closed and no active Short trades remain.

  • Reverse Position Enabled:

    • If there is an active Long trade and an "Entry Short" signal is received, the Long trade will be immediately closed at market price (regardless of profit or loss), and a Short trade will be opened.

    • Likewise, if there is an active Short trade and an "Entry Long" signal is received, the Short trade will be immediately closed at market price (regardless of profit or loss), and a Long trade will be opened.

Futures Accounts

  • Hedge Mode Enabled: The Signal bot can simultaneously create Long and Short positions.

  • Hedge Mode Disabled:

    • Reducing a position by a volume larger than the current position will result in an opposite position being opened.

    • If the remaining position size is too small, an error message will appear, indicating the order size is insufficient.

    • If "Reverse position" mode enabled, an "Entry short" alert will close a long position with 100% volume and enter in the opposite direction. Similarly, an "Entry long" alert will close a short position with 100% volume and enter in the opposite direction.


Set Signal Alerts

Copy the webhook:

This webhook is valid only for Signal bots!
For DCA bots, the webhook is different (see here)!

Open in another tab any other service that supports webhooks.

In our example, we will use TradingView. You can directly click on the Go to TradingView button or open it by yourself.
Prepare the pair you want to trade with and don't close the tab:

Create an alert

Choose the exchange and a trading pair you want to set an alert for, choose the conditions you want when the signal should be sent and expiration and click on the Alert button:

Important notes!

  • It's very important to choose the correct pair and exchange in TradingView, otherwise the signals will not be valid!

  • If you want to create a Signal bot on the Demo account, you need to choose the pair on Binance Spot on TradingView because the Demo account simulates trading on the Binance Spot account.

Open the Settings tab and paste the JSON message

Note: Paste the JSON message of the Entry order on the Entry signal. If you have an Exit order, past the JSON message of the Exit order on the Exit signal.

IMPORTANT NOTE!

DO NOT share publicly the JSON message from your signal bot. If you accidentally did share, please delete this bot and create a new one - in this case you will be safe.

Open the Notifications tab and paste the webhook


Summary

Click Start if you are done with the settings. Bots can now be saved without launching using a dropdown menu on the right edge of the "Start Bot" button.


The revamped Signal Bot simplifies bot creation and management, making it easier for users to analyze external trading strategies and enhance their trading activities. By aligning with the DCA Bot interface, the Signal Bot provides a seamless and consistent user experience.

Leverage these new tools to optimize your trading strategies and achieve your trading goals! 🎉

Did this answer your question?