Asset price change updates

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:

ParameterDescriptionType
alertsThe array with alerts of the different moves detectedarray
assetSymbol of the asset that the alert is related to (i.e. EOS)string
priceArray with the price and its changes in time for the specific asset.string
updatedTimestamp of the update for the price change alerttimestamp

For the alerts array, the following structure would be included for each threshold reached:

ParameterDescriptionType
thresholdSpecific percentage threshold reached on the price change in percentage mode:

- 0.05 is 5%
- 0.10 is 10%
- 0.15 is 15%
string
periodPeriod of time the alert is covering in seconds:

- 3600is 1 hour
- 43200 is 12 hours
- 86400 is 24 hours
string

For the price array, the following structure is represented:

ParameterDescriptionType
currentCurrent price of the asset in USD at the moment of the notificationstring
delta_1hChange in price of the asset (in USD) within the last 1 hourstring
delta_12hChange in price of the asset (in USD) within the last 12 hoursstring
delta_24hChange 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"
  },