Message tools
explore the full potential of alert messages
Message Generator
Try out the tool below to create alert messages and see how to format them correctly. If you enjoy reading, see explaination
Action
Size
Entry
Stop loss
Take profit
Comment
Formatted mesage
Message Parser
Paste alert message here to verify format & see how it'll be parsed. If you still want to read, see explaination.
Alert mesage
Empty message
How it works - wall of text edition
Some things you should know
- We've designed the system to be flexible, making it easy for you to create alert messages. However, to ensure we understand your intended actions correctly, the message must follow a proper format.
- The tools above demonstrate what you can do with an alert message. It's quite powerful, so it might seem a bit complex at first. Please take a moment to explore and get familiar with the flexibility it offers.
- To help prevent mistakes, we carefully validate your alert messages before sending them to trading platforms. However, if you're only sending to messaging apps, we apply less strict validation.
- Only a limited set of characters is allowed. We believe this set is sufficient for all essential actions, but please be aware that some restrictions do apply.
Basic rules
Separate the actions you want to specify using Semicolons (;) or Commas (,). Use only one type of separator consistently throughout the entire message.
For example: Action=buy; Size=1
Specify the actions you want using Key=Value pairs. You may use Colons (:) instead of Equal (=). Use only one format throughout the entire message.
For example: Action=buy or Size:1
In Key=Value pairs, the Key must be from the predefined set of allowed keys. The Value is flexible and depends on the chosen key. Details are provided below.
For example: SL=123456: SL is the key and be fixed. The value can be one of the following formats: 123456, +123456, -123456, or a percentage such as 12%.
Keys and Values are not case-sensitive. This means Action=buy or ACTION=buy and action=BUY are all interpreted the same way.
In Key=Value pairs, spaces are allowed around the separator. This means you can use Symbol=BTCUSDT or Symbol = BTCUSDT or Symbol= BTCUSDT. They all produce the same result. However, do not insert spaces within the key or value themselves (e.g., Symbol=B T C U S D T is invalid).
The order of Key=Value pairs does not matter. For example, Symbol=BTCUSDT; Size=0.1 and Size=0.1; Symbol=BTCUSDT will produce the same result.
Total message length is must not more than 512 characters.
Allowed Keys and Value Types
There are certain required keys that must be included to create a valid trading request for execution on trading platforms. If you're only sending the message to messaging apps (Telegram, Discord...), these required keys can be omitted.
Action: Defines the action to be performed. This is a required key.
Accepted values: buy, sell or close
Size: Defines the size of the action. This is a required key.
Accepted values:
- In Buy/Dell action, accept a number that refers to the amount of the asset: coin quantity for crypto, lot size for forex, or share quantity for stocks.
For example: Size=1.5 to means buy/sell 1.5 coins if Symbol=BTC. If Symbol=EURUSD, it means buy/sell 1.5 lots of EURUSD (the lot size is up to your account and broker)
- In Close action, it can be a fixed volume, just like in a Buy/Sell action. It can also be a percentage of the open position.
For example, you can use Size=50% to specify that close 50% of position size.
Symbol: Defines the symbol of the action. This is a required key.
Accepted values: It can be any valid trading symbol, depending on the market. For example: Symbol=BTCUSDT, Symbol=EURUSD, Symbol=AAPL
In a Close action, you can use the asterisk (*) to indicate "all open positions". Example: Action=Close; Symbol=* means Close all positions.
Rules: Accepted characters: A-Z, 0-9, dots (.) and underscores (_); Maximum 16 characters and n spaces allowed.
Entry: Defines the entry value. This is a required key in Buy/Sell actions.
Accepted values:
- You can use a fixed value number. For example: Entry=123456
- Or use the market price, with optional adjustment to flexible market-based entries with offset.
Examples:
Entry=market → Enter at current market price
Entry=market+123 → Enter at market price plus 123
Entry=market-456 → Enter at market price minus 456
SL: Defines the stop loss level. This is a optional key.
Accepted values: Fixed value, Offset change from entry price or Percentage change from entry price.
Examples:
SL=123456 → Stop loss at fixed price = 123456
SL=+123 → Stop loss at entry price plus 123
SL=-456 → Stop loss at entry price minus 456
SL=+3% → Stop loss at entry price plus 3%
SL=-5% → Stop loss at entry price minus 5%
Stop loss should be below the entry price for Buy action and above the entry price for Sell action. You must explicitly use plus (+) or minus (-) to set whether the SL is above or below the entry, even if it seems obvious. This gives you full flexibility.
TP: Defines the take profit level. This is a optional key.
Accepted values: Fixed value, Offset change from entry price or Percentage change from entry price.
Examples:
TP=123456 → Take pofit at fixed price = 123456
TP=+123 → Take pofit at entry price plus 123
TP=-456 → Take pofit at entry price minus 456
TP=+3% → Take pofit at entry price plus 3%
TP=-5% → Take pofit at entry price minus 5%
Take pofit should be above the entry price for Buy action and below the entry price for Sell action. You must explicitly use plus (+) or minus (-) to set whether the TP is above or below the entry, even if it seems obvious. This gives you full flexibility.
Profit: Defines the profit filter in Close action. This is a optional key.
Accepted values: Define a profit range as a pair of numbers separated by a colon (:), indicating the minimum and maximum profit levels. You can use asterisk (*) to indicate "unlimit" value.
Examples:
Profit=123:456 → Profit is from 123 to 456
Profit=*:456 → Profit is maximum 456
Profit=123:* → Profit is minimum 123
Profit=*:* → Any profit. Or you just don't specific Profit key to not filter profit
Comment: For adding extra information or a signature when sending to messaging apps. Only used when sending to messaging apps. This is a optional key.
Accepted values: Allowed characters: A-Z, 0-9, spaces, dots (.), underscores (_), hyphens (-), colons (:) and equals signs (=)
The entire comment must be wrapped in quotes (").
Commas (,) and semicolons (;) are not allowed inside the comment.
Examples:
Comment="This message is sent by Trade Sender"
Comment="Additional TP levels: TP2=123567 and TP3=123678"
Example messages
Message: Action=buy; Size=1; Symbol=btcusdt; Entry=123456
Action: Buy 1 btcusdt, Entry price is 123456
Message: Action:buy; Size:1; Symbol:btcusdt; Entry:market; SL:90000; TP:120000
Action: Buy 1 btcusdt, Entry price is market, Stop loss level is 90000, Take profit level is 120000
Message: Action=sell; Size=1; Symbol=btcusdt; Entry=market+500; SL=+1000; TP=-2000
Action: Sell 1 btcusdt, Entry price is market price +500, Stop loss level is entry price +1000, Take profit level is entry price -2000
If current market price is 110000, it means: Sell 1 btcusdt, Entry price is 110500, Stop loss level is 111500, Take profit level is 108500
Message: Action=close; Size=100%; Symbol=btcusdt; Profit=500:1000
Action: Close 100% of open positions if position symbol is btcusdt and position profit is between 500 and 1000
Message: Action: close, Size: 100%, Symbol: btcusdt, Profit: 500:1000, Comment: "send by Trade Sender"
Action: Close 100% of open positions if position symbol is btcusdt and position profit is between 500 and 1000
If you're sending the message to messaging apps, the message should be (without quotes): "Action: close, Size: 100%, Symbol: btcusdt, Profit: 500:1000, send by Trade Sender"