Trade Sender

Docs

Trade Sender

Docs

Trade Sender

Documentation

  • Light mode

DashboardHome

💬 Message Tools

Tools to generate and parse alert messages automatically

Alert messages play a crucial role — they are the bridge between your TradingView alerts and Trade Sender. For Trade Sender to interpret your intentions correctly, your TradingView alerts must include properly formatted messages using the correct syntax.

The syntax was designed to be simple, consistent, and easy to use. However, because alert messages are powerful and flexible, mastering the format can take a bit of time.

The good news? You don't have to memorize or fully learn the syntax to use it correctly. We provide helpful tools for all users:

  • Message Generator — Create valid messages effortlessly with just a few clicks.
  • Message Parser — Check whether your message is valid and see exactly how it will be interpreted.

📢 Important notes:
- You can now send free-form messages through Telegram and Discord! Just only limit at 512 characters length.
- The formatting tools are now intended exclusively for MetaTrader connections, as these still require a strict message format to ensure trades are processed correctly.

📌 How to Access Message Tools

Message tools are available to all users with a Trade Sender account. To start using them:

  1. Log in to the Dashboard (you’ll need an account first)
  2. Click Message Tools in the left sidebar
  3. The tools are now ready to use

These tools provide a visual and user-friendly interface. If you’d like to explore them in more detail, see the guidelines below.

🪄 Message Generator

Use this tool to create alert messages interactively and understand the correct format.

How to Use

Using the Message Generator is simple and straightforward:

  • Select the action you want to create a message for
  • Adjust the inputs as needed
  • Copy the message generated from the Message field
  • Paste the message into your TradingView alert message
  • (Optional) Paste the message into the Message Parser to double-check

Below are the detailed guidelines for each action input:

📢 1. Buy action

You must set the Symbol, Entry Type, and Size, as these are mandatory fields. All other fields are optional and can be left blank.

Message Generator Tool
  • Symbol: Enter the trading symbol you want to buy.

  • Trade Size: Specific the size of buy order.
    Select the unit you want to use, then enter the value in the Value field.

    The following size types are supported:

    1. Volume — Buy a fixed lot size of the symbol
    2. % Account — Buy a size calculated as a percentage of Balance, Equity, or Free Margin
    3. Amount — Buy using a fixed monetary value

    Notes:

    • You can specify whether the percentage is based on Balance, Equity, or Free Margin by configuring it in the Trade Sender Connector using the Size Percent input.
    • The Amount option uses your account's currency.

  • Entry Type: Select how the buy order should be placed.

    1. Market Price — Executes immediately at the current market price (a market order will be placed).

    2. Fixed Price — Executes at a specific price you define.

      • A Value field will appear for you to enter the desired price.
      • If the price is above the current market price → a Buy Stop order will be placed.
      • If the price is below the current market price → a Buy Limit order will be placed.

  • Stop Loss: Specific the stop loss level.
    Select the unit you want to use, then enter the value in the Value field.

    The following stop loss types are supported:

    1. Price — A fixed stop loss price
    2. Point Change — A specific number of points away from the entry price
    3. % Change — A percentage distance from the entry price

    Notes:

    • Leave the Value field blank if you don’t want to set a stop loss.
    • You can set the point value multiplier in the Trade Sender Connector using the Point Multiple input.

  • Take Profit: Specific the take profit level.
    Select the unit you want to use, then enter the value in the Value field.

    The supported types are the same as those used for Stop Loss.

  • Breakeven: Configure breakeven settings for your trade.
    Toggle the switch to enable breakeven for the order.

    Breakeven requires two parameters: Start and Offset. Enter the desired values for each.

    Notes:

    • Start must be greater than Offset.
    • Both values are measured in points (away from the entry price).
    • The Point Multiple setting from the Trade Sender Connector is applied.
    • The breakeven logic is fully managed by the Trade Sender Connector.

    How it works:
    When the order becomes a position and the price reaches the Start value, the Trade Sender Connector automatically sets or moves the stop loss to the Offset from the entry price.

  • Trailing Stop: Configure a pip-based trailing stop for your trade.
    Toggle the switch to enable trailing stop for the order.

    Trailing stop requires three parameters: Start, Distance, and Step. Enter the desired values for each.

    Notes:

    • Start must be greater than Distance.
    • Start, Distance, and Step are all measured in points (away from the entry price).
    • The Point Multiple setting from the Trade Sender Connector is applied.
    • Trailing stop logic is fully managed by the Trade Sender Connector.

    How it works:
    Once the order becomes a position and reaches the Start value, the Trade Sender Connector begins adjusting the stop loss, maintaining the specified Distance from the current price. Each subsequent adjustment occurs only after the market moves at least the Step in your favor.

  • Comment: Enter a trade comment.
    Notes:
    • No spaces or special characters allowed
    • Maximum 31 characters

📢 2. Sell action

This works exactly the same as the way you generate message for Buy action.

