How to set up and configure a signal bot

A signal bot opens and manages positions when a signal arrives from a supported signal provider. It never starts on its own: something has to tell it to trade. Creating one is a three-step wizard, and you can either start from a template or configure every parameter by hand.

Before you start: you need a connected exchange account, or a demo account, linked to Altrady. See Connecting your exchange for your exchange’s own setup guide.

Open the bot wizard

1. Open Bots in the left-side menu.
2. Click + Create at the top right of the Trading Bots page.
3. Choose Signal bot in the Create a bot dialog.

🔍 Click the image to see a larger version

The dialog lists every kind of bot, and this article covers Signal bot. For the others, see How to create a DCA bot, How to create a HODL bot and How to create a QFL bot or a TradingView bot.

The trading terminal’s Tools widget also lists Signal Bot, which opens this same flow on the Bots page.

Step 1: Choose your signal provider

The wizard opens on Create Signal Bot, with two Signal providers:

• Crypto Base Scanner (QFL): Altrady’s own scanner, which watches markets using configurable algorithms and sends entry signals.
• The Better Traders: a curated signal service integrated with Altrady.

🔍 Click the image to see a larger version

Selecting one moves you straight to the next step. Your choice matters later: some Filters options only apply to Crypto Base Scanner signals.

To trade your own TradingView alerts or webhook signals, pick TradingView Bot or Webhook bot in the Create a bot dialog instead. See How to create a QFL bot or a TradingView bot and How webhook signals work in Altrady.

Step 2: Trading account and investment

Next comes Trading account and investment.

1. Account: pick from your connected accounts. The picker separates Live and Demo, and each row shows the account name, its exchange and its balance. This choice decides whether you finish with a live or a demo bot, so check which tab you’re on.
2. Currency: USDT, USDC, or another currency the account holds.
3. Investment: the total capital this bot may hold across all its positions at once. Quick-select buttons offer amounts based on your available balance, or you can type your own.
4. Reinvest profits: when enabled, profit from closed positions is added back into the investment pool instead of being paid straight out.

🔍 Click the image to see a larger version

One thing worth checking before you fund a bot: the money needs to be in the right wallet on the exchange already. Altrady can’t move balances between spot and futures wallets for you.

Click Next when you’re done.

Step 3: Parameters

The last step is headed Parameters and offers three ways to start: Template 1, Template 2, and Start blank.

The two templates are ready-made configurations. They differ in how many positions the bot may hold at once, how many DCA entries it stacks below the first one and how far apart those sit, how far out the take-profit target is placed, where the stop loss goes and what protection it uses, and how the investment splits between the entry order and the DCA orders. Template 1 allows fewer positions with fewer DCA entries and a closer stop; Template 2 allows more of both.

Pick either one and a summary card appears beneath, laying out exactly what that template will do: signal source, max positions, DCA entries and their deviation, take profit, stop loss and its protection mode, any filters, and the resulting position size with an entry-versus-DCA split bar.

🔍 Click the image to see a larger version

From here you have two routes. Start Live Signal Bot launches the bot on the template as it stands. Adjust parameters opens the full Parameters tabs so you can change anything first. Start blank goes straight to those tabs with nothing preset.

Nothing you choose here is permanent. As the screen itself says, you can change the settings later.

The Parameters tabs

This is where you shape how the bot builds and closes a position. There are four tabs: Entry, Take profit, Stop loss and Filters. A tick appears on each one as you complete it, Next moves you to the following tab, and Reset returns the current tab to its starting values. On the last tab the button reads Review instead. The Preset dropdown at the top right lets you drop a template’s values in at any point.

The tabs interact, so it’s worth reviewing all four together rather than one at a time. A deeper DCA ladder needs a stop loss with enough room below it, for instance.

Entry tab

1. Max positions: the total number of positions this bot may hold open at once, across every market it trades.
2. Positions per market: how many of those may be open in the same market at the same time. On a futures account a Count limit per side switch appears under it, which decides whether that number is a total for the market or applies to longs and shorts separately: see Using a signal bot on a futures exchange.
3. Dollar Cost Averaging (DCA): the toggle that enables extra entries below your first one.
4. Custom / Signal: Custom uses the settings you enter here; Signal takes them from the incoming signal instead.
5. Deviation: how far price must drop from the signal price before that DCA order is placed.
6. Size: the size of that DCA order, as a percentage of the entry order.
7. Add DCA: adds another DCA entry, up to a maximum of nine.
8. Entry order expiration (advanced): cancels an unfilled entry order after a set time.
9. Entry price deviation (advanced): moves the entry order price away from the signal price by this percentage. A positive value places the order where it fills more easily (above the signal price for a long, below it for a short); a negative value places it further away. The stop loss is measured from this adjusted price: see How the take-profit and stop-loss prices are set below.
10. Auto close (advanced): closes the position automatically after a set duration.
11. Entry order: what the first order of each position will cost.
12. Full position cost: what a position costs in total once every DCA order has filled, with a bar showing how that divides between the entry and the DCA orders.

🔍 Click the image to see a larger version

Watch those last two figures as you add DCA entries. A deep ladder commits considerably more per position than the entry order alone suggests, and Full position cost is the number that tells you how much.

Take profit tab

