Documentation

Welcome to the XALIUM documentation. This comprehensive guide will help you set up and use the platform to automate your trading strategies with TradingView alerts.

Quick Start

Get started with XALIUM in just 5 minutes by following these steps:

Requirements

Before getting started with XALIUM, ensure you have the following:

• TradingView Account: A TradingView Pro, Pro+ or Premium account (required for webhook alerts)
• MT5/MT4 Broker Account: An active trading account with a broker that supports MetaTrader 5 or MetaTrader 4
• XALIUM Subscription: An active XALIUM subscription plan

Account Setup

Setting up your XALIUM account is straightforward:

Registration

1. Visit XALIUM.com and click "Get Started"
2. Choose your subscription plan (Starter, Professional, or Enterprise)
3. Complete the registration form with your details
4. Verify your email address
5. Complete the payment process

Dashboard Overview

Once logged in, you'll have access to:

• Overview: Real-time trading statistics and account performance
• Signals: History of all received and executed trading signals
• Notifications: System alerts and trade execution logs
• Analysis: Performance analytics and metrics
• Settings: Account and broker configuration

Broker Connection

Connecting your MT5/MT4 broker account to XALIUM:

Supported Brokers

XALIUM supports all brokers that offer MetaTrader 5 (MT5) or MetaTrader 4 (MT4) platforms, including:

• IC Markets
• Pepperstone
• OANDA
• FXCM
• XM
• FBS
• And many more...

Note: XALIUM supports both MetaTrader 4 (MT4) and MetaTrader 5 (MT5) platforms. Works with any broker that provides MT4 or MT5 access.

Connection Steps

1. Log in to your XALIUM dashboard
2. Navigate to Settings → Broker Connection
3. Select your broker from the dropdown menu or enter manually
4. Enter your MT5/MT4 account details:
   • Account Number
   • Password
   • Server Address
5. Click "Connect" to establish the connection
6. Wait for connection verification (usually takes 5-10 seconds)

Webhook URL

Your webhook URL is the unique endpoint that TradingView uses to send signals to XALIUM.

Finding Your Webhook URL

1. Go to your XALIUM dashboard
2. Navigate to the Signals section
3. Your webhook URL will be displayed at the top
4. Click the "Copy" button to copy it to your clipboard

Your webhook URL will look like this:

https://xalium.com/webhook/your-unique-id-here

Creating TradingView Alerts

Learn how to create and configure TradingView alerts to work with XALIUM:

Step-by-Step Guide

1. Open Your TradingView Chart

• Open TradingView and navigate to your desired chart
• Add your indicators or strategies
• Ensure your chart is properly configured for your trading setup

2. Create an Alert

1. Click the "Alert" button in the top toolbar (or press Alt + A)
2. In the alert dialog, configure:
   • Condition: Select your indicator/condition (e.g., "RSI crossing above 30")
   • Options: Choose "Once Per Bar Close" for reliable signals
   • Expiration: Set to "Open-ended" for continuous alerts

3. Configure Notifications

In the "Notifications" tab:

• Check the "Webhook URL" option
• Paste your XALIUM webhook URL
• Optionally enable email/app notifications for monitoring

Webhook Setup in TradingView

Detailed instructions for configuring the webhook in your TradingView alert:

Webhook URL Field

Paste your XALIUM webhook URL in the "Webhook URL" field:

https://xalium.com/webhook/your-unique-id-here

Alert Message Format

In the "Message" field, you can use either Natural Language or JSON format:

Natural Language Format (Recommended)

Simple, human-readable format:

Buy EURUSD 0.1 lots SL 1.16373 TP 1.16454

sell GBPUSD 0.05 lots sl 1.26500 tp 1.26000

JSON Format (Advanced)

Structured JSON format for advanced options:

{
  "action": "trade",
  "type": "market",
  "side": "buy",
  "symbol": "EURUSD",
  "volume": 0.1,
  "sl": 1.16373,
  "tp": 1.16454,
  "comment": "TradingView Signal"
}

Alert Message Format

Understanding the JSON structure for your alert messages:

JSON Structure

All alert messages can use either natural language or JSON with the following structure:

Natural Language Format:

Buy EURUSD 0.1 lots SL 1.16373 TP 1.16454
sell GBPUSD 0.05 lots sl 1.26500 tp 1.26000

JSON Format:

{
  "action": "trade",
  "type": "market|pending",
  "side": "buy|sell",
  "symbol": "INSTRUMENT_SYMBOL",
  "volume": 0.1,
  "sl": 1.16373,
  "tp": 1.16454,
  "price": 1.2345,
  "comment": "Optional comment"
}

Parameters Explained

Signal Examples

Natural Language - Basic Buy Signal

Buy EURUSD 0.1 lots SL 1.16373 TP 1.16454

Natural Language - Sell Signal

sell GBPUSD 0.05 lots sl 1.26500 tp 1.26000

JSON - Market Buy Order

{
  "action": "trade",
  "type": "market",
  "side": "buy",
  "symbol": "EURUSD",
  "volume": 0.1,
  "sl": 1.16373,
  "tp": 1.16454,
  "comment": "TradingView Signal"
}

JSON - Pending Sell Order

{
  "action": "trade",
  "type": "pending",
  "side": "sell",
  "symbol": "GBPUSD",
  "volume": 0.2,
  "price": 1.2750,
  "sl": 1.2780,
  "tp": 1.2690,
  "comment": "Resistance level sell"
}

