# 🔄 Automating Infinity Algo Alerts via Alertatron

{% hint style="danger" %}
**CRITICAL: Alertatron has TWO different systems. DO NOT MIX THEM:**

* **Signals Lite** - JSON messages only, no scripts
* **Script Bots** - Full scripting with `MyKeys{...} #bot`

**Signals Lite does NOT use `MyKeys{...}` or `#bot` tags!**

Choose ONE system and follow ONLY that guide below.
{% endhint %}

***

### 🎯 Which System Should You Use?

{% tabs %}
{% tab title="Most Users → Signals Lite" %}
**Choose Signals Lite if you want:**

* ✅ Quick 5-minute setup
* ✅ Visual configuration (no coding)
* ✅ Simple long/short automation
* ✅ Lower chance of errors
* ✅ Easy to modify settings

**Perfect for:**

* New to automation
* Basic buy/sell/close needs
* Want it working fast
  {% endtab %}

{% tab title="Power Users → Script Bots" %}
**Choose Script Bots if you need:**

* ✅ Complex order logic
* ✅ Multi-step TP ladders
* ✅ Conditional execution
* ✅ Position pyramiding
* ✅ Custom OCO groups
* ✅ Timing delays

**Required skills:**

* Comfortable with code
* Can debug scripts
* Need advanced features
  {% endtab %}
  {% endtabs %}

***

## 📘 Option 1: Signals Lite (Recommended)

Simple JSON signal-based automation with visual configuration.

### ⚙️ Step 1: Create Signals Lite Bot

1. Navigate to **Signals Lite → Your Bots**
2. Click **"Create new automated bot..."**
3. Configure your bot:

| Field        | What to enter            |
| ------------ | ------------------------ |
| **Bot name** | e.g. `Infinity Algo BTC` |
| **Exchange** | Select your exchange     |
| **Symbol**   | e.g. `BTCUSDT` or `BTC`  |
| **Access**   | Set to Private           |

4. Click **Create Bot**

### 🔑 Step 2: Configure Bot Settings

After creating your bot:

{% tabs %}
{% tab title="API Keys" %}

1. Click on your bot name to expand
2. Find **"API Keys"** section
3. Add your exchange API credentials
4. **Save** configuration

{% hint style="warning" %}
Never enable withdrawal permissions for trading bots
{% endhint %}
{% endtab %}

{% tab title="Signal Settings" %}
Configure default behavior that can be overridden per alert:

* **Position Size**: % of balance or fixed amount
* **Leverage**: Your preferred leverage
* **Order Type**: Market or Limit
* **Take Profit**: Enable and set offset %
* **Stop Loss**: Set risk %
* **Hedge Mode**: If supported by exchange

