> 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/guides/symbol-mapping.md).

# Symbol Mapping

Different brokers use different symbol names for the same instrument. MT5 Link needs to know which symbol in your signal corresponds to which symbol in your broker.

***

## Common Symbol Differences

| Signal Symbol | Broker Symbol | Meaning                                 |
| ------------- | ------------- | --------------------------------------- |
| GOLD          | XAUUSD        | Gold vs US Dollar                       |
| EURUSDm       | EURUSD        | Euro vs US Dollar (mini)                |
| XAUUSD        | GOLD          | Some brokers use GOLD instead of XAUUSD |
| USOIL         | XTIUSD        | Crude Oil WTI                           |
| UKOIL         | XBRUSD        | Crude Oil Brent                         |
| SPX500        | US500         | S\&P 500 Index                          |
| NAS100        | USTEC         | NASDAQ 100 Index                        |

***

## Adding Mappings

1. Open MT5 Link
2. Go to **Settings** → **Symbol Mappings**
3. Click **"+ Add"**
4. Enter the **signal symbol** (what your provider uses, e.g. `GOLD`)
5. Enter your **broker's symbol** (what MT5 shows, e.g. `XAUUSD`)
6. Click **"Scan MT5"** to auto-detect available symbols
7. Click **Save**

***

## Finding Your Broker's Symbols

1. Open MetaTrader 5
2. Open **Market Watch** (Ctrl+M)
3. Right-click → **Symbols** (or Ctrl+U)
4. Search for the instrument (e.g. "gold", "gold")
5. Note the exact symbol name (e.g. `XAUUSD`, `GOLD`, `GOLDm`)

***

## Testing

After adding a mapping:

1. Send a test signal using the signal symbol (e.g. `GOLD`)
2. Check the log — it should show the mapped symbol (e.g. `XAUUSD`)
3. Verify the order appears in MT5 with the correct symbol

***

## Removing a Mapping

1. Go to Settings → Symbol Mappings
2. Find the mapping in the list
3. Click the **trash icon** to delete
4. Click **Save**

***

## Notes

* Mappings are **one-way**: signal symbol → broker symbol
* You only need mappings when your broker's symbol differs from the signal
* The "Scan MT5" button helps by showing all available symbols from your broker
* If a signal uses a symbol you haven't mapped, MT5 Link will show "Symbol not found" in the log


---

# 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/guides/symbol-mapping.md?ask=<question>&goal=<endgoal>
```

`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.