Natural Language - Gold Trade

BUY XAUUSD 0.02 lots sl 2340.50 tp 2380.00

JSON - Dynamic Signal with TradingView Variables

{
  "action": "trade",
  "type": "market",
  "side": "buy",
  "symbol": "",
  "volume": 0.1,
  "sl":  - 50,
  "tp":  + 100,
  "comment": " - "
}

Supported Order Types

XALIUM supports multiple order types using natural language. Simply type your command in plain English!

MetaTrader 5 (MT5) - All Order Types

MT5 supports 8 order types:

Market Orders

• Buy: buy EURUSD 0.1 lots sl 1.16500 tp 1.17000
• Sell: sell GBPUSD 0.05 lots sl 1.26500 tp 1.26000

Pending Orders

• Buy Limit: buy [email protected] EURUSD 0.1 lots sl 1.16300 tp 1.16700
• Sell Limit: sell [email protected] GBPUSD 0.05 lots sl 1.26600 tp 1.26400
• Buy Stop: buy [email protected] EURUSD 0.1 lots sl 1.16500 tp 1.17000
• Sell Stop: sell [email protected] GBPUSD 0.05 lots sl 1.26800 tp 1.26500
• Buy Stop Limit: buy stop [email protected] XAUUSD 0.02 lots sl 2340.00 tp 2380.00
• Sell Stop Limit: sell stop [email protected] GBPUSD 0.05 lots sl 1.26650 tp 1.26350

MetaTrader 4 (MT4) - 6 Order Types

MT4 supports 6 order types (Stop Limit orders not available):

Market Orders

• Buy: buy EURUSD 0.1 lots sl 1.16500 tp 1.17000
• Sell: sell GBPUSD 0.05 lots sl 1.26500 tp 1.26000

Pending Orders

• Buy Limit: buy [email protected] EURUSD 0.1 lots sl 1.16300 tp 1.16700
• Sell Limit: sell [email protected] GBPUSD 0.05 lots sl 1.26600 tp 1.26400
• Buy Stop: buy [email protected] EURUSD 0.1 lots sl 1.16500 tp 1.17000
• Sell Stop: sell [email protected] GBPUSD 0.05 lots sl 1.26800 tp 1.26500

Order Type Explanations

Testing Your Alerts

Before going live, it's crucial to test your setup:

Test Mode

To test your signals safely without executing trades:

1. Go to your XALIUM dashboard
2. Navigate to the Primary Accounts section (look for the and icons in the Connected MT4 Account card)
3. Deselect all accounts (ensure no accounts are checked)
4. Create a TradingView alert with your signal
5. Trigger the alert manually or wait for the condition
6. Check the "Signals" tab in XALIUM to see the received signal
7. Verify the signal details are correct

Primary Accounts section showing the user and sync icons

Demo Account Testing

We recommend:

• Start with a demo/practice account from your broker
• Test for at least 1-2 weeks to ensure everything works correctly
• Monitor all signals and executions closely
• Only switch to live account after successful testing

Risk Management

Proper risk management is essential for successful automated trading:

Position Sizing

• Never risk more than 1-2% per trade: Calculate your lot size based on your account balance and stop loss
• Use consistent lot sizes: Avoid varying position sizes dramatically
• Account for leverage: Be aware of your broker's leverage and its impact

Stop Loss & Take Profit

• Always use stop losses to limit potential losses
• Set realistic take profit levels based on your strategy
• Consider using trailing stops for trending markets
• Use a risk-reward ratio of at least 1:2

Troubleshooting

Common issues and their solutions:

Signals Not Being Received

1. Verify your webhook URL is correct in TradingView
2. Check if you have an active XALIUM subscription
3. Ensure your TradingView account supports webhooks (Pro/Pro+/Premium)
4. Check the Notifications tab in XALIUM for error messages

Trades Not Executing

1. Verify your broker connection is active (green status)
2. Check if any accounts are selected in the Primary Accounts section (trades only execute when accounts are selected)
3. Ensure sufficient margin in your trading account
4. Verify the symbol name matches your broker's format
5. Check if trading hours are active for the instrument

Invalid JSON Format Error

1. Validate your JSON using an online JSON validator
2. Check for missing commas, brackets, or quotes
3. Ensure all string values are in double quotes
4. Remove any trailing commas

Connection Issues

1. Verify your broker credentials are correct
2. Check if your broker server is online
3. Ensure your IP is not blocked by the broker
4. Try reconnecting from the Settings page

Best Practices

Follow these guidelines for optimal results:

Strategy Development

• Backtest your strategy thoroughly before automating
• Start with conservative position sizes
• Use demo accounts for initial testing
• Monitor performance regularly and adjust as needed
• Keep a trading journal to track results

Alert Configuration

• Use "Once Per Bar Close" for more reliable signals
• Avoid creating too many overlapping alerts
• Test each alert individually before combining
• Use descriptive comments to identify alerts
• Set up email notifications for critical alerts

Account Management

• Regularly review your trading history
• Monitor your account balance and drawdown
• Adjust risk parameters based on performance
• Keep your XALIUM subscription active
• Update broker credentials if changed

Security

• Never share your webhook URL publicly
• Use strong passwords for your XALIUM account
• Regularly monitor your account for unauthorized access
• Log out when using shared computers

Need More Help?

If you have questions or need assistance:

• Support: Contact our support team via the dashboard
• Community: Join our Discord community for tips and discussions
• Updates: Follow our blog for latest features and updates

Back to Home