Symbol Not Found in MT5: Suffixes, Broker Names and Hidden Symbols
A "symbol not found" error in MT5 almost always means that TradingView and your broker spell the instrument differently. TradingView calls the euro-dollar pair EURUSD, while the broker's MT5 server might list it as EURUSD.raw, EURUSDm or EURUSD.a, gold can be XAUUSD on one side and GOLD on the other, and the Dow Jones can appear as US30, DJ30 or US30.cash. When an alert names a symbol the broker's server does not have, MT5 has nothing to price or trade.
In MQL5, the failure shows as error 4301, ERR_MARKET_UNKNOWN_SYMBOL, or as an EA message containing "symbol not found." With PineHook, the alert's row in Signal Logs names the symbol and tells you what to do next, for example Symbol 'EURUSD.x' not found at this broker. Verify the exact spelling in Market Watch, or add a Broker Symbol Mapping if your broker names it differently. The same message appears in the MT5 Experts tab.
Either way, the fix comes down to two options. You can send the broker's exact symbol name in the alert, or keep TradingView's name and let PineHook's broker symbol mapping translate it for each account. This guide covers both.
How to find the broker's exact symbol name in MT5#
Open View → Market Watch, right-click inside it and choose Show All, or press Ctrl+U to open the full Symbols list. Search for the instrument and note its name exactly as the broker writes it, including any dot, letter or number added to it, then right-click the symbol and open Specification to confirm it is the instrument you want.
Some brokers list several versions of the same market, such as a standard and a raw-spread contract, or a cash index alongside a futures-based one. Those versions can differ in spread, commission, contract size and trading hours, so choose between them deliberately rather than taking the first match.
Why MT5 symbol names differ from TradingView#
Suffixes and prefixes by account type#
Brokers often add a suffix to every symbol on a given account type, so the same broker might use EURUSD on one account and EURUSD.raw on another, and a few add a prefix instead. The suffix can also change between demo and live servers, or between the regional entities of the same broker, so check the account you are actually trading rather than the one in a guide or screenshot.
Different names for the same instrument#
Metals, indices and energies have no single standard name: gold appears as XAUUSD or GOLD, the Nasdaq 100 as NAS100, USTEC or US100, and Brent crude as UKOIL, BRENT or XBRUSD. A suffix rule cannot translate between these, so each one needs its own mapping.
TradingView tickers carry their own format#
TradingView symbols belong to a data feed and are written as EXCHANGE:TICKER, for example OANDA:XAUUSD or CME_MINI:ES1!, and the {{ticker}} placeholder sends only the part after the colon. A futures ticker such as ES1! will never match a broker's CFD name, and a ticker containing a slash, as some crypto pairs do, needs translating before any broker will recognise it.
The symbol exists but is hidden#
MT5 only streams prices for symbols shown in Market Watch. An EA can usually add a hidden symbol itself with SymbolSelect, but some EAs only look at visible symbols, so if the name is right and the error persists, show the symbol in Market Watch and try again. MQL5 reports a symbol that exists but is not selected with error 4302, ERR_MARKET_NOT_SELECTED.
Two ways to fix symbol not found for automated alerts#
The first option is to put the broker's name in the alert, which is simple and works well for a single account, but breaks as soon as the same alert has to reach a second broker that uses different names. The second is to translate on the receiving side, keeping TradingView's names in your alerts and letting the EA or bridge add the suffix or swap the name for each account, which is the better long-term setup because one strategy can then drive accounts at several brokers.
How PineHook maps symbols and explains mismatches#
PineHook is built around the second option. Broker symbol mapping lets you add a Suffix or Prefix for brokers that decorate every symbol and set Renamed instruments for those that use a different name, such as XAUUSD to GOLD, either for the whole account or per license, so each broker account gets its own translation while your TradingView alerts stay the same.
When a symbol is still missing, PineHook does not leave you with a bare error code. The EA rejects the alert and says which name it tried, and if mapping changed the name, the message shows both the name you sent and the name it became:
Symbol 'GOLD.r' not found at this broker. You sent 'XAUUSD' and Broker Symbol Mapping turned it into 'GOLD.r'. ...
That makes it immediately clear whether the alert or the mapping needs fixing, and the same message appears on the alert's Signal Logs row and in the Experts tab. You can create a PineHook account without payment details and set up mapping for your broker on a demo account.
Check symbols before going live#
Symbol names are one of the things most likely to differ between a demo account and a live one, so after switching accounts, send one small test alert for each symbol you trade and confirm the order lands on the instrument you expect. A mapping that resolves to the wrong contract, such as a futures-based index instead of the cash CFD, executes without any error at all, so the absence of an error does not prove the symbol is right.
FAQ#
Does MT5 care about upper and lower case in symbol names?
Match the broker's spelling exactly, including case, rather than relying on the platform to forgive differences, and write symbols in alerts the way the broker displays them.
Can PineHook guess the right MT5 symbol automatically?
No, by design. Guessing the closest name can pick the wrong contract, such as another account type's version of the symbol, and trade it without warning, whereas an explicit mapping is predictable and visible in your settings.
Does cTrader have the same symbol name problem?
Yes. cTrader brokers also use their own symbol names, and the same PineHook mapping fields apply to cTrader licenses.
Related guides#
- MT5 invalid volume
- Webhook delivered but no trade on MT5
- Broker symbol mapping
- Symbol not found in the trade errors reference
MetaTrader and TradingView are trademarks of their owners, and PineHook is an independent product that is not affiliated with, endorsed by, or sponsored by MetaQuotes or TradingView. Leveraged trading carries a high risk of loss, so test any automated setup on a demo account before you trade it live.
