Your First Automated Trade
Get from zero to a working automated trade in under 10 minutes.
This guide walks you through one thing: sending a single market order from TradingView to NinjaTrader through CrossTrade. No strategies, no brackets, no advanced options. Just a working alert that places a trade. Once this works, everything else builds on top of it.
CrossTrade does more than webhooks — the Trade Copier, Account Manager, REST API, and VPS hosting all work independently. This guide focus on the TradingView-to-NinjaTrader webhook path, but you're not limited to it.
What You Need Before Starting
You need three things set up before your first alert will work:
A CrossTrade account with an active subscription or free trial. If you don't have one, start your free 7-day trial.
NinjaTrader 8 installed and connected to at least one data feed. This can be a sim account, a prop firm evaluation account, or a live broker connection. You need the data feed active — NT8 won't execute orders without one. Level 1 data is sufficient; Level 2 is not required.
If the markets are closed, connect to the 'Simulated Data Feed' to use dummy data.
A TradingView account with 2FA enabled. Webhooks require two-factor authentication. If you haven't enabled it, TradingView will prompt you the first time you try to set up a webhook.
Step 1: Install the XT Add-On
Download the XT Add-On from your CrossTrade dashboard. In NinjaTrader, go to Tools > Import > NinjaScript Add-On and select the downloaded file.
Before you restart, enable the Automated Trading Interface: go to Tools > Options > Automated Trading Interface and make sure it's turned on. Click Apply, then OK.
Now restart NinjaTrader.
After the restart, open the XT Add-On and log in with your CrossTrade email and password.
If you see a green connection indicator, you're connected. If you get an import error mentioning duplicate methods, it's almost always an OneDrive conflict — NinjaTrader and OneDrive don't play nice together. Unzip the add-on contents manually to Documents\NinjaTrader 8\bin\Custom\ and restart.
For the full installation walkthrough with screenshots, see the Installation docs.
Step 2: Find Your Webhook URL and Secret Key
You need two things from your CrossTrade account:
Your Webhook URL — this is the address TradingView will send alerts to. Find it on your My Account page or on the web dashboard below the Webhook Trader.
Your Secret Key — this authenticates your alerts. It's on the same My Account page.
Copy both somewhere you can paste from. You'll need the secret key in the alert message and the webhook URL in the alert notification settings.
Step 3: Build Your First Alert Payload
Open a chart in TradingView. It doesn't matter which instrument — we'll specify the instrument in the alert message, not through the chart.
Click the alert icon (the clock button on the right sidebar or the alarm icon in the top toolbar) to open the alert creation window.
Set the Condition: For testing, use something simple that will trigger quickly. You can set it to the chart's price crossing above or below a nearby price level, or use CrossTrade's free test indicator which fires a signal on every bar.
Set the Alert Message: This is the critical part. Delete everything in the message box — all of it. TradingView pre-fills this with default text from your indicator or strategy, and that text will break your alert. The message must contain only the CrossTrade command.
Paste the following, replacing your-secret-key with your actual key and Sim101 with your actual account name:
flatten_first=true; is included so that each time the alert fires, it closes any existing position before opening a new one. This prevents stacking positions during testing.
To make life easy you can simply copy the preloaded message in your Webhook Trader. Your secret key is already provided with all of the Command Examples on the Webhooks dashboard.
That's it. Every line ends with a semicolon. The instrument uses TradingView's continuous contract format (ES1!), which CrossTrade will automatically convert to whatever format your NinjaTrader account expects.
For step-by-step alert creation made easy, check out the Automation Wizard
Step 4: Add the Webhook URL
Switch to the Notifications tab in the alert window. Check the Webhook box and paste your CrossTrade Webhook URL.
If this is your first time using webhooks, TradingView will prompt you to enable 2FA. Follow the prompts, then come back and paste the URL.
Save the alert.
Step 5: Verify It Worked
When the alert fires, three things should happen almost simultaneously:
TradingView logs the alert in its alert history (click the clock icon to see it and then switch to Log).
CrossTrade Alert History shows the received alert with a status. Go to Alert History on the web dashboard. You should see your alert with a green "Success" status. If it shows red, the status message will tell you what went wrong — usually a formatting issue or account name mismatch.
CrossTrade Add-On shows the recieved alert with details on what was recieved. You will also see exact time stamps on when the alert was recieved and how long it took to process.
If the trade executed, congratulations — you have a working webhook pipeline. Everything from here is about customizing what you send through it.
Troubleshooting Your First Alert
If it didn't work, here's the diagnostic path:
Alert didn't show up in CrossTrade Add-on or Alert History at all: The webhook URL is wrong or TradingView didn't send it. Double-check the URL on the Notifications tab. Make sure it's your personal webhook URL, not a generic example.
Alert shows "Improperly formatted request": The payload has a syntax problem. The most common mistakes: a missing semicolon at the end of a line, leftover default text from TradingView still in the message box, or a misspelled field name. Compare your message character-by-character against the example above.
Alert shows "Account not found": The account name in your alert doesn't match any connected account in NinjaTrader. Open the Accounts tab in NinjaTrader and check the exact name and verify connection. If this is a newly created account, you will need to restart NinjaTrader.
Alert shows "Secret key missing, invalid, or inactive": Re-copy the key from your My Account page. Watch for invisible characters or trailing spaces that can get picked up during copy-paste.
Alert shows success but no trade appeared in NT8: Make sure the XT Add-On is open and logged in, that you're connected to a live data feed, and that the instrument is valid (not an expired contract).
What You Just Built 🏆
That single alert command contains the same core structure that every CrossTrade automation uses, from simple one-shot orders to complex multi-account strategy sync setups. The fields you used — key, command, account, instrument, action, qty, order_type, tif — are the required foundation. Everything else is optional enhancements layered on top.
From here, the next step depends on what you're trying to automate:
Automating a TradingView strategy with entries, exits, and position tracking → Guide 2: Automating a TradingView Strategy
Automating a TradingView indicator with separate buy/sell alerts → Guide 3: Automating a TradingView Indicator
Copying trades across multiple accounts (especially prop firm evals) → Guide 4: Managing Multiple Accounts
Adding stop losses, take profits, and ATM strategies to your alerts → Guide 5: Exit Management
Or explore the full command reference and advanced options to build your own setup.
Last updated