> For the complete documentation index, see [llms.txt](https://docs.metacopier.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.metacopier.io/features/basic-features/symbol-mapping.md).

# Symbol mapping

{% hint style="info" %}
The system attempts to automatically detect symbol mappings across different platforms. If this process fails, you can contact us for assistance or define the mapping manually as described here.
{% endhint %}

The symbol mapping function allows users to establish a connection between symbols across different trading platforms. This feature is particularly useful when the symbols on the master and slave accounts differ but represent the same financial instrument.

By mapping symbols, the copier ensures accurate trade replication by recognizing equivalent symbols and executing trades accordingly. For example, if EUR/USD is represented as "EURUSD" on the master account and "EUR/USD" on the slave account, the symbol mapping function allows users to link these symbols, enabling seamless trade copying between accounts despite the symbol variations.

To show the current symbol mapping click on button on the copiers list.

<figure><img src="/files/DPofHy1xLkqmQ453kA06" alt=""><figcaption></figcaption></figure>

A new window opens with a list of symbols and their mapping. You can filter to the desired symbol.

<figure><img src="/files/ZqXvWOUa82hkzf74YBRK" alt=""><figcaption></figcaption></figure>

If a mapping is missing or wrong go to the **Symbol mapping** page and add a new mapping similar to the example provided.

<figure><img src="/files/TPVRgSYgDaUxPyeV4VRl" alt=""><figcaption></figcaption></figure>

## Settings

* **From symbol:** Specify the symbol name from the source trading platform.
* **To symbol:** Define the corresponding symbol name on the target trading platform.
* **From Broker (Regex):** Set a regular expression pattern to match symbols from the source broker. This allows for flexible matching of symbols based on patterns rather than exact matches
* **To Broker (Regex):** Establish a regular expression pattern to match symbols from the target broker, offering the same flexibility for symbol matching.
* **Priority:** Assign priority levels to symbol mappings. In case of multiple mappings matching a symbol, the priority determines which mapping takes precedence (lower number means higher priority).

{% hint style="info" %}
If you need some help with regex filters we have also [this page](https://docs.metacopier.io/tutorials/regex) with some examples
{% endhint %}

## AI-Assisted Symbol Mapping

### Overview

The AI-Assisted Symbol Mapping feature helps you automatically generate symbol mappings between master and slave accounts using artificial intelligence. This feature is particularly useful when you have missing symbol mappings that prevent proper trade replication between accounts.

### What It Does

When trades are replicated from a master account to a slave account, MetaCopier needs to know how symbols map between the two brokers. For example, "EURUSD" on one broker might be "EURUSD.m" on another. The AI Assistant analyzes the available symbols on both accounts and intelligently suggests the most appropriate mapping.

### How to Access

{% hint style="info" %}
**Important:** The AI Assistant can only map symbols that have been automatically detected as missing by the system. Missing symbols are detected during actual trade replication when a trade cannot be copied due to a symbol mismatch between master and slave accounts.
{% endhint %}

1. Navigate to your project's **Symbol Mappings** section
2. Click the **AI Assistant** button
3. The AI-Assisted Symbol Mapping dialog will open

### Using the AI Assistant

**Step 1: Select the Master Account**

Choose the master account (source) that has missing symbol mappings. The dropdown will only show accounts that have detected missing symbols.

**Note:** The system automatically detects missing symbol mappings when trades fail to replicate due to symbol mismatches.

**Step 2: Select the Missing Symbol**

After selecting a master account, choose which missing symbol you want to map. The dropdown will display all symbols that are currently unmapped for the selected account.

**Step 3: Review the Destination Account**

The "To Account" field automatically displays the slave (destination) account that needs the mapping. This is determined from the account that reported the missing symbol.

**Step 4: Generate AI Mapping**

Click the **AI Map** button to generate an intelligent suggestion. The AI will:

1. Analyze all available symbols on the master account
2. Analyze all available symbols on the slave account
3. Use pattern recognition and trading symbol conventions to suggest the best match
4. Display the suggested mapping in the "Suggested Mapping" field

**Step 5: Create the Mapping**

If you're satisfied with the AI suggestion:

1. Review the suggested mapping displayed in the "Suggested Mapping" field
2. Click **Create Mapping** to save it to your project
3. The mapping will be created with:
   * Source symbol: The missing symbol from the master account
   * Target symbol: The AI-suggested symbol
   * Broker pattern: `.*` (applies to all brokers by default)
   * Priority: 100