Skip to content
MERIDIAN

Getting started

Set up Meridian in about twenty minutes

From a fresh NinjaTrader install to your first copied trade — and the alerts and phone app that keep you informed. Once you have signed up, the dashboard also walks you through these steps with a checklist.

1 · Install the Meridian add-on

Meridian runs inside NinjaTrader 8 as an add-on. There is no separate program to install and no server to rent.

  1. Download it from the Download page. Keep the file zipped.
  2. Import it: in NinjaTrader's Control Center, choose Tools → Import → NinjaScript Add-On… and select the file. If asked whether to replace an older version, choose Yes.
  3. Restart NinjaTrader, then open Meridian from New → Meridian Signal Desk.

That's the whole install. Updating works the same way, and keeps your settings and connection.

2 · Connect your PC to your account

In the Meridian window, find Sign in & pair and sign in with your Meridian username and password. That's it — the PC is now linked to your account and reconnects by itself whenever NinjaTrader starts.

The connection is encrypted and goes out from your PC, so there is nothing to change on your router or firewall.

One PC takes your signals. Your TradingView alerts and dashboard orders always go to a single PC — your main one — so two machines can never place the same trade. If your plan allows more than one PC, the others run Twin Desk: they follow your main PC's positions but never receive signals themselves.

Moving to a new PC? Install Meridian there and sign in. With one PC on your plan, your account moves to the new PC and the old one is signed out. With more, the new PC is added beside the old one: open Copier Setup → Your linked PCs and choose Make primary on it, then remove the old one if you no longer need it.

3 · Set up copying

Open the dashboard and go to Copier Setup. Your NinjaTrader accounts appear on the board.

  1. Choose a leader — the account you will trade yourself.
  2. Drag followers under it. Click any follower to set its size (for example half, or micros), its daily limits and its safety rules.
  3. Set a protective stop. In the Max stop loss card, choose how far from entry a stop should rest at your broker on every copied position. It protects you even if your PC goes offline.
  4. Start the copier from the dashboard. From now on, whatever you trade on the leader is copied to every follower.

4 · Connect TradingView (optional)

If you trade from TradingView alerts, two things connect them to Meridian. (What an alert can do, with worked examples, is on the webhooks page.)

  1. Your signal address. Copy it from Profile → Your signal endpoint and paste it into the alert's Webhook URL field. It is private to your account — signals sent to it reach only your copier.
  2. The alert message. The dashboard writes it for you: open Live Console, scroll to TradingView strategy alert, and copy the message into your alert. Replace YOUR_LISTENER_SECRET with the secret shown on Copier Setup → Webhook listener — it confirms the alert came from you.

A typical message looks like this:

{"secret":"YOUR_LISTENER_SECRET","account":"YOUR_LEADER_ACCOUNT","instrument":"{{ticker}}","action":"{{strategy.order.action}}","orderType":"Market","quantity":{{strategy.order.contracts}}}

Not sure it's right? The Live Console can send a test order to a simulation account and show you exactly what the copier did with it.

Late alerts are handled safely. If an alert arrives too late to enter at a sensible price (three seconds by default, adjustable), Meridian doesn't place it — it tells you, and you can resend it on purpose. Exits always go through.

Advanced: every field an alert can include

Stops and targets, scaling out, sizing by risk, break-even and trailing stops, and keeping an account in step with a TradingView strategy.

