Signal Bot

What Is a Signal Bot

A Signal Bot is an automated trading bot that executes trades based on external signals delivered via webhook. Unlike Grid or DCA bots that follow built-in algorithms, the Signal Bot delegates all entry and exit decisions to an outside source — your TradingView alerts, a custom trading system, or a professional signal provider from the GX Signal Marketplace.

This makes it the most flexible bot on GX Exchange. Any system capable of sending an HTTP POST request can drive your trading, while the bot handles order execution, position sizing, take-profit ladders, trailing stops, and risk controls.

Signals are processed by the GXCore matching engine in under 1 millisecond from receipt to order placement.

How It Works

1. You create a Signal Bot and receive a unique webhook URL.
2. You connect a signal source: a TradingView alert, a custom script, or a marketplace provider.
3. When a signal arrives, the bot validates the payload, resolves the pair and direction, and places the order.
4. The bot manages the position according to your sizing rules, take-profit steps, and stop-loss settings.
5. The position closes when an exit signal arrives, a take-profit target is hit, or the stop loss triggers.

All incoming signals and resulting trades are logged on the bot dashboard for audit and review.

Signal Sources

You can connect three types of signal sources to a Signal Bot. You may use more than one source on the same bot.

Webhook Format

GX Native Format

Use this format when sending signals from your own system.

Entry signal:

{
  "action": "open_long",
  "pair": "BTC-USDT",
  "price": "market",
  "take_profit": [2.0, 4.0, 6.0],
  "stop_loss": 1.5
}

Exit signal:

{
  "action": "close_long",
  "pair": "BTC-USDT",
  "price": "market"
}

Close all positions:

{
  "action": "close_all"
}

Field Reference

When take_profit is an array, each step closes an equal portion of the position. For example, [2.0, 4.0, 6.0] closes one-third at +2%, one-third at +4%, and the final third at +6%.

TradingView Format

{
  "ticker": "BTCUSDT",
  "action": "buy",
  "price": "{{close}}"
}

The bot maps TradingView tickers to GX pairs automatically. Action mapping:

• buy maps to open_long (or close_short if a short position is open).
• sell maps to open_short (or close_long if a long position is open).

TradingView Setup

Follow these steps to connect a TradingView alert to your Signal Bot.

1. Create a Signal Bot on GX Exchange and copy the webhook URL from the bot settings page.
2. Open TradingView and load the chart and indicator or strategy you want to generate signals from.
3. Click Alerts (clock icon) and then Create Alert.
4. Set your alert condition (e.g., indicator crossover, price level, or strategy order).
5. In the Notifications tab, enable Webhook URL and paste your GX webhook URL.
6. In the Message field, enter the JSON payload. Example for a buy alert:

{
  "ticker": "{{ticker}}",
  "action": "buy",
  "price": "{{close}}"
}

7. For a sell alert, create a second alert with "action": "sell".
8. Set the alert to trigger Every time the condition is met (not “Only once”).
9. Click Create. Your TradingView alert will now send signals directly to your GX Signal Bot.

Note: TradingView webhook alerts require a paid TradingView plan (Pro or higher). GX Exchange does not provide an automatic Pine Script integration — you must configure alerts manually as described above.

Signal Marketplace

Subscribing to a Provider

The Signal Marketplace is accessible from My Portfolio > Bot Dashboard > Signal Marketplace. Each listed provider displays:

• Historical win rate and average return
• Total subscribers
• Supported pairs and directions
• Signal frequency (signals per day/week)
• Monthly subscription price

To subscribe:

1. Browse or search for a provider.
2. Review their performance history and strategy description.
3. Click Subscribe and confirm the subscription fee.
4. Create a new Signal Bot or link the provider to an existing Signal Bot.
5. Signals flow automatically — no webhook configuration needed on your end.

Becoming a Signal Provider

Anyone can register as a signal provider on GX Exchange.

1. Navigate to Signal Marketplace > Become a Provider.
2. Set your provider name, description, supported pairs, and subscription price.
3. You will receive a dedicated provider webhook URL. Send your signals to this URL.
4. Your signals are relayed to all subscribers in real time.
5. Your provider profile goes live once your first signal is received.

Revenue split: 90% of each subscription fee goes to the signal provider. The remaining 10% is burned (permanently removed from circulation), contributing to GX token deflation.