📢 3. Close action

All fields are optional and can be left blank. If nothing is specified, all positions will be closed.

Message Generator Tool - Close action

  • Close Size: Specify how much of the position to close.

    Select the unit you want to use, then enter the value in the Value field.

    Supported size types:

    1. Volume — Close a fixed lot size
    2. % Position — Close a percentage of the position

  • Select Positions By: Choose which positions to close.

    Supported filter types:

    • All — Apply to all open positions

    • Ticket — Target a specific position by ticket
      Enter the ticket number in the Ticket Id field.

    • Filter — Filter positions by Symbol and Type
      Enter the desired symbol in the Symbol field and select the position type in the Type field.

      Position types:

      • Long — Long positions
      • Short — Short positions

  • Min Profit: Filter positions by a minimum profit value.

  • Max Profit: Filter positions by a maximum profit value.

📢 4. Cancel action

All fields are optional and can be left blank. If nothing is specified, all orders will be canceled.

Message Generator Tool - Cancel action

  • Select Orders By: Choose which orders to cancel.

    Supported filter types:

    • All — Apply to all pending orders

    • Ticket — Target a specific order by ticket
      Enter the ticket number in the Ticket Id field.

    • Filter — Filter orders by Symbol and Type
      Enter the desired symbol in the Symbol field and select the position type in the Type field.

      Order types:

      • Buy — All Buy orders (BuyStop, BuyLimit, BuyStopLimit)
      • BuyStop — Buy stop orders
      • BuyLimit — Buy limit orders
      • BuyStopLimit — Buy stop-limit orders
      • Sell — All Sell orders (SellStop, SellLimit, SellStopLimit)
      • SellStop — Sell stop orders
      • SellLimit — Sell limit orders
      • SellStopLimit — Sell stop-limit orders

      Please aware that some order types (such as BuyStopLimit or SellStopLimit) are not supported in MT4.

📢 5. Update action

You must set Select By to filter trades, as it is a mandatory field. All other fields are optional and can be left blank.

However, at least one update detail should be specified — otherwise, nothing will be updated.

Message Generator Tool - Update action

  • Select By: Choose which trades to update.

    Supported filter types:

    • Ticket — Target a specific trade by ticket
      Enter the ticket number in the Ticket Id field.

    • Orders — Filter by pending orders
      Optionally enter a symbol in the Symbol field, and select an order type in the Type field if you want more specific filtering.

    • Positions — Filter by open positions
      Optionally enter a symbol in the Symbol field, and select an position type in the Type field if you want more specific filtering.

  • Stop Loss: Specific the updated stop loss level.
    Select the unit you want to use, then enter the value in the Value field.

    The following stop loss types are supported:

    1. Price — A fixed stop loss price
    2. Point Change — A specific number of points away from the entry price
    3. % Change — A percentage distance from the entry price

    Notes:

    • Leave the Value field blank if you don’t want to update stop loss.
    • You can set the point value multiplier in the Trade Sender Connector using the Point Multiple input.

  • Take Profit: Specific the updated take profit level.
    Select the unit you want to use, then enter the value in the Value field.

    The supported types are the same as those used for Stop Loss.

  • Breakeven: Update breakeven settings for your trade.

    Select the action you want to perform:

    • No Update — Keep the existing breakeven settings

    • New Setup — Apply a new breakeven configuration
      New breakeven setup requires two parameters: Start and Offset. Enter the desired values for each.

      Notes:

      • Start must be greater than Offset.
      • Both values are measured in points (away from the entry price).
      • The Point Multiple setting from the Trade Sender Connector is applied.
      • The breakeven logic is fully managed by the Trade Sender Connector.

    • Remove — Delete the current breakeven setup

  • Trailing Stop: Update a pip-based trailing stop for your trade.
    Select the action you want to perform:

    • No Update — Keep the existing trailing stop settings

    • New Setup — Apply a new trailing stop configuration
      New trailing stop setup requires three parameters: Start, Distance, and Step. Enter the desired values for each.

      Notes:

      • Start must be greater than Distance.
      • Start, Distance, and Step are all measured in points (away from the entry price).
      • The Point Multiple setting from the Trade Sender Connector is applied.
      • Trailing stop logic is fully managed by the Trade Sender Connector.

    • Remove — Delete the current trailing stop setup

💡 Message Parser

Paste your alert message into this tool to verify its format and see how it will be interpreted. The parser checks the message, understands your instructions, and shows how Trade Sender will execute it in your trading account.

How to Use

Using the Message Parser is simple and straightforward:

  • Copy a message you generated with the Message Generator or one you wrote yourself
  • Paste the message into the input box
  • Review the parsing result
Message Parser Tool

Parsing Results

  • If the message is invalid
    There’s an issue with the content. You’ll see an error message explaining what went wrong.

  • If the message is valid
    You’ll get a detailed explanation of how the action will be executed in your trading account.

For Telegram/Discord
Manage Licenses