Translate TradingView instrument names to the symbols used by each MT5 or cTrader broker with prefixes, suffixes, and explicit mapping rules.

For an alert to execute, its symbol must match the name used by your broker, but brokers often write symbols differently from TradingView. For example, TradingView may use EURUSD while your broker calls the same market EURUSD.micro, i.EURUSD or EURUSDm.

PineHook's symbol mapping translates the TradingView symbol into your broker's format before sending the order. Your direct alerts and symbol filters keep the TradingView name. Signal Logs shows the symbol sent in a direct alert, although a failure reason may mention the broker name. On cTrader, Open Positions and Analytics may show the broker name for a broker-reported fill or close. Trade Copier uses the alert name or a unique reverse mapping for cTrader events. If it cannot identify one TradingView name, it skips the copied event.

Most people never need this

All the fields default to empty, and empty means no translation happens. If your trades are executing, you can skip this page.

Do you need it?#

Open MT5's Market Watch or cTrader's symbol list and compare the broker's spelling with the tickers in your TradingView alerts.

Names match exactly: nothing to do.
Names carry an extra prefix or suffix: set that affix.
Your broker uses a different name for the instrument: add a rename.

If an alert reaches PineHook but fails because the symbol is unavailable, compare the symbol in your alert with the name used by your broker. When the names differ, use symbol mapping to translate between them. Symbol not found in MT5 lists the common suffixes and renamed instruments to look for.

Where to set it#

Symbol mapping is configured from the Licenses page in your PineHook dashboard.

To set the mapping for your account, find Default trading settings, click Edit defaults, open Symbols and mapping, and complete the Broker symbol mapping fields. This mapping applies to every license that does not have its own.

To configure one license, open its three-dot menu, choose License Settings, and select Symbols and mapping. When you first edit a mapping field, PineHook copies the current account mapping into the license form, where you can change only what differs before clicking Save Changes.

If an MT5 license uses MetaTrader as its Settings Source, configure its mapping in the EA Inputs instead.

Platform and mode	Configure it in
cTrader	Dashboard trading settings
MT5 with Dashboard settings source	Dashboard trading settings
MT5 with MetaTrader settings source	EA Inputs, under Broker Symbol Mapping

For MT5, the dashboard and EA mappings are never combined. The selected Settings Source decides which one is read.

Mapping fields#

Prefix is text added to the front. A broker listing i.EURUSD needs i.

Suffix is text added to the end. A broker listing EURUSD.micro needs .micro

Renamed instruments handle brokers that use a different name for an instrument, which affixes cannot express. Each rule maps one TradingView symbol to one broker symbol.

Most accounts need a suffix and nothing else. Each broker symbol can have only one TradingView rename. Follow the same rule when entering MT5 EA Input mappings. If an alert uses a broker name that is already the destination of another rename, PineHook refuses the ambiguous alert; send the intended TradingView name instead.

Example: a broker that suffixes everything#

Your broker lists every instrument with .micro. Set the suffix to .micro and you are done.


Your alert	`LICENSE,buy,EURUSD,size_lots=0.1`
Sent to the broker	`EURUSD.micro`
Alert symbol in Signal Logs	`EURUSD`

Example: a broker that renames one instrument#

This broker adds .r to its symbols and lists the Dow as DJ30.r instead of US30. Use the suffix for symbols that keep their TradingView name, then enter the Dow's complete broker symbol in the rename because a rename bypasses the suffix:

Prefix:  (empty)
Suffix:  .r
Rename:  US30 -> DJ30.r

Alert says	Broker receives	Why
`EURUSD`	`EURUSD.r`	No rename matched, so the suffix applies
`US30`	`DJ30.r`	The complete rename is used; the suffix is not added again

A rename replaces the whole symbol

A matching rename skips the prefix and suffix entirely. That is why the example above maps to DJ30.r and not DJ30. Write the broker's full symbol exactly as the platform shows it, including any affix.

Per-license mapping#

Using several brokers? The Trade Copier overview explains how separately configured accounts receive the same alert.

Each license can have its own mapping. Use this when your licenses run on different brokers.

A license mapping becomes independent

PineHook saves the copied prefix, suffix and renames as one mapping for that license. Later changes to the account mapping will not alter it. Select Use account mapping if you want the license to inherit from the account again.

The Licenses page marks any license with its own mapping, so you can see at a glance which ones are not following the account settings.

If it still fails#

Compare the resolved name against MT5's Market Watch or cTrader's symbol list. Check the full prefix or suffix and the exact spelling. On cTrader, broker names are looked up without regard to case.
Confirm the instrument is available to that broker account.
On MT5, check your Settings Source. A dashboard mapping does nothing while the EA is in MetaTrader mode, and vice versa.
For a rename, confirm the broker column contains the complete symbol including any affix.
If a mapped name is absent from the broker's symbol list, PineHook rejects the trade even if the broker lists the original alert name. Correct the mapping to the intended broker symbol before resending the alert.
If cTrader license settings are temporarily unavailable, symbol mapping cannot be verified and the command is refused. Retry after settings recover.
If a copied event is missing, check that its broker symbol has one clear TradingView name in the source mapping. Events with ambiguous names are kept in trade history but are not sent to followers.