JSON Messages

TradersPost uses JSON messages to receive and process trading instructions. If you're new to JSON, don't worry, it's simply a way to structure data in a format that's both machine-readable and easy for humans to understand.

Head to the webhooks documentation to see all the different types of JSON messages you can send.

What Is JSON?

JSON stands for JavaScript Object Notation. It’s a simple, text-based format for organizing data using key/value pairs. In TradersPost, JSON allows you to send your trading signals with clear instructions that define what to trade and how to trade it.

Here’s a very simple example of a JSON message that TradersPost would use:

{
  "ticker": "NQ1!",
  "action": "buy",
  "signalPrice": 18250.5,
  "quantity": 2,
  "time": "2025-06-17T10:30:00Z"
}

Required Fields

At minimum, every JSON message sent to TradersPost must include:

• ticker — The symbol you want to trade (e.g. NQ1! or MSFT)

• action — The trade action: buy, sell, exit, cancel or add

Without these two fields, TradersPost won’t know what trade to place.

Recommended Fields

While not required, we strongly recommend also including:

• signalPrice — The price at the time your signal fired

• time — A timestamp for when the signal was generated

Providing these values helps you maintain a full record of your signal and enables TradersPost to better track execution slippage and timing.

All Fields

See our entire webhook documentation page for all the possible fields you can send in a JSON message.

Creating and Saving JSON Message Templates

We've made JSON message creation easy with our JSON message template creator tool. It can be found on the "Submit Signal" page that is located in your strategy dashboard. Click the ••• icon next to Dashboard and navigate to "Submit Signal" and click it.

The area highlighted in red is how you can build your own JSON to not only submit manual orders to your strategy subscriptions but also to create JSON Signal Templates to save and reuse later.

Once you've selected how you want your trade to be formed, click Save Signal Template.

Here is a sample JSON message created for a buy entry order with a take profit of 20 points and a stop loss of 10 points.

{
    "ticker": "{{ticker}}",
    "action": "buy",
    "takeProfit": {
        "amount": "20"
    },
    "stopLoss": {
        "type": "stop",
        "amount": "10"
    },
    "signalPrice": "{{close}}",
    "time": "{{timenow}}",
    "interval": "{{interval}}"
}

Once you are finished creating your JSON, you'll choose a template name, select the signal source, and you'll then see the custom JSON message that you'll then save. Once it's saved, you'll copy and paste the signal template JSON into your alert in Tradingview (or your signal source if different than Tradingview).

Saved signal templates will appear at the bottom of the Submit Signal page where you can easily copy, edit, and delete them.

Using a Saved JSON Template In Your Alert

Once you've saved your reusable JSON templates it's time to create your alerts. This example will be for a Tradingview indicator called UT Bot Alerts. For this indicator we'll need both a buy and a sell alert.

First, we'll need to add a new alert. Click the + icon in the "Alerts" area (in the clock tab on the right side of your Tradingview window)

This first alert will be for the buy. We'll choose the indicator in the condition dropdown (in this example: UT Bot Alerts), then the long (buy) condition, once per bar close, and make sure our expiration is open ended or as far out as we can choose if you don't have a plan which supports open ended alerts.

We'll copy the previously made JSON template for the Indicator Buy w/ Take Profit and Stop Loss and paste it into the Message tab in our buy alert.

Finally, we'll go to our TradersPost strategy dashboard, click the Webhook button, and copy the webhook URL to paste into the third tab of our buy alert.

We'll click Copy on the Strategy Webhook module that pops up.

Finally, we'll paste that into the Notifications tab on our buy alert in the Webhook URL section.

Last step is to repeat this process for the sell alert. First, we click the + button again.

We'll choose the indicator in the condition dropdown (in this example: UT Bot Alerts), then the short (sell) condition, once per bar close, and make sure our expiration is open ended or as far out as we can choose if you don't have a plan which supports open ended alerts.

We'll copy the previously made JSON template for the Indicator Sell w/ Take Profit and Stop Loss and paste it into the Message tab in our sell alert.

Finally, we'll paste that same webhook URL into the Notifications tab on our sell alert in the Webhook URL section.

Once you've created both alerts, you'll start seeing the alerts populate your Tradingview Alert Log which can be accessed by clicking the "Log" tab on the top of the Tradingview Alert area.

You'll also see your trades populate your signal list in the Strategy dashboard for your specific strategy in TradersPost.

If you have questions or run into issues while creating alerts, JSON messages, or anything else related to TradersPost, you can contact us using the chat icon in the bottom right corner of your TradersPost Dashboard and we'll be glad to help!