# JSON Message Template Creator TradersPost uses [JSON messages](https://en.wikipedia.org/wiki/JSON) to receive and process trading instructions sent to a webhook URL. 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](https://docs.traderspost.io/docs/core-concepts/signals/webhooks) 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: ```json5 { "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](https://docs.traderspost.io/docs/core-concepts/signals/webhooks) page for all the possible fields you can send in a JSON message. ## Creating and Saving JSON Message Templates {% embed url="" %} 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](https://app.traderspost.io/app/trading/strategies). 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 {% embed url="" %} 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](https://www.tradingview.com/v/n8ss8BID/). For this indicator we'll need both a **buy** and a **sell** alert.

Screenshot of the UT Bot Alerts indicator with Buys and Sells

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)

UT Bot Alerts "Buy" Signal Settings Screenshot

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.

The JSON message pasted into the Message tab

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.

The webhook URL is checked and pasted in

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

UT Bot Alerts "Sell" Signal Settings Screenshot

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!