Appearance
Are you an LLM? You can read better optimized documentation at /core-concepts/symbol-mapping.md for this page in Markdown format
Symbol Mapping
One of the most common challenges in copy trading is that Telegram channels and Brokers often speak different languages.
- Channel says:
GOLD,Gold,XAUUSD,Gold Spot - Broker uses:
XAUUSD,XAUUSD.m,Gold.pro,XAUUSD_i
If the bot tries to open a trade for GOLD on a broker that only knows XAUUSD.m, the trade will fail. Symbol Mapping is the bridge that solves this.
How it Works
When a signal arrives, TTMT follows this logic:
- Direct Match: Does the broker have a symbol with the exact same name? (e.g.,
EURUSDmatchesEURUSD). - Auto-Normalization (Gold Only): For gold trading, TTMT automatically maps common signal names (
GOLD,GOLDSPOT,XAU,GOLD SPOT) to your broker's gold symbol (typicallyXAUUSDor variants likeXAUUSD.pro). This happens automatically during account setup. - Manual Map: For all other symbols, you must create manual mappings in Settings → Symbol Mappings.
Symbol Discovery & Manual Mapping
TTMT can automatically discover symbols from your broker account. When you first connect a MetaTrader account, the system fetches all available symbols and stores them.
Creating a Manual Map
If trades are failing with "Symbol not found" errors, you likely need to create a manual map.
- Go to Settings → Symbol Mappings in the sidebar.
- Click "Discover Symbols from Broker" to refresh your broker's available symbols.
- Click Add Mapping to create a new mapping.
- Signal Symbol: Enter exactly what the channel uses (e.g.,
US30). - Broker Symbol: Select from your broker's available symbols (e.g.,
DJ30.mini). - Save.
Now, whenever a channel sends a signal for US30, TTMT will execute it as DJ30.mini on your account.
Common Mappings
Here are some standard mappings you might need, depending on your broker:
| Asset | Common Channel Names | Common Broker Names | Auto-Mapped? |
|---|---|---|---|
| Gold | GOLD, XAUUSD, Gold Spot | XAUUSD, XAUUSD.m, Gold | ✅ Yes |
| Dow Jones | US30, DJ30, Dow | US30, .US30Cash, DJI | ❌ Manual |
| Nasdaq | NAS100, US100, Nasdaq | USTEC, US100.cash | ❌ Manual |
| S&P 500 | SPX500, US500 | US500, SPX | ❌ Manual |
| Oil | USOIL, WTI, Crude | WTI, XTIUSD, USOIL | ❌ Manual |
INFO
Gold Auto-Mapping: Gold is the only symbol with automatic normalization. All other symbols (indices, forex pairs, commodities) must be manually mapped in Settings → Symbol Mappings.
Pro Tip:
Always check the Signals Log if a trade fails. It will show you exactly what symbol the channel sent and what symbol TTMT tried to execute.