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

# Token Price Alert

Triggers when a token's price crosses your target — above, below, or equal to a value. Sourced from centralized exchange data via Stork Oracle.

Trigger Markets

Triggers when a token's price crosses your target — above, below, or equal to a value. Sourced from centralized exchange data via Stork Oracle.

## At a Glance

| Field | Value |
| --- | --- |
| Trigger ID | `token-price-cexes` |
| Category | Markets |
| Tags | `price`, `token`, `defi`, `trading`, `alert`, `oracle`, `cex` |

## Trigger Configuration

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `asset` | `string` | Yes | Asset pair symbol \(e.g., BTCUSD, ETHUSD\) |
| `targetPrice` | `number` | Yes | - |
| `operation` | `string` | Yes | - |
| `maxTriggers` | `string` | No | Trigger frequency |

## Trigger Result

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `price` | `number` | Yes | Price in USD \(for condition comparison\) |
| `triggeredAt` | `string` | Yes | UTC timestamp in RFC3339 format \(e.g., 2025-12-13T07:03:00.123456Z\) |
| `rawResponse` | `object` | Yes | Full oracle price data \(timestamp, signatures, price in raw format, etc.\) |

## Workflow Root Example

```json
{
  "nodes": {
    "root": {
      "type": "token-price-cexes",
      "payload": {
        "asset": "ETH",
        "targetPrice": 1,
        "operation": "cross-up"
      },
      "children": [
        "log_event"
      ]
    },
    "log_event": {
      "type": "log",
      "payload": {
        "message": "Triggered at {{$trigger.triggeredAt}}"
      },
      "children": []
    }
  }
}
```

**Reference trigger output**

Downstream nodes can use `{{$trigger.triggeredAt}}` and any result fields listed above. Event triggers usually expose the raw source payload under a field such as `event`, `body`, `trade`, or `raw`.