Proteryx webhook message format for TradingView alerts.
This guide explains the Proteryx webhook message format used with TradingView alerts and Auto Traders. You will learn where to paste the webhook URL, how to use the JSON snippet, what each field means, and how to test the message before using live futures automation.
Webhook URL:
https://api.proteryx.com/tradingview/auto-traders/alert
Message:
{
"strategy_uuid": "example-030b-472b-96b0-3ced09a57229",
"time_now": "{{timenow}}",
"close": "{{close}}",
"exchange": "{{exchange}}"
}
What the Proteryx webhook message format does.
The Proteryx webhook message format is the JSON payload that TradingView sends to Proteryx when an alert fires. Proteryx reads the message, identifies the Auto Trader through the strategy UUID, and receives TradingView values such as time, close price, and exchange.
Webhook URL
The webhook URL tells TradingView where to send the alert. For Auto Traders, use the Proteryx endpoint shown in the app.
JSON message
The JSON message carries the fields that Proteryx needs to read the alert and match it to the right automation.
Strategy UUID
The strategy UUID links the TradingView alert to the specific Auto Trader created inside Proteryx.
Before you paste the Proteryx webhook message format.
Before you paste the webhook message into TradingView, make sure the related Proteryx setup is complete. This helps avoid failed alerts or alerts that route to the wrong automation.
- Your Proteryx Auto Trader has been created in the Automations menu.
- The Auto Trader has the correct type, such as Strategy or Indicator.
- The correct trading portfolio has been added to the Auto Trader.
- You copied the webhook URL from the Proteryx finish step.
- You copied the snippet from the correct Auto Trader, not from a different automation.
- You are ready to test one small alert before using live size.
Copy the Proteryx webhook URL and message snippet.
Use the webhook URL in the TradingView webhook field. Then, paste the JSON snippet into the TradingView alert message field.
https://api.proteryx.com/tradingview/auto-traders/alert
{
"strategy_uuid": "example-030b-472b-96b0-3ced09a57229",
"time_now": "{{timenow}}",
"close": "{{close}}",
"exchange": "{{exchange}}"
}
Proteryx webhook message format field breakdown.
Each field in the message has a specific purpose. These cards explain what Proteryx expects and how you should treat each value.
Auto Trader ID
Example: example-030b-472b-96b0-3ced09a57229. This identifies the Auto Trader that should receive the alert.
Alert time
Example: {{timenow}}. This sends the TradingView alert time into the message.
Close price
Example: {{close}}. This sends the current close price value from TradingView.
Exchange source
Example: {{exchange}}. This sends the TradingView exchange value for source context.
TradingView variables inside the Proteryx webhook message.
TradingView can replace placeholders such as close, exchange, and timenow when the alert fires. Therefore, do not type a fixed value if you want TradingView to pass the live alert value.
{{timenow}}
This TradingView placeholder sends the alert time. It helps you identify when the alert fired.
{{close}}
This placeholder sends the close price value from the chart at the time of the alert.
{{exchange}}
This placeholder sends the TradingView exchange value. It can help identify the alert source.
strategy_uuid
This value is not a TradingView placeholder. It should come from the Proteryx Auto Trader setup.
Keep the Proteryx webhook message valid JSON.
The Proteryx webhook message format should be valid JSON. A missing quote, comma, or bracket can break the alert message and stop the automation from reading it correctly.
- Use double quotes around field names and string values.
- Do not remove the opening and closing curly braces.
- Keep commas between fields, but do not add an extra comma after the last field.
- Keep TradingView variables inside double curly braces, such as {{close}}.
- Use the exact strategy UUID from the correct Proteryx Auto Trader.
- Do not paste private account credentials into a TradingView alert message.
Test the Proteryx webhook message before live automation.
After you paste the webhook URL and message into TradingView, run one small test. The goal is to confirm that TradingView sends the alert, Proteryx receives it, and the Auto Trader connects the message to the right automation.
- Create or open the TradingView alert.Use the chart, strategy, or indicator that should trigger the alert.
- Paste the Proteryx webhook URL.Use the webhook URL field in TradingView and paste the URL exactly.
- Paste the JSON message.Use the message box and paste the Proteryx webhook message format.
- Trigger one small test.Use one alert, one Auto Trader, one route, and small size.
- Review the result.Check Proteryx, your broker workflow, account, symbol, and order behavior.
Proteryx webhook message format troubleshooting.
If the alert does not work, check the basics first. Most issues come from the wrong webhook URL, invalid JSON, a mismatched strategy UUID, or a TradingView alert that did not fire.
Webhook does not arrive
Check that the TradingView webhook URL is enabled and pasted exactly as shown by Proteryx.
Message is rejected
Check JSON formatting, quotes, commas, curly braces, and the exact strategy UUID.
Wrong Auto Trader triggers
Confirm that the strategy UUID belongs to the Auto Trader you intended to use.
Order does not send
Check the broker connection, portfolio route, symbol, account status, market session, and risk settings.
Next Proteryx guides after the webhook message format.
After you understand the Proteryx webhook message format, continue with the setup guides that are already live and ready to use.
Proteryx webhook message format FAQ.
Where do I paste the Proteryx webhook URL in TradingView?
Paste the Proteryx webhook URL into the webhook URL field inside your TradingView alert settings. Then paste the JSON snippet into the alert message field.
What is the Proteryx Auto Trader webhook URL?
The Auto Trader webhook URL shown in this guide is https://api.proteryx.com/tradingview/auto-traders/alert. Use the URL shown by your Proteryx app setup when creating your automation.
What does strategy_uuid mean?
The strategy_uuid identifies the specific Auto Trader in Proteryx that should receive the TradingView alert.
Can I reuse the same strategy_uuid for multiple alerts?
You can use the same strategy UUID when the alerts are meant to trigger the same Proteryx Auto Trader. Use a different UUID when the alert should trigger a different automation.
Why does my Proteryx webhook message fail?
Common causes include invalid JSON, missing quotes, missing commas, a wrong strategy UUID, a wrong webhook URL, or a TradingView alert that never fired.
Should I test the webhook message with live size?
No. Test with one alert, one route, and small size first. After that, verify the result before using larger size or multiple accounts.