Skip to main content

Understanding Webhooks

A webhook is a way for one application to send real-time data to another. In the context of trading, it's how TradingView tells CrossTrade that something happened — like a buy signal firing.

The Simple Version​

Think of a webhook as a text message between apps:

  1. You set up an alert on TradingView with a message like command=place; action=buy; qty=1;
  2. When the alert triggers, TradingView sends that message to a URL you provide
  3. CrossTrade receives the message at that URL and forwards the instructions to NinjaTrader
  4. NinjaTrader places the order

The URL is your webhook URL — it's unique to your CrossTrade account and acts as your personal mailbox for trading commands.

Why Webhooks?​

Before webhooks, automating trades between platforms required complex API integrations, custom scripts, and constant maintenance. Webhooks simplify this to: write a message, point it at a URL, done.

Anatomy of a Webhook Message​

Every CrossTrade webhook message is a series of key-value pairs separated by semicolons:

key=your-secret-key;
command=place;
account=Sim101;
instrument=ES1!;
action=buy;
qty=1;
order_type=market;
tif=day;

Each field tells NinjaTrader exactly what to do. The Commands section of the docs covers every available option.

Security​

Your webhook URL contains a unique identifier tied to your account. Additionally, every message must include your secret key — a private token that verifies the message came from you. Without the correct key, CrossTrade rejects the message.

danger

Never share your webhook URL or secret key publicly. Anyone with access to them could send orders to your account.

Next Steps​