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

# Update Price Alerts

> Get an email and a webhook when a token held as collateral in your loans moves by a set percentage.

With a threshold set, GetEquity checks the sell price of each token held as collateral in your active loans once a day, at 17:00 UTC (18:00 in Lagos), after that day's stock and commodity closing prices are in. When one has moved by the threshold or more, up or down, since the last alert for that token, you are alerted by email and by a [`token.price_changed`](https://getequity.io/docs/api-reference/endpoint/Webhook/token-price-changed) webhook. The alert lists every loan holding that token with its current cover.

The move is measured from the last alert, not from the start of the day, so a slow slide still triggers an alert once it adds up to the threshold. The first time a token appears in your book, or when you turn alerts on, its current price becomes the starting point.

Each day's alerts arrive as one email to your organisation's email address, listing every token that moved. If you have a [webhook URL](https://getequity.io/docs/api-reference/endpoint/Webhook/webhook.md), you also receive one `token.price_changed` webhook per token; without one you still get the email. Only organisations with a credit loan configuration can turn alerts on.

**threshold\_percent** `number` *required*

The move, in percent, that triggers an alert: from 1 to 100. Send `0` or `null` to turn alerts off.

```json theme={null}
{ "threshold_percent": 5 }
```

```json theme={null}
{
  "status": "success",
  "message": "Price alert settings updated successfully",
  "data": {
    "threshold_percent": 5,
    "enabled": true,
    "event": "token.price_changed",
    "basis": "sell",
    "channels": ["email", "webhook"],
    "email": "credit@yourcompany.com",
    "is_creditor": true,
    "updated_at": "2026-11-16T10:00:00.000Z"
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.