Signal generation

Using AI to Analyze Trading Charts with Send Signal enabled

🧠 Smart Signal Execution

This advanced feature lets the AI not only analyze your chart but also make real trading decisions. When enabled, the AI can trigger a signal that is automatically sent to your webhook for live execution.

---

🧠 How It Works

When “Send Signal” is enabled:

1. A screenshot of the chart (including your indicators) is sent to the AI

2. A custom prompt guides the model to make a trading decision

3. If the AI responds with LONG, SHORT, or EXIT, a signal is dispatched

4. If the AI responds with HOLD, no action is taken

---

⚠️ Response Format is Mandatory for Signal Generation

To trigger a signal, the AI must respond with one of the exact patterns below. If the model’s output deviates from this format — for example, by including extra text, explanations, or incorrect structure — no signal will be generated.

✅ Accepted Format:

<action>:<price>

Where:

• <action> is one of: LONG, SHORT, EXIT, or HOLD — this will be available in {{last_trigger_action}}.

• <price> is the latest visible chart price (e.g., 29650.32) — this will be available in {{last_trigger_price}}.

✅ Examples (valid responses):

LONG:29650.32
SHORT:30420.70
EXIT:29980.50
HOLD:30012.00

❌ Examples (invalid responses – will not trigger a signal):

Go long at 29650.32
The price looks good, maybe LONG:29650.32
LONG:29650.32 because the RSI is oversold
Action: LONG Price: 29650.32

Important: If the response doesn’t exactly match the required <action>:<price> format, the system will ignore the output and take no action.

Be sure to design your prompt in a way that strictly enforces this format and suppresses any explanation or commentary from the AI. The cleaner the output, the more reliable your signal execution pipeline will be.

🧠 System Prompt (Automatically Added)

When signal sending is enabled, two things happen automatically:

1. Prepending context to your prompt:

   You are a trading bot now.  
   The last order was {{last_trigger_action}} at price {{last_trigger_price}}.  
   That executed at {{last_trigger_at}}.  
   The current time is {{current_time}}.
   
   IMPORTANT: If the last order was not "EXIT" or "HOLD", a position is currently open.  
   We can only have one position at a time — we must close it before opening a new one.

2. Appending output instruction to your prompt:

   Respond using **exactly one** of the following formats:
   
   LONG:<current_price>   → to open a long position  
   SHORT:<current_price>  → to open a short position  
   EXIT:<current_price>   → to close an already opened position  
   HOLD:<current_price>   → if no action is required (either no position is open, or it’s not a good time to enter/exit)
   
   VERY IMPORTANT:  
   - `<current_price>` must be the most recent exchange rate visible on the chart.  
   - Output **only** the action and the price — no explanation or extra text.
   
   Example:  
   If the chart indicates a long opportunity and the last visible price is 29650.32, respond with:  
   `LONG:29650.32`
   
   Now analyze the chart and provide your decision.

You do not need to include these in your custom prompt — the system handles it for you.

---

⚙️ Writing a Good Prompt

To ensure reliable signals, your custom prompt should focus on the decision-making logic, not the output format. Here's an example:

📝 Example Custom Prompt

The goal is to exit with at least 0.8% profit or stop out with a 1% loss.  
If either level is hit, the position must be closed.

You are analyzing a trading chart.  
Based on current indicators and chart patterns, choose the best action.  
Consider the previous order when making your decision.

🔁 The system will handle formatting instructions automatically — no need to repeat them.

---

🧩 Template Variables

To make prompt creation easier and more dynamic, you can now use the following template variables in your prompt:

Template	Description
{{last_trigger_action}}	The last executed signal (e.g., LONG, SHORT, EXIT)
{{last_trigger_price}}	The price of the symbol when the last trigger occurred
{{last_trigger_at}}	Timestamp when the last signal was executed (e.g., 2025-06-04 15:32 UTC)
{{current_time}}	The current time (automatically filled before execution)
{{trigger_history}}	An array (up to 20 items) of the model’s past actions, including trigger type, symbol, price, and timestamp, used to provide historical context for better decision-making.
{{val:<name>=<value>}}	Declares a custom value within your prompt. You can define it once and reuse it anywhere. For example: {{val:user=Joe}} then later use {{user}} → will be replaced with Joe.
{{comment:<text>}} or {{#:<text>}}	Adds inline comments to the prompt for readability and documentation. Comment content is stripped before the final prompt is sent and never reaches the model.
{{get:<url>}}	Fetches data via an HTTPS GET request from the specified URL and injects the response into the prompt. Requests are limited to HTTPS and have a timeout of 1750 ms.
{{toon:<json>}}	Converts JSON into Toon format, a compact link-based representation that helps reduce final prompt token count while preserving the original content semantics.

These help the AI reason based on past actions and current context.

---

📝 Example Prompt with Templates

{{comment: example comment }}

{{val:target_profit=0.8}}
{{val:max_loss=1.0}}
{{val:symbol=BTCUSDT}}

You're observing a live trading chart for {{symbol}} with real funds in play.
Your mission: secure at least {{target_profit}}% profit or exit the position if losses reach {{max_loss}}%.
Stay calm and act based on structure, momentum, and signal context.

Previous signal: {{last_trigger_action}} at {{last_trigger_price}} ({{last_trigger_at}})
Trigger history: {{trigger_history}}
Current time: {{current_time}}

External data sources:

Market sentiment: {{get:https://api.example.com/sentiment?symbol={{symbol}}}}

{{#: toon combined with get }}
Technical summary: {{toon: {{get:https://api.example.com/ta-summary?symbol={{symbol}}}} }}

Review the current chart carefully.
Consider trend strength, candle behavior, and volatility.
Weigh the previous signal and the data above before deciding on the next move.