> For the complete documentation index, see [llms.txt](https://mt5-m0rpheu5.gitbook.io/mt5.m0rpheu5-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://mt5-m0rpheu5.gitbook.io/mt5.m0rpheu5-docs/getting-started/signal-formats.md). # Signal Formats MT5 Link parses trade signals from your provider and converts them into MT5 orders. It supports multiple formats so most providers work automatically. *** ## Structured Format (recommended) Simple key-value pairs, one per line: ``` Pair: XAUUSD Type: BUY Entry: 4100.00 Stop Loss: 4090.00 TP1: 4110.00 TP2: 4120.00 ``` MT5 Link also handles emoji decorations and extra text: ``` 🔔 NEW SIGNAL ALERT 📊 Pair: XAUUSD 🟢 Type: BUY 💰 Entry: 4100.00 🎯 Take Profits: TP1: 4110.00 TP2: 4120.00 🛑 Stop Loss: 4090.00 ``` *** ## Compact / Inline Format Single-line format with entry and stop loss separated by `/`: ``` XAUUSD SELL 4105 4108 / Sl 4117 / TP 4102 XAUUSD BUY 4100 / SL 4090 / TP 4110 4120 ``` Arrow separators also work: ``` XAUUSD SELL Entry → 4100 SL → 4090 TP → 4080 ``` *** ## Parenthesized Action Some providers wrap the action in parentheses: ``` XAUUSD (BUY) @ 4100 XAUUSD (SELL) Entry 4105 SL 4117 TP 4102 ``` *** ## Targets with Checkmarks If your provider uses a Targets block with checkmarks: ``` 📊 XAUUSD BUY 💰 Entry: 4100 🛑 Stop Loss: 4090 🎯 Targets: ✅ 4110 ✅ 4120 ✅ 4130 ``` *** ## Requirements All formats require these fields: | Field | Required | Description | | ------------- | -------- | ----------------------------------------- | | **Symbol** | Yes | Trading instrument (XAUUSD, EURUSD, etc.) | | **Action** | Yes | BUY or SELL | | **Entry** | Yes | Entry price | | **Stop Loss** | Yes | Stop loss price (see SL-only guard below) | Take Profit levels (TP) are optional — MT5 Link works with 0 or more TP levels. *** ## SL-Only Guard MT5 Link **refuses** to execute BUY or SELL signals that don't include a Stop Loss. This prevents unprotected trades. If you see "Signal blocked — no Stop Loss" in the log: * Add SL to your signal format * Or contact your provider to include SL in their messages Cancel/Close signals (which close existing positions) do not require SL. *** ## Emoji Handling Emoji in signals are automatically stripped before parsing. You don't need to remove them — MT5 Link handles both plain text and emoji-decorated messages. *** ## Debugging Use the **Test Signal** button (in Discord mode or via right-click) to paste any signal and see exactly how MT5 Link parses it: * Parsed fields (symbol, action, entry, SL, TPs) * Calculated lot size * Would-send request details * Any errors or skipped reasons --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://mt5-m0rpheu5.gitbook.io/mt5.m0rpheu5-docs/getting-started/signal-formats.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.