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",
  "price": 18250.5,
  "quantity": 2,
  "time": "2025-06-17T10:30:00Z"
}

Required Properties

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 properties, TradersPost won’t know what trade to place.

Recommended Properties

While not required, we strongly recommend also including:

• price — 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 Properties

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