> ## Documentation Index
> Fetch the complete documentation index at: https://kwala.network/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Token Price Triggers

> Run actions automatically when token prices reach specified thresholds.

Kwala monitors supported token price feeds and triggers workflows when configured price conditions are met.

When defining a token price trigger:

* Users specify a **Token** and **Target Price** in the workflow
* Kwala computes a **price range** around the live token price using the token’s configured price range percentage
* The workflow triggers when the configured target price falls within that range during evaluation

Common use cases include:

* Price alerts
* Auto-rebalancing
* Stop-loss protection
* DeFi automation

## How It Works

Token price triggers are evaluated at the configured heartbeat interval for each supported token.

During each evaluation:

1. Kwala fetches the latest token price
2. Computes the valid price range using the token’s configured percentage
3. Checks whether the configured target price falls within that range
4. Triggers the workflow if matched

Token prices are evaluated at every heartbeat interval for as long as the workflow remains active.

## Price Range Evaluation

Exact price matches are not required. Kwala uses a predefined price range percentage for each token to evaluate trigger condition.

### Example

Assume:

* Target Price mentioned in Kwala workflow = `100.2`
* Current Token Price = `100`
* Price Range Percentage = `0.5%`

Computed range:

* Lower Bound = `99.5`
* Upper Bound = `100.5`

Since `100.2` falls within `99.5` – `100.5`, the workflow is triggered.

## Heartbeat Interval

Heartbeat interval defines how frequently Kwala evaluates the latest price for a token.

This means workflows are **not triggered in real time** when the market price changes.
Instead, trigger conditions are evaluated during the next heartbeat check for that token.

## Supported Tokens

| Token   | Price Range Percentage | Heartbeat Interval |
| :------ | :--------------------- | :----------------- |
| BTC     | 0.5%                   | 20 minutes         |
| ETH     | 0.5%                   | 10 minutes         |
| BNB     | 1%                     | 1 minute           |
| POL     | 0.2                    | 3 minutes          |
| AVAX    | 0.1                    | 1 minute           |
| DOT     | 0.25%                  | 30 seconds         |
| ALGO    | 1                      | 24 hours           |
| APE     | 0.2                    | 20 minutes         |
| PEPE    | 0.5                    | 24 hours           |
| AUSD    | 0.5                    | 24 hours           |
| UNI     | 0.25                   | 1 minute           |
| CELO    | 0.5                    | 4 minutes          |
| Aave    | 0.45                   | 25 seconds         |
| SHIB    | 0.5                    | 24 hours           |
| Steller | 0.2                    | 10 minutes         |
| uHBAR   | 0.5                    | 24 hours           |
| cbLTC   | 0.3                    | 15 minutes         |
| Link    | 0.35                   | 30 seconds         |
| SUI     | 0.5                    | 24 hours           |
| APT     | 0.5                    | 24 hours           |
| ARB     | 0.5                    | 24 hours           |
| OP      | 0.2                    | 30 minutes         |
| TRX     | 0.2                    | 10 minutes         |
| DOGE    | 0.25                   | 40 seconds         |
| ADA     | 0.25                   | 1 minute           |
| 1INCH   | 0.25                   | 1 minute           |
| XRP     | 0.25                   | 1 minute           |
| XMR     | 0.2                    | 20 minutes         |
| SOL     | 2.0%                   | 20 seconds         |