# Notifications & Alerts

ARCHONE keeps you informed about your trades, positions, and market events through multiple notification channels. Configure how and when you receive alerts.

***

## Notification Types

### Trade Notifications

Sent when a buy or sell executes:

* Trade type (BUY/SELL)
* Token traded
* Amount in SOL
* Transaction hash
* P\&L for sells

### P\&L Notifications

Sent when a position's profit/loss changes significantly:

* Token symbol
* Current P\&L percentage
* Position size

### Price Alerts

Sent when a token reaches your target price:

* Current price
* Target price
* Direction (above/below)

### Daily Summary

Sent once per day with your trading recap:

* Open positions count
* Trades executed today
* Today's P\&L
* Total unrealized P\&L

### DCA Notifications

Sent when a DCA interval executes:

* Token traded
* Amount purchased
* Orders completed vs. total
* Remaining amount

### System Notifications

Important alerts about your account:

* Agent pauses/resumes
* Subscription status changes
* Security events (new device login)

***

## Configuring Notifications

### Step-by-Step

1. **Send `/settings`**
2. **Select "Notifications"**
3. **Toggle each notification type** — Enable or disable as desired

### Notification Settings

| Setting                 | Default | Description                            |
| ----------------------- | ------- | -------------------------------------- |
| **Trade Notifications** | On      | Get notified on every buy/sell         |
| **P\&L Notifications**  | On      | Alerts when P\&L changes significantly |
| **Price Alerts**        | On      | Alerts when tokens hit target prices   |
| **Daily Summary**       | On      | End-of-day recap                       |
| **DCA Notifications**   | On      | Alerts when DCA orders execute         |

***

## Notification Channels

### Telegram

The default channel for all notifications. No additional setup required if you're using the bot.

### Email

Receive notifications via email.

**Setup:**

1. Send `/settings`
2. Select **Notifications**
3. Toggle **Email Notifications**
4. Enter your email address

### Webhook

Send notifications to an external URL (discord, Slack, custom server, etc.).

**Setup:**

1. Send `/settings`
2. Select **Notifications**
3. Toggle **Webhook Notifications**
4. Enter your webhook URL

**Webhook Payload:**

```json
{
  "type": "TRADE",
  "message": "🟢 BUY executed\n\nToken: $EXAMPLE\nAmount: 0.5 SOL",
  "data": {
    "tradeId": "xxx",
    "txHash": "xxx"
  },
  "timestamp": "2024-01-15T12:00:00Z"
}
```

***

## Price Alerts

### Setting a Price Alert

1. **Send `/settings`**
2. **Select "Price Alerts"**
3. **Enter token address** — The token you want to monitor
4. **Enter target price** — The price that triggers the alert
5. **Choose direction** — Above or below current price
6. **Confirm** — Alert is now active

### Price Alert Behavior

* Alerts check continuously while the bot is running
* When the price crosses your target, you receive a notification
* Alerts stay active until triggered or manually cancelled

### Managing Price Alerts

From **Price Alerts** menu:

* **View Active** — List all your price alerts
* **Cancel** — Remove an individual alert
* **Cancel All** — Remove all alerts

***

## Daily Summary

The daily summary is sent automatically if enabled. It includes:

* Number of open positions
* Trades executed in the last 24 hours
* Today's P\&L
* Total unrealized P\&L across all positions

**When it's sent:** Once per day, typically at midnight (your local timezone may vary).

***

## Notification Preferences

### Per-Feature Settings

You can configure notifications differently for each feature:

| Feature          | How to Configure                                 |
| ---------------- | ------------------------------------------------ |
| **Trading**      | Set in `/settings` or per-trade                  |
| **Agents**       | Set when creating the agent or in agent settings |
| **Copy Trading** | Set in `/settings` or per-follow                 |
| **DCA**          | Set when creating DCA or in DCA settings         |

### Muting

If you need a break from notifications:

1. Send `/settings`
2. Select **Notifications**
3. Toggle **All Notifications** off

This pauses all notifications until you re-enable them.

***

## Troubleshooting

### Not Receiving Notifications

| Check                                         | Fix                                   |
| --------------------------------------------- | ------------------------------------- |
| Notifications enabled                         | Verify in `/settings` → Notifications |
| Telegram notifications enabled on your device | Check Telegram settings               |
| Bot not running                               | Start/restart the bot                 |
| Notifications paused                          | Re-enable in settings                 |

### Too Many Notifications

If you're getting too many alerts:

* Increase P\&L alert threshold
* Disable daily summary
* Disable copy trading notifications if following many traders
* Disable DCA notifications if running many strategies

### Wrong Channel

If notifications go to the wrong channel:

* Check your notification settings in `/settings`
* Verify email/webhook URLs are correct
* Make sure you're not muted in Telegram

***

## Notification Timing

| Notification Type | When It Fires                                  |
| ----------------- | ---------------------------------------------- |
| Trade             | Immediately after transaction confirms         |
| P\&L              | When P\&L changes > 10% from last notification |
| Price Alert       | When price crosses target                      |
| Daily Summary     | Once per day (midnight)                        |
| DCA               | After each interval executes                   |
| System            | As events occur                                |

***

## Best Practices

### Stay Informed Without Overwhelm

* Enable only the notifications you need
* Use email for important alerts (trades, security)
* Use Telegram for real-time alerts (DCA, copy trades)
* Use webhooks for integration with other tools

### Recommended Settings

**Active Trader:**

* Trade: On
* P\&L: On
* Daily Summary: On
* DCA: On

**Passive (Copy Trading):**

* Trade: On (copy trades)
* P\&L: On
* Daily Summary: On
* DCA: Off (too frequent)


---

# 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.archone.trade/core-features/notifications.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.