Articles on: Signals and Automation

Webhook: Setting up the Signal Bot

A Signal Bot is essential for receiving and acting on webhook signals. This article will guide you through setting up a Signal Bot specifically for webhook signals.

See also:
- Webhook and Trading View SIgnals: Overview
- Webhook Signals: Open, Close, Increase, or Reverse a Position

Important:
- Create the Signal Bot first, as the API key and Secret are generated during this process.
- A Signal Bot of the type “Signals” cannot be duplicated for a Webhook Bot. However, a Webhook Bot can be duplicated to create another Webhook Bot.

For a visual guide on creating a Signal Bot for a Webhook and aquiring an API key and secret, check the video tutorial below (from 0:55 to 1:27).



About the Signal Bot


An Altrady Signal Bot is designed for:
- Use with only one exchange.
- A single trading account (live or paper).
- One quote currency, but unlimited base currencies (managed via Whitelist/Blacklist, or by accepting all signals from your webhook signals).
- Opening multiple positions on any pair for Spot markets; for Futures exchanges, only one position per market can be opened at a time on one trading account. Subsequent signals to open a new position will be ignored if there's an existing open position. Learn more about using Altrady's Signal Bot with Futures exchanges.
- Specifying the entry amount (either a fixed amount or a percentage).
- All settings can be specified within the Signal Bot, and a subset of these settings can be specified in the webhook signal if preferred.
- For DCAs (extra entries), Take Profit orders and Stop Loss, settings will be taken from the Signal Bot or the Signal, depending on the related Signal Bot setting (Custom | Signal).

Custom to use the setting are in the Signal Bot. Use Signal if the setting will be in the webhook signal." class="csh-markdown csh-markdown-image">For DCAs, TPs and SL: Choose <span class=Custom to use the setting are in the Signal Bot. Use Signal if the setting will be in the webhook signal." loading="lazy"/>

If an entry amount is included in the webhook signal, it will override the Signal Bot entry amount.

For a detailed explanation of each setting, see:
- Signal Bot Settings
- To understand how the signal bot works, check Signal Bot Processing and FAQ
- For Signal Bot error and warning messages

Deciding When to Include Settings in the Webhook Signal vs. in the Signal Bot


- Extra Entries/DCAs
- Signal Bot: Use this if they will be the same for every signal, regardless of the market.
- Webhook Signal: Use this if they will vary for each signal for the same market, or across different markets.
- Omit: If there will never be additional entries, or if you plan to use a Webhook Signal with the Increase action instead.

- Take Profit Orders
- Signal Bot: Use this if they will be the same for every signal, or if you want to use the Trailing Take Profit feature.
- Webhook Signal: Use this if they will vary by signal or market.
- Note: Do not omit TP orders. If no TP orders are set for a position, it will close once all entries have filled.

- Stop Loss Orders
- Signal Bot: Ideal for consistent settings across signals or to use a Trailing Stop Loss.
- Webhook Signal: Choose this if Stop Loss settings will vary by signal or market.
- Omit: If there will never be a Stop Loss or if a Webhook Signal with Action: Close is preferred for position closure.

Some settings are exclusive to the Signal Bot, but more are gradually being added as optional settings for webhook signals. For the most current settings list, refer to:
- Swagger test page
- Webhook Signals: Open, Close, Increase or Reverse a Position for detailed explanations of each webhook signal setting.

After your Signal Bot has been created, and the API key and secret have been recorded, the next step is to create the JSON code for your signal.



- Webhook and Trading View SIgnals: Overview
- Webhook Signals: Open, Close, Increase or Reverse a Position
- Webhook Signals: Start or Stop a Signal Bot
- Valid values for Exchange and Symbol
- Webhook Signals: Trading View Setup
- Webhook Signals: Testing and Errors

Updated on: 16/04/2024

Was this article helpful?

Share your feedback

Cancel

Thank you!