How to Automate Position Closures with TradersPost Scripts

Closing open positions at a specific time is a frequent request among traders, especially for strategies that prioritize end-of-day risk management. TradersPost now offers a customizable script to handle this task. This guide explains how to use the "Close All Positions" script to automate trade exits based on specific times, ensuring streamlined execution and reduced manual intervention.

What Is the Close All Positions Script?

The "Close All Positions" script is a tool designed to:

1. Automate position closures for the specific symbol displayed on your TradingView chart.
2. Enable time-based closures by defining a specific hour and minute.
3. Simplify alert creation with preconfigured JSON messages sent to TradersPost via webhooks.

How It Works

Key Features

• Symbol-Specific Actions: The script applies only to the symbol on your TradingView chart (e.g., ES1!).
• Action-Based Alerts: Sends an action=exit JSON payload to close all contracts or shares for the selected symbol.
• Configurable Timing: Users can set the exact time (hour and minute) for the closure within the script’s settings.

Example Workflow

1. Script Configuration
   • Define the hour, minute, and time zone for the closure.
   • Input the desired JSON message in the script settings, under “Inputs.”
2. Alert Setup
   • Create an alert in TradingView.
   • Choose the "Close All Positions" script as the alert condition.
   • Ensure your webhook URL is correctly configured in the alert’s notification tab.
3. Execution
   • At the specified time, the alert triggers, sending the JSON payload to TradersPost.
   • TradersPost looks up the current position for the specified symbol and executes the closure.

JSON Message Example

When creating alerts, the script sends a JSON message like this:

{
   "ticker": "ES1!",
   "action": "exit"
}


What This Does

• ticker: Specifies the symbol (ES1! in this case).
• action: Tells TradersPost to exit all open positions for the symbol.

If you have three contracts open for ES1!, this message will close all three. To close only part of the position, add a quantity to the exit message: "quantity": 2 exits two contracts, and a quantity larger than the open position exits all of it¹. TradersPost uses that quantity only when Allow signal override is checked next to the quantity settings in your strategy subscription; otherwise it exits the full position².

Important Considerations

Chart Resolution Limitations

The script uses TradingView’s chart resolution to place markers.

• If the chart resolution doesn’t match the specified time (e.g., a 15-minute chart with a 3:07 PM closure), no alert fires and no marker appears, because the script's source code triggers only on a bar that opens at the chosen hour and minute³.
• Create the alert on a chart whose resolution matches your time granularity (e.g., a 1-minute chart), so a bar opens at the chosen minute.

Validation Tools

• Markers on Chart: Visual confirmation that the script will trigger correctly.
• Pine Logs: Console logs in Pine Script show when the script executes, adding another layer of verification.

Creative Applications

While designed for end-of-day closures, the script’s flexibility allows for creative uses, such as:

• Mid-session risk management.
• Closing positions before economic announcements.
• Custom JSON payloads for advanced strategies.

Conclusion

The "Close All Positions" script bridges the gap between TradingView and TradersPost, providing an efficient solution for time-based position closures. By leveraging its customizable settings and webhook capabilities, traders can automate critical exit actions, ensuring consistency and reducing manual oversight. If you’re ready to optimize your trade management, this script is a must-try tool.

References

¹ docs.traderspost.io, Signal Message Reference
² docs.traderspost.io, Position Sizing
³ tradingview.com, Close All Positions