How to Set Up the OKX Signal Trading Bot with TradingView

The OKX Signal Trading Bot, integrated with TradingView, offers a powerful way to automate your cryptocurrency trading strategies. By connecting TradingView alerts directly to OKX, you can execute trades based on technical indicators, custom scripts, or chart patterns without manual intervention. This guide provides a clear, step-by-step process to configure your signal bot effectively.

Prerequisites

Before you begin, ensure you have:

• An active OKX account.
• A TradingView account with a paid subscription (required for webhook alerts).

Step 1: Access the Signal Bot on OKX

1. Log in to your OKX account.
2. Navigate to the Trade section and select Trading Bot.
3. Click on Marketplace and then choose the Signal Bot sub-tab.
4. Select the Create button to begin the setup process.

Step 2: Create Your Custom Signal

1. On the Signal Bot page, click Add Custom Signal.
2. Provide a descriptive name for your signal and an optional description (up to 500 characters).
3. Click Create Signal to proceed. OKX will generate a unique webhook URL and display the required Alert Message specifications. Keep this page open, as you will need this information for the TradingView configuration.

Step 3: Configure the TradingView Alert

This step varies depending on whether you use a TradingView Strategy script, an Indicator/Study script, manual chart analysis, or a third-party program.

Method 3.1: For Pine Script Strategy.*() Functions

This method is for users who write strategies that use strategy.*() functions for backtesting and order execution.

1. Add Script to Chart: In the Pine Editor, write or open your strategy script. Click Save and then Add to Chart.
2. Configure Strategy Settings: Click the gear icon (settings) next to the strategy name on your chart. Adjust the order size properties according to your preference. You can define size in USDT, number of contracts, or as a percentage of equity. Click OK to save.
3. Create the Alert: Click the Alerts button on the top toolbar. Set the Condition to "Order Fills Only" from your strategy's dropdown.
4. Set the Message: In the Message field, paste the alert message template provided by OKX in Step 2. Ensure you use the correct template for your strategy's order actions.
5. Add Webhook URL: In the Webhook URL field, paste the unique webhook URL generated by OKX in Step 2.
6. Click Create to finalize the alert.

Method 3.2: For Pine Script Indicators/Studies

This method is for indicators or studies that use alertcondition() calls.

1. Add Script to Chart: Write or open your indicator script in the Pine Editor. Click Save and Add to Chart.
2. Create the Alert: Click the Alerts button. Set the Condition to one of the alertconditions defined in your script (e.g., "MACD Golden Cross").
3. Set the Message: Paste the OKX alert message template into the Message field. Crucially, you must manually specify the action in the message (e.g., "action": "ENTER_LONG") based on the signal logic.
4. Add Webhook URL: Paste your OKX webhook URL into the Webhook URL field.
5. Click Create.

Method 3.3: For Manual Chart Analysis

This method is for traders who set alerts based on basic indicator lines or chart patterns.

1. Create the Alert: Click the Alerts button on your chart. Set the Condition based on your trading rules (e.g., "RSI-14 crosses above 30").
2. Set the Message: In the Message field, manually write a JSON message that complies with OKX's Alert Message specifications. You must include all required fields like action, instrument, and your signalToken.
3. Add Webhook URL: Paste your OKX webhook URL into the Webhook URL field.
4. Click Create.

Method 3.4: For Third-Party Programs

If you are sending signals from a native application (e.g., a Python script), you can send HTTP POST requests directly to the OKX webhook endpoint.

• Ensure your message body is a valid JSON string that strictly follows OKX's Alert Message specs.
• Sign the request appropriately if required.
• Note: Requests from third-party fixed IP addresses may require prior whitelisting by contacting OKX support.

Step 4: Configure Your Signal Trading Bot

Once your TradingView alert is live and sending signals, it's time to create the bot on OKX to act on them.

1. Back on the OKX Signal Bot page, click Create Bot next to your custom signal.

2. Basic Setup: Configure the essential parameters:

   • Trading Pair: Select the cryptocurrency pair you want to trade.
   • Leverage: Choose your desired leverage ratio. Remember, higher leverage amplifies both profits and risks.
   • Margin: Allocate the amount of capital you want to invest in this bot.

3. Advanced Settings (Optional): Fine-tune your strategy:

   • Order Type: Choose between Market or Limit orders.
   • Entry Settings: Define the investment amount per order, either as a fixed amount in USDT or a percentage of available balance.
   • Take Profit (TP) & Stop Loss (SL): Set levels to automatically secure profits or limit losses. These can be set here on the bot or dynamically via the TradingView alert message.
4. Click Confirm to activate your Signal Trading Bot.

Step 5: Monitor and Manage Your Bot

After creation, your bot will automatically execute trades based on the incoming signals.

• Monitor Performance: View your bot's details to track its P&L history, review open positions, monitor pending orders, and analyze its overall performance.
• Adjust Margin: You can add or remove funds from the bot at any time.
• Manual Intervention: Place manual orders within the bot, close specific open positions, or reduce your exposure without stopping the entire bot.
• Stop the Bot: Clicking Stop will close all open positions, cancel any pending orders, and return the remaining capital to your trading account.

👉 Explore more automated trading strategies

Frequently Asked Questions

Q: Do I need a paid TradingView plan to use this?
A: Yes, a TradingView paid subscription (Essential, Premium, or Premium+) is required to use the webhook functionality that sends alerts to OKX.

Q: What's the difference between a Strategy and an Indicator script in Pine Script?
A: A Strategy script (strategy.*()) is designed for backtesting and can simulate order execution. An Indicator or Study script (indicator.*()) is for visual analysis and uses alertcondition() to trigger alerts, requiring you to manually define the trade action in the alert message.

Q: My bot isn't executing trades. What should I check?
A: First, verify that your TradingView alert is triggering correctly using its log. Then, double-check that the JSON message in your alert matches OKX's exact specifications, especially the action, instrument (ticker), and signalToken fields. Ensure your OKX bot has sufficient margin allocated.

Q: Can I use one signal for multiple trading bots?
A: Yes, you can create multiple bots that subscribe to the same custom signal. Each bot can be configured with different parameters, such as trading pair, leverage, and investment size.

Q: How do I define the order size in the alert message?
A: The order size can be defined in the OKX bot's settings or dynamically in the TradingView alert message using the amount and investmentType fields (e.g., "investmentType": "percentage_balance", "amount": "10" to use 10% of the available balance).

Q: Is there a delay between the signal and trade execution?
A: The process is nearly instantaneous. However, network latency and exchange processing can cause minor delays, typically just a few seconds. The maxLag field in your alert message helps OKX manage stale signals.