Skip to main content
Tracks activities for specific addresses on the P or X chains. Address activity
  • Sub-events:
    • balance_change:Triggered whenever a transaction affects the balance of the tracked addresses.
    • balance_threshold:Triggered when the balance of a tracked address falls below a specified threshold for a particular balance type. The balance must transition from above the threshold to below it.
    • reward_distribution:Triggered when a tracked address receives a reward UTXO (e.g., staking or validator rewards).
You can subscribe to multiple sub-events in a single webhook, reducing the number of subscriptions you need to manage.

​
What Data Will You Receive?

When an event triggers your webhook, you’ll receive a JSON payload with details about the event. Here’s what to expect for each event:

​
Balance change

This notification describes a successful import of 5 AVAX from the C-chain to the P-chain for the address fuji1xp395ktf5kqfv9qyv2astt6fhnc4605pqwrf40. The balance change event describes an ImportTx transaction on the Avalanche Fuji testnet where:
  1. The address fuji1xp395ktf5kqfv9qyv2astt6fhnc4605pqwrf40 had 5 AVAX (5,000,000,000 nanoAVAX) pending import from the X-Chain.
  2. The transaction 2F1b1kWAGFrGQYoVzPS8DzSYhwcix1JgYb9ctDpw4teNp8QiKS successfully imported these funds to the P-Chain.
  3. A fee of 4,135 nanoAVAX was paid, resulting in a final balance of 4,999,995,865 nanoAVAX (approximately 4.999995865 AVAX) on the P-Chain, categorized as unlockedUnstaked.
If a webhook is created with 10 addresses and an event (tx) is triggered involving 4 addresses—only 3 of which match the webhook subscription—the balance change event will return the combined balance of those 3 matching addresses.

​
Reward distribution

This payload shows a successful reward distribution event. The delegator staked 187.4115 AVAX with a validator for approximately 14 days and earned a reward of 0.4186 AVAX, which was paid out to their designated address. Delegation:
  • On September 5, 2025, the delegator staked approximately 187.4115 AVAX with the validator NodeID-9odH3Jbw7uPuRrbaVkVoYeitdzwX6o69A via transaction 2AD5bSwqK7iTSkDqzYHXDeEeipWKHAsUsHoPy4bpuVzEP2AdEN
  • The staking period lasted about 14.2 days, ending on September 18, 2025.
Reward Distribution:
  • At the end of the staking period, the delegator received a reward of approximately 0.4186 AVAX, distributed via transaction 2DP6xCr6MfLpwPrkzw5A2cNRZrJLwQpt1VB6uQZyDjS9NJdHgT.
  • The reward was sent to avax19zfygxaf59stehzedhxjesads0p5jdvfeedal0
  • The actual reward is 0.4271 AVAX.

​
Balance Threshold

The balance_threshold event is triggered when the balance of specified key addresses falls below a given threshold. On the P-Chain and X-Chain, addresses can hold assets in various states, referred to as balance types, which you can explore here. To track this event, users must provide both a balanceType and a balanceThreshold (in nAVAX). Understanding balance types
  • unlockedUnstaked:Assets neither locked nor staked; immediately available for transactions.
  • unlockedStaked:Assets previously staked, now unlocked and available.
  • lockedPlatform:Unstaked assets locked at the platform level (not immediately usable).
  • lockedStakeable:Locked assets usable only for staking.
  • lockedStaked:Staked assets that remain locked post-staking period.
  • pendingStaked:Assets committed to staking, awaiting the staking period start.
  • atomicMemoryUnlocked:Unlocked assets in atomic memory (for cross-chain transfers).
  • atomicMemoryLocked:Locked assets in atomic memory.
Understanding these types helps you set precise thresholds and interpret balance-related webhook data. For detailed definitions, refer to the API documentation This event is only triggered when the post-transaction balance is lower than the specified threshold, and the pre-transaction balance was higher. Details it includes:
  • Which addresses are affected (addresses: a list of account IDs).
  • When it happened (timestamp).
  • What kind of balance is being tracked (balanceType).
  • The minimum limit that was crossed (threshold).
  • The balance before the transaction (initialBalance).
  • The balance after the transaction (finalBalance).
  • The transaction that caused the drop (tx).