# Set Up an Alert Bot
This guide walks you through the **Configurator** screen where you build an Alert Bot from scratch—or load a ready-made template from the Skyrexio script library.
***
### 1 · **Lay the foundation**
* Go to **Bots → Create → Alert Bot**.
* Select the exchange account, then choose **Spot** or **Futures**.
* Pick the quote-currency market (e.g., **USDT**). The bot can trade any coin that settles in this market.
* Specify the **total capital** you’re allocating to the bot.
* Set **Active trading pairs**—the maximum number of simultaneous positions.
***
### 2 · Configure entry order alerts
* Pick a signal mode: **Indicator**, **Strategy**, or **Custom Webhook**.
* The Configurator reveals your unique **webhook URL**, a copy-ready **JSON alert template**, and a short video walkthrough (full guide link).
* Choose the **base order type**: **Market** for immediate execution or **Limit** for a set price.
* Feed in any TradingView script—your own, a public community script, or a template from the **Skyrexio Script Library**—and fine-tune it before deploying.
{% tabs %}
{% tab title="Indicator" %}
1. Copy webhook URL and alert message to open trade
2. Go to TradingView charts, select trading pair, choose indicator (for example, [Skyrexio Ichimoku Clouds Strategy Long and Short](https://www.tradingview.com/script/uycyVpIq-Ichimoku-Clouds-Strategy-Long-and-Short/)) and apply it to the chart
3. Set the chart timeframe and indicator configuration to meet your expectations
4. Click Alert, select the indicator as the condition, paste the bot message and webhook URL, click Create
Note: if you chose Alert close orders when configuring the bot, set another alert with close message to exit trades
{% endtab %}
{% tab title="Strategy" %}
1. Copy webhook URL, strategy action parameters and alert message
2. Go to TradingView charts, select trading pair, choose strategy and apply it to the chart
{% hint style="info" %}
**Note:** click Create a working copy in case it is a community script to have edit access
{% endhint %}
3. Add alert\_message parameters from the bot to strategy entry, close or exit actions and click Save
4. Set the chart timeframe and strategy configuration until backtest results meet your expectations
5. Click Alert, select strategy as condition, paste bot's alert message, set webhook URL and click Create
{% endtab %}
{% tab title="Custom Webhook" %}
You can use **any external service or in-house script** to send alerts to Skyrexio. All you need is a simple HTTP POST request.
***
**Endpoint**
Send every alert to:
```
https://webhook.skyrexio.com/api/v1/deal/alert
```
***
**JSON Payload Structure**
```json
{
"base": "Name of the base asset (e.g., MATIC)",
"quote": "Name of the quote asset (e.g., USDT)",
"position": "Use \"entry1\", \"entry2\", etc. for primary/extra entries. Use \"close\" to close all positions.",
"price": "Limit price. For market orders you can pass any value.",
"sourceUuid": "Value from the Alert message section of your custom bot",
"secretToken": "Value from the Alert message section of your custom bot"
}
```
**Field explanations**
| Field | Description |
| ------------- | -------------------------------------------------------------------- |
| `base` | Base currency (e.g., `MATIC`). |
| `quote` | Quote currency (e.g., `USDT`). |
| `position` | `entry1`, `entry2`, etc. for entries; `close` to exit all positions. |
| `price` | Limit-order price; any value for a market order. |
| `sourceUuid` | Taken from **Alert message** settings on your custom bot page. |
| `secretToken` | Taken from **Alert message** settings on your custom bot page. |
***
**Sample Requests**
> You can test these calls manually with tools like **Postman**—handy for quick validation before full integration.
*POST URL:*\
`https://webhook.skyrexio.com/api/v1/deal/alert`
**Main entry (entry1)**
```json
{
"base": "MATIC",
"quote": "USDT",
"position": "entry1",
"price": "1.25",
"sourceUuid": "your_sourceUuid_from_bot",
"secretToken": "your_secretToken_from_bot"
}
```
**Additional entry (entry2, etc.)**
```json
{
"base": "MATIC",
"quote": "USDT",
"position": "entry2",
"price": "1.20",
"sourceUuid": "your_sourceUuid_from_bot",
"secretToken": "your_secretToken_from_bot"
}
```
**Close position**
```json
{
"base": "MATIC",
"quote": "USDT",
"position": "close",
"price": "1.30",
"sourceUuid": "your_sourceUuid_from_bot",
"secretToken": "your_secretToken_from_bot"
}
```
***
**Sending a Request in Postman**
1. Open **Postman**.
2. Select **POST** and paste the endpoint URL:\
`https://webhook.skyrexio.com/api/v1/deal/alert`
3. Go to **Body → raw → JSON**.
4. Paste one of the JSON payloads above.
5. Click **Send**.
That’s it—you can manually trigger openings, additional entries, or closings and verify the responses. Once tested, integrate the same call into any automated trading system or alert source.
{% endtab %}
{% endtabs %}
***
### 3 · Set overlap and close orders
{% tabs %}
{% tab title="Auto mode" %}
Want to launch quickly? Switch to **Auto** mode and pick one of three ready-made risk profiles:
| Style | Core idea | Default parameters\* | Best for |
| ---------------- | ------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------- |
| **Conservative** | Dollar-Cost Averaging with widening entries |
| Riding fast breakouts and strong trends |
Each preset auto-generates the overlap grid, extra entry orders, take-profit, and stop-loss levels based on the trading amount you chose in Step 1. You adjust only the base entry size—everything else is calculated and loaded for you, so you can skip the manual configuration and go live in seconds.
{% endtab %}
{% tab title="Preset mode" %}
### Configuring additional entry orders
This step lets you build a price-based “average-in” sequence that fires automatically without external alerts.
1. **Switch to Custom → Preset**
* Make sure **Custom** risk management is active.
* Toggle **Additional entries** ON, then choose the **Preset** tab (the bot will place adds at predefined price intervals).
2. **Set how many adds the bot will place**
* Drag the **Orders** slider (or type a number) — 1 to 10 extra buys.
3. **Shape order size growth**
* **Order size scale** controls how each successive add grows relative to the previous one.
* `1.0×` = all adds equal size
* `>1.0×` = each add is larger (aggressive DCA)
* `<1.0×` = each add is smaller (tapered DCA)
4. **Define the first price gap**
* **Price change %** sets how far below the current price the first add is placed.
5. **Widen or narrow later gaps**
* **Orders price-change scale** multiplies the gap for each subsequent add.
* `1.0×` = even spacing
* `>1.0×` = wider spacing the deeper it goes
* `<1.0×` = tighter spacing
6. **Choose the execution style**
* **Market** — fills instantly (slippage possible).
* **Limit** — waits for your target price (no slippage, but fill is not guaranteed).
7. **Review the live preview** (right-hand panel)
* Confirms **base entry size**, each extra order’s **size** and **price offset**, plus total exposure.
8. **Adjust until satisfied**, then click **Next step** to move on to your exit and risk-management settings.
{% hint style="info" %}
**Tip:** If you’d rather trigger adds via external signals, flip to the **Alerts** tab instead of Preset.
{% endhint %}
### Configuring close orders
This screen defines how the bot will **exit** the position—take-profits (TP) in slices and a single stop-loss (SL). The right-hand panel updates live with the exact orders that will be sent.
1. **Stay in Custom → Preset**
* Confirm **Custom** risk management is active.
* **Close orders** toggle is **ON** and the **Preset** tab is selected.
2. **Enable Take-profit ladder**
* Switch **Take profit** to **ON**.
* Choose the execution style: **Market** (instant) or **Limit** (queue at target).
3. **Shape the TP ladder with four sliders**
| Control | Purpose | Tip |
| ------------------------------------------ | ------------------------------------------------------------------------------------------- | ----------------------------- |
| **Orders** (1 – 5) | How many TP slices you want. Current: **4**. | Fewer orders = larger chunks. |
| **Orders size scale** (0.1× – 2.5×) | Multiplier for each subsequent TP size. Current: **1.5×** (sizes grow). | 1.0× = equal volumes. |
| **Price change %** (1 % – 15 %) | Distance to the first TP from entry. Current: **8 %**. | Higher = more room to run. |
| **Orders price-change scale**(0.1× – 2.5×) | Widens or tightens spacing between later TPs. Current: **1.4×**(each target further apart). | 1.0× = even spacing. |
Type exact numbers in the white input boxes on the right if needed.
4. **Set a Stop-loss (optional but recommended)**
* Toggle **Stop Loss** **ON**.
* Pick **Market** or **Limit**.
* Drag the slider **Price change %** (-10 % – -1 %) or type the value. Current example: **-5 %**.
5. **Review the real-time summary**
* The **Close orders** preview shows:
* Four TP slices with volumes **12.31 % / 18.46 % / 27.69 % / 41.54 %** at **8 % / 19.20 % / 34.88 % / 56.83 %** price targets.
* A single **-5 %** stop-loss.
6. **Adjust if necessary**, then click **Create bot** to finish or **Back** to tweak previous steps.
Once saved, the bot will automatically scale out of the position at each TP level or exit completely at the stop-loss, exactly as defined here.
{% endtab %}
{% tab title="Alert mode" %}
{% endtab %}
{% endtabs %}
***
### 4 · Launch the bot
1. Review the summary at the bottom of the Configurator.
2. Hit **Create Bot**.
3. **Give your bot a name** (something you’ll recognise in logs).
4. Start the bot
Your Alert Bot is now running! Monitor open orders, PnL, and alert logs under **My Bots**.