Field Required Meaning
secret yes Listener secret. A post without it is refused.
account yes Which connected account is the leader. Several, comma separated ("A1,A2,A3"), cycle: the alert goes to the account already in a position on the instrument, else the first one that is connected and not locked — when one hits its daily limit, the next signal goes to the next. AddOn 4.30.0.
instrument yes Symbol, root or contract. Fuzzy-matched to what is connected.
action yes Buy, Sell, SellShort, BuyToCover (any case — TradingView's {{strategy.order.action}} works), or Flatten.
quantity yes Contracts, a whole number. Followers scale this by their multiplier. With riskUsd / riskPct it is the most an entry may be.
orderType yes Market, Limit (with limitPrice) or StopMarket (with stopPrice).
profitTicks / stopLossTicks no A take-profit and stop placed with the entry, in ticks.
profitPoints / stopLossPoints
profitUsd / stopLossUsd
no The same exits in points, or in dollars per contract — converted to whole ticks on the order’s own instrument (a stop rounds toward the entry, so it never risks more than you wrote). A tick field wins when both are sent. AddOn 4.29.0.
riskUsd / riskPct no Size an entry from its risk instead: the contracts that lose at most riskUsd dollars, or riskPct% of the account, at the stop. Needs a stop; quantity is then the most it may be, and what an exit closes up to. AddOn 4.29.0.
targets no Scale out: up to 5 targets, e.g. [{"ticks": 20, "qty": 1}, {"points": 10}] — each ticks, points or usd, with a qty (a target without one shares what the others leave). Each target gets its own stop, one-cancels-the-other, so a filled target takes its stop with it. AddOn 4.29.0.
breakevenTicks / breakevenOffsetTicks no Once the position is that many ticks in profit, its stop moves to the entry (plus the offset). Needs a stop in the alert. AddOn 4.29.0.
trailTicks / trailStartTicks no The stop trails that many ticks behind the best price since the fill, starting once it is trailStartTicks in profit (0 = at once). Checked every 2.5 seconds; a stop only ever moves toward the market. AddOn 4.29.0.
strategy no Picks a per-strategy secret, or kill-switches that one strategy.
id no Alert id. With the duplicate guard on, a repeat inside the window is dropped.
signalPrice no The price TradingView saw — {{strategy.order.price}}, or {{close}} via price. Recorded on the signal's journal line for the TradingView vs reality report. Never used to place the order; text that is not a number is ignored.
market_position no Strategy sync: {{strategy.market_position}} — the strategy's position after this order. With it, a sell that closes a long is never sent to an account that is already flat (it would open a short), and an exit closes what the account holds without ever reversing it.
prev_market_position no Strategy sync: {{strategy.prev_market_position}} — the position before it, so an entry is checked against the account too.
position_size no Strategy sync: {{strategy.position_size}} — the size after the order, so the check covers contracts, not just direction.
out_of_sync no Strategy sync, for an entry that does not fit the account: wait (default — not placed), flatten (close and wait for the next entry) or resync (send what matches position_size). Exits are never refused while there is something to close.

5 · Turn on alerts and the phone app

All of this lives on your dashboard's Profile page, under Alerts.

  • Email is on from the start, for the alerts you choose.
  • Push notifications: on each phone or computer that should get them, open the dashboard and choose Turn on notifications on this device. On iPhone, add the dashboard to your Home Screen first (below) and turn them on from there.
  • Telegram (Pro): in Telegram, message @BotFather, send /newbot and paste the token it gives you into Meridian. Send your new bot a message, then press Find my chat. Alerts now arrive in that chat, and you can send it /status, /pause, /resume and /flatten.
  • Your own alerts: add rules for a daily loss or target, profit given back, or a strategy that has gone quiet.
  • Copy problems (Pro): you're told when a copy couldn't be placed, was held by one of your rules, or filled well off the leader's price. Choose how many ticks of slippage is worth an alert.
  • Pre-market brief (Pro): switch it on to get one message at 8:45 am New York on weekdays — whether your copier PC is on, yesterday's P&L, each prop account's room above its drawdown limit and today's news. Send me today's brief now shows you one straight away.

Install the phone app. Open the dashboard on your phone and sign in. On iPhone, tap Share → Add to Home Screen in Safari; on Android, tap the menu and choose Install app in Chrome. It opens straight to your P&L, positions and a one-tap flatten.

6 · Test it on a simulation account

Before going live, make a simulation account a follower and keep the leader on simulation too. Place one trade, or send one alert, and open the Journal: you'll see the trade received, copied to the follower and filled.

Want to see what an account would do without placing anything? Switch on Test mode for that follower. The journal records every trade it would have made, and nothing reaches the account.

Once it behaves the way you expect, add your real accounts one at a time. Each can have its own size and rules, so you can bring a new account in carefully while the others keep running.

7 · Connect an AI assistant Max

On the Max plan, any assistant that supports MCP — Claude, ChatGPT, Cursor and others — can read your desk, and trade with your approval.

  1. Create a link. In the dashboard, open Profile → AI assistants. Name it, choose Look only or Look and trade, and set any limits: which accounts and instruments it may use, and its largest order. Press Create link and copy the link — it is shown only once.
  2. Add it to your assistant. In Claude, open Settings → Connectors → Add custom connector and paste the link. In ChatGPT, add it under Settings → Connectors (developer mode). Other assistants have a similar "add MCP server" setting.
  3. Ask away. Try "How are my accounts doing today?" or "Why did my follower miss the last trade?".
  4. Approve trades. When a trading link asks to place an order, flatten or pause copying, you get the request in Telegram and on the dashboard with Approve and Cancel. Nothing happens until you approve, and a request you ignore expires after two minutes. Connect Telegram first (section 5) so the requests reach your phone.

Treat the link like a password. If it is ever shared by mistake, press Revoke next to it and create a new one. Every request an assistant makes is listed under What assistants did.

The full guide has step-by-step instructions for Claude, ChatGPT, Claude Code, Cursor, VS Code and other assistants, what to ask, and troubleshooting.

Troubleshooting

The dashboard says no PC is connected

Make sure NinjaTrader is open with the Meridian window running, and that you signed in there with the same account you use on the dashboard. Use Sign in & pair in the Meridian window to sign in again.

My TradingView alert isn't placing trades

Almost always the listener secret in the alert message. Copy it again from Copier Setup → Webhook listener and paste it in place of YOUR_LISTENER_SECRET. Check the webhook URL matches Profile → Your signal endpoint exactly. The Journal shows each alert Meridian received and why it was or wasn't traded.

A follower doesn't match its leader

Look at the follower's row on the dashboard. Held means one of your rules stopped it — a daily limit or trade cap, for example — and the Journal names which. Flat means there's no position to match. If the copier is stopped, start it from the dashboard.

I was warned that a leader looks frozen

A leader that shows as connected but whose numbers haven't moved for a long time may have lost its data feed. Meridian warns you once and leaves the position alone. Check that PC's broker connection.

Alerts are waiting instead of trading

If your PC is briefly offline, Meridian holds incoming alerts for a short time while it reconnects instead of dropping them. Check that NinjaTrader is running and the Meridian window shows the signal listener as on.

Still stuck?

Use Report a problem in the dashboard — it attaches what we need to help — or email hello@meridiansignaldesk.com.