Tracks activities for specific addresses on the P or X chains.

  • 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.
{
	"webhookId": "c16f9dd6-9e07-49cd-bee2-7770cd797278",
	"eventType": "platform_address_activity",
	"messageId": "5101a28a-da03-479f-a0f9-6499014689bc",
	"event": {
		"eventType": "balance_change",
		"addresses": [
			"fuji1xp395ktf5kqfv9qyv2astt6fhnc4605pqwrf40"
		],
		"timestamp": 1742409843,
		"initialBalance": {
			"balances": {
				"unlockedStaked": [

				],
				"unlockedUnstaked": [

				],
				"lockedStaked": [

				],
				"lockedPlatform": [

				],
				"lockedStakeable": [

				],
				"pendingStaked": [

				],
				"atomicMemoryLocked": [

				],
				"atomicMemoryUnlocked": [
					{
						"assetId": "U8iRqJoiJm8xZHAacmvYyZVwqQx6uDNtQeP3CQ6fcgQk3JqnK",
						"name": "Avalanche",
						"symbol": "AVAX",
						"denomination": 9,
						"type": "secp256k1",
						"amount": "5000000000",
						"utxoCount": 1,
						"status": "pendingImport",
						"sharedWithChainId": "yH8D7ThNJkxmtkuv2jgBa4P1Rn3Qpr4pPr7QYNfcdoS6k6HWp"
					}
				]
			},
			"chainInfo": {
				"chainName": "p-chain",
				"network": "fuji"
			}
		},
		"finalBalance": {
			"balances": {
				"unlockedStaked": [

				],
				"unlockedUnstaked": [
					{
						"assetId": "U8iRqJoiJm8xZHAacmvYyZVwqQx6uDNtQeP3CQ6fcgQk3JqnK",
						"name": "Avalanche",
						"symbol": "AVAX",
						"denomination": 9,
						"type": "secp256k1",
						"amount": "4999995865",
						"utxoCount": 1
					}
				],
				"lockedStaked": [

				],
				"lockedPlatform": [

				],
				"lockedStakeable": [

				],
				"pendingStaked": [

				],
				"atomicMemoryLocked": [

				],
				"atomicMemoryUnlocked": [

				]
			},
			"chainInfo": {
				"chainName": "p-chain",
				"network": "fuji"
			}
		},
		"tx": {
			"txHash": "2F1b1kWAGFrGQYoVzPS8DzSYhwcix1JgYb9ctDpw4teNp8QiKS",
			"txType": "ImportTx",
			"blockTimestamp": 1742409843,
			"blockNumber": "203660",
			"blockHash": "26Q16Kson46jqWML9zyjwFaHksNk9xx1JojP1DaT9VtjLHBQS",
			"sourceChain": "yH8D7ThNJkxmtkuv2jgBa4P1Rn3Qpr4pPr7QYNfcdoS6k6HWp",
			"destinationChain": "11111111111111111111111111111111LpoYY",
			"memo": "0x",
			"consumedUtxos": [
				{
					"addresses": [
						"fuji1xp395ktf5kqfv9qyv2astt6fhnc4605pqwrf40"
					],
					"utxoId": "2KowNALbesyXaTJu2CrXuwGPo3jdEDwCymM9PCSg7v7ZM6PPz5",
					"txHash": "ACeSGBDHqJtmYtyHvsFgKFY7zwJKrwcJuQFdaPsw2yp3PMwEE",
					"outputIndex": 0,
					"blockTimestamp": 1742409832,
					"blockNumber": "38708400",
					"consumingTxHash": "2F1b1kWAGFrGQYoVzPS8DzSYhwcix1JgYb9ctDpw4teNp8QiKS",
					"consumingBlockTimestamp": 1742409843,
					"consumingBlockNumber": "203660",
					"assetId": "U8iRqJoiJm8xZHAacmvYyZVwqQx6uDNtQeP3CQ6fcgQk3JqnK",
					"asset": {
						"assetId": "U8iRqJoiJm8xZHAacmvYyZVwqQx6uDNtQeP3CQ6fcgQk3JqnK",
						"name": "Avalanche",
						"symbol": "AVAX",
						"denomination": 9,
						"type": "secp256k1",
						"amount": "5000000000"
					},
					"utxoType": "TRANSFER",
					"amount": "5000000000",
					"platformLocktime": 0,
					"threshold": 1,
					"createdOnChainId": "yH8D7ThNJkxmtkuv2jgBa4P1Rn3Qpr4pPr7QYNfcdoS6k6HWp",
					"consumedOnChainId": "11111111111111111111111111111111LpoYY",
					"staked": false
				}
			],
			"emittedUtxos": [
				{
					"addresses": [
						"fuji1xp395ktf5kqfv9qyv2astt6fhnc4605pqwrf40"
					],
					"utxoId": "2bD3ygVJURRtKPjuwZU9iPcBteRdzez6Fbb3XFxxxv1cDy1UXX",
					"txHash": "2F1b1kWAGFrGQYoVzPS8DzSYhwcix1JgYb9ctDpw4teNp8QiKS",
					"outputIndex": 0,
					"blockTimestamp": 1742409843,
					"blockNumber": "203660",
					"assetId": "U8iRqJoiJm8xZHAacmvYyZVwqQx6uDNtQeP3CQ6fcgQk3JqnK",
					"asset": {
						"assetId": "U8iRqJoiJm8xZHAacmvYyZVwqQx6uDNtQeP3CQ6fcgQk3JqnK",
						"name": "Avalanche",
						"symbol": "AVAX",
						"denomination": 9,
						"type": "secp256k1",
						"amount": "4999995865"
					},
					"utxoType": "TRANSFER",
					"amount": "4999995865",
					"platformLocktime": 0,
					"threshold": 1,
					"createdOnChainId": "11111111111111111111111111111111LpoYY",
					"consumedOnChainId": "11111111111111111111111111111111LpoYY",
					"staked": false
				}
			],
			"value": [
				{
					"assetId": "U8iRqJoiJm8xZHAacmvYyZVwqQx6uDNtQeP3CQ6fcgQk3JqnK",
					"name": "Avalanche",
					"symbol": "AVAX",
					"denomination": 9,
					"type": "secp256k1",
					"amount": "4999995865"
				}
			],
			"amountBurned": [
				{
					"assetId": "U8iRqJoiJm8xZHAacmvYyZVwqQx6uDNtQeP3CQ6fcgQk3JqnK",
					"name": "Avalanche",
					"symbol": "AVAX",
					"denomination": 9,
					"type": "secp256k1",
					"amount": "4135"
				}
			],
			"amountStaked": [
				{
					"assetId": "U8iRqJoiJm8xZHAacmvYyZVwqQx6uDNtQeP3CQ6fcgQk3JqnK",
					"name": "Avalanche",
					"symbol": "AVAX",
					"denomination": 9,
					"type": "secp256k1",
					"amount": "0"
				}
			],
			"amountL1ValidatorBalanceBurned": [
				{
					"assetId": "U8iRqJoiJm8xZHAacmvYyZVwqQx6uDNtQeP3CQ6fcgQk3JqnK",
					"name": "Avalanche",
					"symbol": "AVAX",
					"denomination": 9,
					"type": "secp256k1",
					"amount": "0"
				}
			]
		}
	}
}

