Webhooks and Integration Guide
Introduction
If you have purchased a Tuned subscription, you are eligible to receive a free SageMaster subscription for live execution of your trades. If you are not signed up yet with Sagemaster, you can create an account for free. To claim your free SageMaster upgrade, please contact SageMaster Support at [email protected]. Provide your SageMaster login email, and our support team will manually activate your account. Additionally, you can follow up on the Tuned Discord server should there be any delay in activating your SageMaster account, and we will reach out to the SageMaster team on your behalf. This guide explains how to connect your Tuned strategy with SageMaster's DCA Assist for seamless trade execution.
Connecting Tuned with SageMaster DCA Assist
Step 1: Enable Webhook in Tuned
- Once you have developed your strategy and are running it on paper trading in Tuned, open the settings window of the running strategy.
- Check the box labeled "Enable Webhook".
- After enabling the webhook, you will see the following fields:
- Webhook URL
- Start Long message
- Shart Short message
- Close Long message
- Close Short message
Step 2: Obtain Your Free SageMaster Account
Ensure your SageMaster account is activated by contacting SageMaster Support (see above).
Step 3: Connect Your Exchange Account to SageMaster
Link your futures exchange account to SageMaster by visiting SageMaster Exchange Connections.
Step 4: Create Two DCA Assists in SageMaster
You need to create two DCA Assists—one for Long Trades and another for Short Trades.
Key Settings for DCA Assists:
- Main Settings
- Type: Choose single-pair for one strategy or multi-pair if you want to use the assist for multiple strategies or pairs.
- Strategy
- Position Type: Select Long for the Long DCA Assist and Short for the Short DCA Assist.
- Note: The "Both" option is currently unsupported but will be fixed soon.
- Base Order Margin and Leverage: Set these to match your desired order size.
- Trigger Condition
- Use Custom TradingView Alert.
- Check "Ignore the exchange from the trade idea that was sent by a provider" if you plan to execute signals on a different exchange.
- Extra Orders
- Set Max Extra Orders to 0 for Futures trading.
- Take Profit / Stop Loss
- Configure advanced strategies like Smart Take Profit or Smart Trailing for risk management.
Step 5: Retrieve Webhook URL and Messages from SageMaster
- Open the details page for each DCA Assist.
- Navigate to the Alerts section.
- Copy the following details:
- Webhook URL: This URL is the same for all users and assists.
- Alert to Start Deal: Message template for starting trades.
- Alert to Close Order at Market Price: Message template for closing trades (optional).
Step 6: Configure Webhook Settings in Tuned
Fill in the Tuned webhook settings as follows:
- Webhook URL: Use the webhook URL in the format https://api.sagemaster.io/deals_idea/<user_id>.
- Message to start Long Trade: Copy the "Alert to Start Deal" message from your Long DCA Assist.
- Message to start Short Trade: Copy the "Alert to Start Deal" message from your Short DCA Assist.
- Message to close Long Trade: Copy the "Alert to Close Order at Market Price" message from your Long DCA Assist (optional).
- Message to close Short Trade: Copy the "Alert to Close Order at Market Price" message from your Short DCA Assist (optional).
Click Save to complete the configuration.
Step 7: Test the Integration
On the next trade, Tuned will send a webhook to SageMaster, and the trade will be executed. You can monitor the full event log on the DCA Assist details page to debug or understand trade execution.
FAQ
Q: Why do I see the error: Initial Order error: binanceusdm {"code":-4061,"msg":"Order's position side does not match user's setting."}?
A: This error occurs when Hedge Mode is enabled on your Binance Futures account. To fix it, disable Hedge Mode and enable One-Way Mode in your Binance account settings.
Note:
Since Tuned webhook integration is universal, you can use webhooks with any platform that supports receiving webhooks.