{% hint style="info" %}
You can override any of these per alert with JSON. See [Override signal settings](https://alertatron.com/docs/signals-lite/override-signal-settings)
{% endhint %}
{% endtab %}
{% endtabs %}

### 📩 Step 3: Get Your Webhook

{% hint style="warning" %}
**Copy the exact webhook shown on your bot page.** Don't guess the path—formats can change.
{% endhint %}

Your bot page will display a unique webhook URL. Copy it exactly as shown - you'll need it for TradingView.

### 📊 Step 4: Create TradingView Alerts

#### Available Infinity Algo Alerts

{% tabs %}
{% tab title="Entry Signals" %}
**Buy Signals:**

* `1.0 Buy Signal - Normal`
* `1.1 Buy Signal - Smart` 
* `1.2 Normal or Smart Buy` 
* `1.3 Buy Signal - HL Sniper`
* `1.4 Buy Signal - AI`

**Sell Signals:**

* `1.5 Sell Signal - Normal`
* `1.6 Sell Signal - Smart` 
* `1.7 Normal or Smart Sell`
* `1.8 Sell Signal - HL Sniper`
* `1.9 Sell Signal - AI`
  {% endtab %}

{% tab title="Exit Signals" %}
**Management:**

* `2.0 Take Profit Long`
* `2.1 Take Profit Short`
* `2.2 Stop Loss Long Hit`
* `2.3 Stop Loss Short Hit`
* `2.4 Possible Long Coming` (info only)
* `2.5 Possible Short Coming` (info only)
  {% endtab %}
  {% endtabs %}

#### Alert Configuration

1. Open your Infinity Algo chart
2. Create alert (Alt+A)
3. Configure:

| Field           | Value                                         |
| --------------- | --------------------------------------------- |
| **Condition**   | e.g. "1.1 Buy Signal - Smart"                 |
| **Options**     | **Once Per Bar Close** (prevents duplicates!) |
| **Alert name**  | e.g. "IA Smart Buy"                           |
| **Message**     | JSON template (see below)                     |
| **Webhook URL** | Your bot's webhook from Step 3                |

### 📝 Signals Lite Message Templates

{% hint style="danger" %}
**Messages MUST be valid JSON.** Start simple (side + amount) and optionally override defaults such as TP/SL, hedge mode, or closing the opposite side.
{% endhint %}

{% tabs %}
{% tab title="Basic JSON" %}
**Minimal Long Entry:**

```json
{"side":"long","amount":"25%"}
```

**Minimal Short Entry:**

```json
{"side":"short","amount":"25%"}
```

**Close Position:**

```json
{"side":"close"}
```

{% endtab %}

{% tab title="With Overrides" %}
**Long with TP/SL override:**

```json
{
  "side": "long",
  "amount": "50%",
  "takeProfit": true,
  "takeProfitOffset": "2%",
  "stopLoss": true,
  "stopLossOffset": "1%",
  "closeExisting": true
}
```

**Short with leverage:**

```json
{
  "side": "short",
  "amount": "100%",
  "leverage": 10,
  "takeProfit": true,
  "takeProfitOffset": "1.5%"
}
```

{% endtab %}

{% tab title="Dynamic Values" %}
**Using TradingView placeholders:**

```json
{
  "side": "long",
  "amount": "25%",
  "entry": "limit",
  "price": "{{close}}"
}
```

{% hint style="info" %}
Don't include `symbol` - it's already set in your bot configuration
{% endhint %}
{% endtab %}
{% endtabs %}

#### Available Override Fields

See full documentation: [Override signal settings](https://alertatron.com/docs/signals-lite/override-signal-settings)

| Field              | Type    | Description                        |
| ------------------ | ------- | ---------------------------------- |
| `side`             | string  | "long", "short", or "close"        |
| `amount`           | string  | Position size (e.g., "50%", "100") |
| `takeProfit`       | boolean | Enable take profit                 |
| `takeProfitOffset` | string  | TP distance (e.g., "2%")           |
| `stopLoss`         | boolean | Enable stop loss                   |
| `stopLossOffset`   | string  | SL distance (e.g., "1%")           |
| `closeExisting`    | boolean | Close opposite position first      |
| `useHedgeMode`     | boolean | Use hedge mode if available        |
| `leverage`         | number  | Override leverage                  |
| `entry`            | string  | "market" or "limit"                |
| `price`            | string  | Limit price (if entry="limit")     |

{% hint style="info" %}
For multi-pair bots, use **percent/offset fields** (e.g., `takeProfitOffset`), not fixed prices.
{% endhint %}

{% hint style="success" %}
**That's it!** Your Signals Lite bot is ready. Test with small amounts first.
{% endhint %}

***

## 📗 Option 2: Script Bots (Advanced)

Full scripting control with complex order logic and multi-step TP ladders.

{% hint style="warning" %}
**Prerequisites:** Understand basic scripting and can debug syntax errors. If not, use Signals Lite above.
{% endhint %}

### ⚙️ Step 1: Configure Script Bot Infrastructure

#### A. Add API Keys First

1. Go to **Scripting Signals → Script Bot Config → Script Bot API Keys**
2. Click **"Add API Keys"**
3. Configure:
   * **Name**: e.g. `MyKeys` (remember this exactly!)
   * **Exchange**: Your exchange
   * **API Key & Secret**: Your credentials
4. **Save** your keys

#### B. Get Your Account Webhook

1. Go to **Account → Webhook Details**
2. **Copy the exact webhook shown** (don't guess the format)

#### C. Configure Bot Group

1. Go to **Scripting Signals → Trading Bot Settings**
2. Set up a group that filters for `#bot`
3. Route this group to the trading engine

{% hint style="info" %}
Script Bots route through your account webhook using the `#bot` tag, not a separate bot webhook
{% endhint %}

### 📊 Step 2: Available Alert Conditions

Same as Signals Lite - all 16 alerts available:

<details>

<summary>Click to see full alert list</summary>

**Buy Entries:**

* 1.0 through 1.4&#x20;

**Sell Entries:**

* 1.5 through 1.9

**Management:**

* 2.0 through 2.3

</details>

### 📋 Step 3: Create TradingView Alerts

Configuration is similar but the **message contains scripts**:

| Field           | Value                                         |
| --------------- | --------------------------------------------- |
| **Condition**   | Your chosen signal                            |
| **Options**     | **Once Per Bar Close** (prevents duplicates!) |
| **Message**     | Your script (see templates)                   |
| **Webhook URL** | Your account webhook (NOT Signals Lite!)      |

### 📝 Script Bot Templates

{% hint style="danger" %}
**Every script MUST end with `#bot` or it won't execute!**
{% endhint %}

{% tabs %}
{% tab title="🟢 Long Entry" %}
{% code title="long\_entry.txt" overflow="wrap" lineNumbers="true" %}

```
MyKeys({{ticker}}) {
  # Enter long with 100% of available balance
  market(side=buy, amount=100%a);

  # Stop loss 1% below entry
  stopOrder(side=sell, amount=100%p, stop=e-1%, reduceOnly=true);

  # Multi-step TP ladder with OCO
  oneCancelsOther(which=all);
    limit(position=75%p, offset=e1%, reduceOnly=true);
    limit(position=50%p, offset=e2%, reduceOnly=true);
    limit(position=25%p, offset=e3%, reduceOnly=true);
    limit(position=0,    offset=e4%, reduceOnly=true);
  oneCancelsOther();
}
#bot
```

{% endcode %}

**This multi-step TP ladder is ONLY possible with Script Bots!**
{% endtab %}

{% tab title="🔴 Short Entry" %}
{% code title="short\_entry.txt" overflow="wrap" lineNumbers="true" %}

```
MyKeys({{ticker}}) {
  # Enter short
  market(side=sell, amount=100%a);

  # Stop loss 1% above entry
  stopOrder(side=buy, amount=100%p, stop=e+1%, reduceOnly=true);

  # Multi-step TP ladder (negative values for short)
  oneCancelsOther(which=all);
    limit(position=-75%p, offset=e-1%, reduceOnly=true);
    limit(position=-50%p, offset=e-2%, reduceOnly=true);
    limit(position=-25%p, offset=e-3%, reduceOnly=true);
    limit(position=0,     offset=e-4%, reduceOnly=true);
  oneCancelsOther();
}
#bot
```

{% endcode %}
{% endtab %}

{% tab title="⏹️ Flatten" %}
{% code title="close\_position.txt" overflow="wrap" %}

```
MyKeys({{ticker}}) {
  # Close any position
  limit(position=0, offset=1, reduceOnly=true);
  
  # Cancel all orders
  cancel(which=all);
}
#bot
```

{% endcode %}
{% endtab %}

{% tab title="⚡ Ping-Pong" %}
{% code title="flip\_position.txt" overflow="wrap" %}

```
MyKeys({{ticker}}) {
  # Cancel existing orders
  cancel(which=all);
  
  # Flip to long (closes short if exists)
  market(position=100%a);
  
  # Single SL and TP
  stopOrder(side=sell, amount=100%p, stop=e-2%, reduceOnly=true);
  limit(side=sell, amount=100%p, offset=e3%, reduceOnly=true);
}
#bot
```

{% endcode %}
{% endtab %}

{% tab title="🔧 Advanced" %}
{% code title="conditional\_pyramid.txt" overflow="wrap" lineNumbers="true" %}

```
MyKeys({{ticker}}) {
  # Only add if position < 10000
  continue(if=positionLessThan, value=10000);
  
  # Add to position
  market(side=buy, amount=1000);
  
  # Trailing stop
  trailingStop(side=sell, amount=100%p, offset=e-1.5%, 
               trailingMethod=stepped, stepSize=0.5%, maxSteps=3);
}
#bot
```

{% endcode %}

{% code title="delayed\_entry.txt" overflow="wrap" %}

```
MyKeys({{ticker}}) {
  # Wait 5 minutes
  wait(5m);
  
  # Then enter
  market(side=buy, amount=50%a);
  
  # Add protection
  stopOrder(side=sell, amount=100%p, stop=e-1%, reduceOnly=true);
}
#bot
```

{% endcode %}
{% endtab %}
{% endtabs %}

### 🔤 Script Command Reference

<details>

<summary>Click to expand full command list</summary>

| Command             | Purpose             | Example                            |
| ------------------- | ------------------- | ---------------------------------- |
| `market()`          | Market order        | `market(side=buy, amount=100%a)`   |
| `limit()`           | Limit order         | `limit(position=50%p, offset=e2%)` |
| `stopOrder()`       | Stop loss           | `stopOrder(side=sell, stop=e-1%)`  |
| `aggressive()`      | Smart limit entry   | `aggressive(position=90%a)`        |
| `wait()`            | Delay               | `wait(10m)`                        |
| `cancel()`          | Cancel orders       | `cancel(which=all)`                |
| `oneCancelsOther()` | OCO group           | `oneCancelsOther(which=all)`       |
| `continue()`        | Conditional proceed | `continue(if=positionLong)`        |
| `stop()`            | Conditional halt    | `stop(if=positionShort)`           |
| `trailingStop()`    | Trailing stop       | `trailingStop(offset=e-1%)`        |

**Position Sizing:**

* `100%a` = 100% available balance
* `100%p` = 100% current position
* `100` = Fixed amount
* `position=0` = Close position
* `offset=e2%` = 2% from entry

</details>

***

## 🛠️ Troubleshooting

{% tabs %}
{% tab title="Signals Lite Issues" %}

| Problem            | Solution                                   |
| ------------------ | ------------------------------------------ |
| Bot not responding | Check webhook URL is exactly copied        |
| Invalid message    | Must be valid JSON format                  |
| Wrong size         | Verify % vs fixed amount in JSON           |
| No TP/SL           | Set in bot or override with JSON fields    |
| Duplicate orders   | Ensure "Once Per Bar Close" in TradingView |
| {% endtab %}       |                                            |

{% tab title="Script Bot Issues" %}

| Problem             | Solution                                  |
| ------------------- | ----------------------------------------- |
| Script ignored      | Missing `#bot` tag at end                 |
| Invalid keys        | Check key alias spelling (case-sensitive) |
| Parse error         | Check Alertatron inbox for error details  |
| Orders size 0       | Missing `%` on sizing (`%a` or `%p`)      |
| TP/SL not canceling | Need `oneCancelsOther()` wrapper          |
| {% endtab %}        |                                           |
| {% endtabs %}       |                                           |

***

## 📚 Resources

{% hint style="info" %}
**Official Documentation:**

* **Main: Docs:** [**https://alertatron.com/docs/all/guide**](https://alertatron.com/docs/all/guide)
* **Signals Lite Getting Started**: <https://alertatron.com/docs/getting-started-with-signals-lite>
* **Override Settings Reference**: <https://alertatron.com/docs/signals-lite/override-signal-settings>
* **Script Bots Basics**: <https://alertatron.com/docs/automated-trading/basic-concepts>
* **Script Command Reference**: <https://alertatron.com/docs/automated-trading/market-order>
  {% endhint %}

{% hint style="warning" %}
**Remember:**

* Alertatron is a third-party service with separate costs
* Always test with small amounts first
* Use exchange testnet when available
* Manual trading via TradingView is always an option
  {% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.infinityalgo.com/trading-guide/trading-guide/automating-infinity-algo-alerts-via-alertatron.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.