​
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.
{
  "webhookId": "89266b1b-61a1-40f7-a309-59af999a048b",
  "eventType": "validator_activity",
  "messageId": "396356c9-037c-416a-a36f-1b7f70e0574e",
  "event": {
    "eventType": "reward_distribution",
    "nodeID": "NodeID-9odH3Jbw7uPuRrbaVkVoYeitdzwX6o69A",
    "subnetID": "11111111111111111111111111111111LpoYY",
    "rewardAddresses": ["avax19zfygxaf59stehzedhxjesads0p5jdvfeedal0"],
    "amount": "418590717",
    "rewardType": "DELEGATOR",
    "rewardTxHash": "2DP6xCr6MfLpwPrkzw5A2cNRZrJLwQpt1VB6uQZyDjS9NJdHgT",
    "stakingTxHash": "2AD5bSwqK7iTSkDqzYHXDeEeipWKHAsUsHoPy4bpuVzEP2AdEN",
    "rewardTx": {
      "txHash": "2DP6xCr6MfLpwPrkzw5A2cNRZrJLwQpt1VB6uQZyDjS9NJdHgT",
      "txType": "RewardValidatorTx",
      "blockTimestamp": 1742844464,
      "blockNumber": "20994230",
      "blockHash": "2E9vKCP9fqNSkCR5JBXFBN9aCaiUdhr6TQVr6q5EzSMH5QNxwr",
      "memo": "",
      "stakingTxHash": "2AD5bSwqK7iTSkDqzYHXDeEeipWKHAsUsHoPy4bpuVzEP2AdEN",
      "rewardAddresses": ["avax19zfygxaf59stehzedhxjesads0p5jdvfeedal0"],
      "nodeId": "NodeID-9odH3Jbw7uPuRrbaVkVoYeitdzwX6o69A",
      "subnetId": "11111111111111111111111111111111LpoYY",
      "consumedUtxos": [],
      "emittedUtxos": [],
      "value": [],
      "amountBurned": [],
      "amountStaked": [],
      "amountL1ValidatorBalanceBurned": []
    },
    "stakingTx": {
      "txHash": "2AD5bSwqK7iTSkDqzYHXDeEeipWKHAsUsHoPy4bpuVzEP2AdEN",
      "txType": "AddPermissionlessDelegatorTx",
      "blockTimestamp": 1741616501,
      "blockNumber": "20892409",
      "blockHash": "2dGUzofDNRiS5rBV5v9117cruTg5ye6t6Nan8NxZPr3yHwXBd7",
      "memo": "0x",
      "rewardAddresses": ["avax19zfygxaf59stehzedhxjesads0p5jdvfeedal0"],
      "rewardTxHash": "2DP6xCr6MfLpwPrkzw5A2cNRZrJLwQpt1VB6uQZyDjS9NJdHgT",
      "estimatedReward": "427133385",
      "startTimestamp": 1741616501,
      "endTimestamp": 1742844464,
      "nodeId": "NodeID-9odH3Jbw7uPuRrbaVkVoYeitdzwX6o69A",
      "subnetId": "11111111111111111111111111111111LpoYY",
      "consumedUtxos": [
        {
          "addresses": ["avax1tnuesf6cqwnjw7fxjyk7lhch0vhf0v95wj5jvy"],
          "utxoId": "2VnBenu1FEjhdmrjCXkYDEZk5o55ktYyaSqxprTBZaWVSGmwN1",
          "txHash": "2Nj6eZ28RZqNesbFSeTrU321y33PKcbS7s4JAypJbdULLUhEN6",
          "outputIndex": 0,
          "blockTimestamp": 1741616499,
          "blockNumber": "20892408",
          "consumingTxHash": "2AD5bSwqK7iTSkDqzYHXDeEeipWKHAsUsHoPy4bpuVzEP2AdEN",
          "consumingBlockTimestamp": 1741616501,
          "consumingBlockNumber": "20892409",
          "assetId": "FvwEAhmxKfeiG8SnEvq42hc6whRyY3EFYAvebMqDNDGCgxN5Z",
          "asset": {
            "assetId": "FvwEAhmxKfeiG8SnEvq42hc6whRyY3EFYAvebMqDNDGCgxN5Z",
            "name": "Avalanche",
            "symbol": "AVAX",
            "denomination": 9,
            "type": "secp256k1",
            "amount": "309353245914"
          },
          "utxoType": "TRANSFER",
          "amount": "309353245914",
          "platformLocktime": 0,
          "threshold": 1,
          "createdOnChainId": "11111111111111111111111111111111LpoYY",
          "consumedOnChainId": "11111111111111111111111111111111LpoYY",
          "staked": false
        }
      ],
      "emittedUtxos": [
        {
          "addresses": ["avax1tnuesf6cqwnjw7fxjyk7lhch0vhf0v95wj5jvy"],
          "utxoId": "ChNnDNhk7uNFeEeyZS4eupKELvVudapPoVVjNdqZvRcXdZD8Y",
          "txHash": "2AD5bSwqK7iTSkDqzYHXDeEeipWKHAsUsHoPy4bpuVzEP2AdEN",
          "outputIndex": 0,
          "blockTimestamp": 1741616501,
          "blockNumber": "20892409",
          "consumingTxHash": "FHFNCnGJgy6iTA1ePUwgfWq5VAv2vGiY74P5B5b7NWUsoRQUk",
          "consumingBlockTimestamp": 1741616503,
          "consumingBlockNumber": "20892410",
          "assetId": "FvwEAhmxKfeiG8SnEvq42hc6whRyY3EFYAvebMqDNDGCgxN5Z",
          "asset": {
            "assetId": "FvwEAhmxKfeiG8SnEvq42hc6whRyY3EFYAvebMqDNDGCgxN5Z",
            "name": "Avalanche",
            "symbol": "AVAX",
            "denomination": 9,
            "type": "secp256k1",
            "amount": "121941742101"
          },
          "utxoType": "TRANSFER",
          "amount": "121941742101",
          "platformLocktime": 0,
          "threshold": 1,
          "createdOnChainId": "11111111111111111111111111111111LpoYY",
          "consumedOnChainId": "11111111111111111111111111111111LpoYY",
          "staked": false
        },
        {
          "addresses": ["avax1tnuesf6cqwnjw7fxjyk7lhch0vhf0v95wj5jvy"],
          "utxoId": "fWw6hCrtTAWzid3gnZWoAML9dGLrTSKwme9NgDsKAd25zQeRK",
          "txHash": "2AD5bSwqK7iTSkDqzYHXDeEeipWKHAsUsHoPy4bpuVzEP2AdEN",
          "outputIndex": 1,
          "blockTimestamp": 1741616501,
          "blockNumber": "20892409",
          "assetId": "FvwEAhmxKfeiG8SnEvq42hc6whRyY3EFYAvebMqDNDGCgxN5Z",
          "asset": {
            "assetId": "FvwEAhmxKfeiG8SnEvq42hc6whRyY3EFYAvebMqDNDGCgxN5Z",
            "name": "Avalanche",
            "symbol": "AVAX",
            "denomination": 9,
            "type": "secp256k1",
            "amount": "187411495514"
          },
          "utxoType": "TRANSFER",
          "amount": "187411495514",
          "platformLocktime": 0,
          "threshold": 1,
          "createdOnChainId": "11111111111111111111111111111111LpoYY",
          "consumedOnChainId": "11111111111111111111111111111111LpoYY",
          "staked": true,
          "utxoStartTimestamp": 1741616501,
          "utxoEndTimestamp": 1742844464
        },
        {
          "addresses": ["avax19zfygxaf59stehzedhxjesads0p5jdvfeedal0"],
          "utxoId": "qJmWca11ztcU6zemVBsmgpFD5YPWDAHpYvKitw7tRsbcYH1gi",
          "txHash": "2AD5bSwqK7iTSkDqzYHXDeEeipWKHAsUsHoPy4bpuVzEP2AdEN",
          "outputIndex": 2,
          "blockTimestamp": 1742844464,
          "blockNumber": "20994230",
          "assetId": "FvwEAhmxKfeiG8SnEvq42hc6whRyY3EFYAvebMqDNDGCgxN5Z",
          "asset": {
            "assetId": "FvwEAhmxKfeiG8SnEvq42hc6whRyY3EFYAvebMqDNDGCgxN5Z",
            "name": "Avalanche",
            "symbol": "AVAX",
            "denomination": 9,
            "type": "secp256k1",
            "amount": "418590717"
          },
          "utxoType": "TRANSFER",
          "amount": "418590717",
          "platformLocktime": 0,
          "threshold": 1,
          "createdOnChainId": "11111111111111111111111111111111LpoYY",
          "consumedOnChainId": "11111111111111111111111111111111LpoYY",
          "staked": false,
          "rewardType": "DELEGATOR"
        }
      ],
      "value": [
        {
          "assetId": "FvwEAhmxKfeiG8SnEvq42hc6whRyY3EFYAvebMqDNDGCgxN5Z",
          "name": "Avalanche",
          "symbol": "AVAX",
          "denomination": 9,
          "type": "secp256k1",
          "amount": "309771828332"
        }
      ],
      "amountBurned": [
        {
          "assetId": "FvwEAhmxKfeiG8SnEvq42hc6whRyY3EFYAvebMqDNDGCgxN5Z",
          "name": "Avalanche",
          "symbol": "AVAX",
          "denomination": 9,
          "type": "secp256k1",
          "amount": "8299"
        }
      ],
      "amountStaked": [
        {
          "assetId": "FvwEAhmxKfeiG8SnEvq42hc6whRyY3EFYAvebMqDNDGCgxN5Z",
          "name": "Avalanche",
          "symbol": "AVAX",
          "denomination": 9,
          "type": "secp256k1",
          "amount": "187411495514"
        }
      ],
      "amountL1ValidatorBalanceBurned": [
        {
          "assetId": "FvwEAhmxKfeiG8SnEvq42hc6whRyY3EFYAvebMqDNDGCgxN5Z",
          "name": "Avalanche",
          "symbol": "AVAX",
          "denomination": 9,
          "type": "secp256k1",
          "amount": "0"
        }
      ]
    }
  }
}

​
Balance Threshold

The balance_threshold_platform event is triggered when the balance of specified key addresses falls below a given threshold.

On the P-Chain and X-Chain, multiple balance types exist, which you can explore here. To track this event, users must provide both a balanceType and a balanceThreshold (in nAVAX).

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).
{
  “addresses”: string[],
  “timestamp”: number,
  "balanceType": string,
  "threshold": number,
  “initialBalance”: GlacierPChainBalanceType,
  “finalBalance”: GlacierPChainBalanceType,
  “tx”: GlacierPChainTx
}

Was this page helpful?