1. Take profit: the toggle that enables take-profit targets.
2. Custom / Signal: the same choice as on the Entry tab.
3. Profit: how far price has to move from your break-even price for this target to trigger. Break-even includes the trading fees, so the target lands slightly further from your fill price than this percentage.
4. Volume: how much of the position that target closes.
5. Enable trailing for last target: the final target follows price instead of closing at a fixed level.
6. Add target: adds another partial take-profit level.

🔍 Click the image to see a larger version

Stop loss tab

1. Stop loss: the toggle that enables the stop.
2. Custom / Signal: as on the other tabs.
3. Stop distance: how far price must move against the position before the stop triggers, measured from the entry order price.
4. Protection: what the stop does as the trade progresses. None, Break even, Follow TP, or Follow price. Altrady explains the selected mode in a note underneath, so you can see what you’ve chosen without guessing.
5. Trigger after and Trail distance: these appear when Protection is set to Follow price. Trigger after is how far into profit the trailing starts; Trail distance is how far behind price the stop then follows.
6. Stop loss timeout (advanced): waits before acting on the stop, in case price recovers. Timeout type is either Time, with a value and a unit such as hours, or Candle close.
7. Emergency Stop loss (advanced): a backup stop that overrides the timeout and closes the position immediately. Its Emergency SL % has to be more extreme than your stop loss, and the form tells you the minimum it will accept.

🔍 Click the image to see a larger version

Filters tab

Filters decide which signals the bot acts on. The first three apply to Crypto Base Scanner signals only.

1. Scanner algorithms (CBS only): choose any combination of Day trade, Conservative and Position. Each one appears as a chip in the field, and the × on a chip removes it. There’s always at least one: a new bot starts with one selected, and the last remaining chip can’t be removed.
2. Min success rate (CBS only): only act on signals at or above this success rate.
3. Max success rate (CBS only): only act on signals at or below this success rate.
4. Cool down after opening: after the bot opens a position, it ignores new signals for the time you set here, entered as a value plus a unit.
5. Cool down after Stop loss: the same idea after a stop loss fires, which stops the bot re-entering straight into a falling market.
6. Min volume: ignore markets whose 24-hour volume is below this figure.
7. Max volume: ignore markets whose 24-hour volume is above it.
8. Min price: ignore markets whose asset price is below this figure.
9. Max price: ignore markets whose asset price is above it.
10. White list: only trade the markets listed here.
11. Black list: never trade the markets listed here.

🔍 Click the image to see a larger version

The algorithms field is a multi-select: open it and tick as many as you want the bot to listen to.

🔍 Click the image to see a larger version

The two lists take coin names, separated by commas or one per line, and match the whole name: SOL matches SOL, not BBSOL. For the details, see Signal bot whitelists and blacklists: how matching works.

How the take-profit and stop-loss prices are set

The take profit and the stop loss are measured from two different prices, so on a filled position the distances can differ slightly from the percentages you entered.

• Take profit is measured from your break-even price: the average price of your filled entries, plus the trading fee on the entry and the estimated fee on the exit. It’s recalculated each time an entry or DCA order fills. Because the fees are included, each target sits a little further from your fill price than its Profit percentage.
• Stop loss is set once, when the bot opens the position, as a fixed price measured from the entry order price: the signal price adjusted by Entry price deviation. It doesn’t move when the entry or DCA orders fill; only the Protection mode moves it.

So when the entry order fills at a better price than its own price, the stop loss ends up closer to your fill than the Stop distance you set. A Stop market stop loss closes with a market order once the stop price is reached, so in a fast market the close can land slightly beyond the stop price.

An example for a long, with an exchange fee of 0.05% per order, Entry price deviation 0.1%, Profit 0.3% and Stop distance 0.6%:

	Price	Distance from the fill
Signal price	100.00
Entry order (signal price + 0.1%)	100.10
Entry fill	100.02
Break-even (fill + entry and exit fee)	100.12	+0.10%
Take profit (break-even + 0.3%)	100.42	+0.40%
Stop loss (entry order price - 0.6%)	99.50	-0.52%

For a short every direction is reversed. For more on the break-even price, see Understanding your position numbers.

Start the bot

When the configuration looks right, click Start Live Signal Bot, or Start Demo Signal Bot if you picked a demo account back in step 2. Editing a bot that’s already running shows Save changes on the same button instead.

The bot then appears in the Bots tab as active and listening for signals. Don’t worry if a new Crypto Base Scanner bot takes a few hours, or even a couple of days, to receive its first signal: that’s normal, not a sign of misconfiguration. Until then you’ll see “No open positions, waiting for next signal”, which is exactly what it says.

Moving from demo to live

When a demo bot has convinced you, Convert to Live copies its settings into a live one rather than making you rebuild it. A signal bot converts onto the same exchange it was demoing on, and you choose the account, quote currency and position size. See How do I convert a demo bot to a live bot?.

Plan limits

Your plan sets how many bots you can run at once, and every kind of bot shares that allowance. The limit counts bots active at the same time, not how many you’ve ever created, so stopping one frees a slot immediately. See How many bots can I run?, and altrady.com/pricing for current numbers.

Next steps

• Signal Bot Not Trading? Troubleshooting
• Signal bot whitelists and blacklists: how matching works
• Signal Bot Reports and Performance

Still stuck?

If your bot isn’t behaving the way you expect after checking the above, reach out via support chat. We can look at your specific bot configuration and account.