Major price changes variation notification
When subscribed to this webhook, the platform will receive a notification when the price of the subscribed asset moves up or down certain thresholds:
- 5%
- 10%
- 15%
Over specific time periods (these are rolling time windows):
- 1 hour: within the last hour
- 12 hours: within the last 12 hours
- 24 hours: within the last 24 hours
This way platforms can keep their customers up to date with big price swings on the assets.
Note: The x-zh-hook-payload-type
to subscribe for is asset_mover_updated
.
Once the platform is setup, the payload of the webhook will contain the following fields:
Parameter | Description | Type |
---|---|---|
alerts | The array with alerts of the different moves detected | array |
asset | Symbol of the asset that the alert is related to (i.e. EOS ) | string |
price | Array with the price and its changes in time for the specific asset. | string |
updated | Timestamp of the update for the price change alert | timestamp |
For the alerts
array, the following structure would be included for each threshold reached:
Parameter | Description | Type |
---|---|---|
threshold | Specific percentage threshold reached on the price change in percentage mode: - 0.05 is 5%- 0.10 is 10%- 0.15 is 15% | string |
period | Period of time the alert is covering in seconds: - 3600 is 1 hour- 43200 is 12 hours- 86400 is 24 hours | string |
For the price
array, the following structure is represented:
Parameter | Description | Type |
---|---|---|
current | Current price of the asset in USD at the moment of the notification | string |
delta_1h | Change in price of the asset (in USD) within the last 1 hour | string |
delta_12h | Change in price of the asset (in USD) within the last 12 hours | string |
delta_24h | Change in price of the asset (in USD) within the last 24 hours |
Payloads
Sample payload for this webhook:
{
"alerts": [
{
"period": "3600",
"threshold": "0.05"
},
{
"period": "43200",
"threshold": "0.10"
},
{
"period": "86400",
"threshold": "0.15"
}
],
"asset": "EOS",
"price": {
"current": "0.58549364858817800000",
"delta_12h": "0.066770",
"delta_1h": "0.005193",
"delta_24h": "0.045297"
},
"timestamp": 1744637883976,
"updated": "2025-03-30 08:00:00"
},