Sizing Modes

The Signal Bot supports three position sizing modes. You select one when creating the bot.

Additional sizing controls:

• Max open positions — limits how many positions the bot can hold at once across all pairs.
• Max investment — hard cap on total capital deployed by the bot. New signals are rejected once this cap is reached.

Take Profit and Stop Loss

Multi-Step Take Profit

You can define up to five take-profit levels. The position is divided equally across each step. Example with three steps at 2%, 4%, and 6%:

If the price reverses after hitting step 1, only the remaining portion is subject to the stop loss.

Default take-profit and stop-loss values are configured on the bot. Signals can override these defaults by including take_profit and stop_loss fields in the payload.

Trailing Stop Loss

When trailing stop is enabled, the stop-loss price follows the market in the direction of profit. For a long position with a 2% trailing stop:

• Entry at $100. Stop loss begins at $98.
• Price rises to $110. Stop loss moves to $107.80.
• Price reverses. Position closes if price hits $107.80.

The trailing stop locks in gains while allowing the position to continue running in favorable conditions.

Hedge Mode

With hedge mode enabled, the bot can hold simultaneous long and short positions on the same pair. An open_long signal does not close an existing short — it opens a separate long position alongside it.

This is useful for:

• Strategies that hedge directional risk.
• Multi-timeframe systems where a short-term signal differs from a long-term signal.
• Mean-reversion strategies that scale into both sides of a range.

With hedge mode disabled (default), opening a long automatically closes any existing short on that pair, and vice versa.

Deviation Filtering

When the bot receives a signal to open a position in the same direction as an existing one, deviation filtering prevents duplicate entries. If the current market price has not moved beyond the configured deviation threshold from the last entry, the signal is ignored. This protects against rapid-fire duplicate signals from noisy sources.

Security

Your webhook URL is a secret. Anyone who has it can trigger trades on your account.

• Do not share your webhook URL publicly or in group chats.
• Each URL contains a unique cryptographic token tied to your bot and account.
• Signals with malformed payloads are rejected.
• Rate limit: 10 signals per second per bot. Excess signals are queued, not dropped.
• You can regenerate your webhook URL at any time from the bot settings page. This instantly invalidates the previous URL.
• All signal activity is logged with timestamps, source IP, and payload content for your review.

FAQ

Can I use multiple signal sources on one bot? Yes. You can point multiple TradingView alerts and custom scripts to the same webhook URL. You can also link a marketplace provider to the same bot. All signals are processed in the order they arrive.

What happens if a signal arrives for a pair not in my allowed list? The signal is rejected and logged. Only pairs you explicitly added to the bot’s pair list are accepted.

Can I run a Signal Bot alongside a Grid or DCA Bot on the same pair? Yes, as long as you have sufficient margin. Each bot manages its own positions independently.

Is there a delay between the signal and the order? Signals are processed in under 1 millisecond by the GXCore engine. Network latency between your signal source and GX Exchange is the primary variable — typically under 200ms depending on geography.

What if my TradingView alert fires but the bot does not trade? Check the bot’s signal log for rejected signals. Common causes: the pair is not in the allowed list, max open positions has been reached, or the payload format is incorrect.

Can I send limit orders via webhook? Yes. Set the price field to a specific number instead of market. The order will be placed as a limit order at that price.

How does the marketplace subscription billing work? Subscriptions are billed monthly. 90% goes to the signal provider, 10% is burned. You can cancel at any time and retain access until the end of the billing period.

Can I test my webhook before going live? Yes. After creating your bot, use the Send Test Signal button on the bot settings page, or send a manual POST request using a tool like curl or Postman. Test signals are logged but do not place real orders if the bot is paused.

Getting Started

1. Navigate to My Portfolio > Bot Dashboard > Create Bot > Signal Bot.
2. Name your bot and select the pairs it can trade.
3. Choose a sizing mode and set your position size.
4. Configure take-profit steps, stop-loss percentage, and trailing stop if desired.
5. Enable hedge mode if your strategy requires simultaneous long and short positions.
6. Copy the generated webhook URL.
7. Connect your signal source: paste the URL into TradingView, integrate it into your script, or subscribe to a marketplace provider.
8. Send a test signal to verify connectivity.
9. Activate the bot.