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.
{
	"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

 {
  "addresses": ["fuji1aerex08szh4ge5g7sggsddkpdhyzhja9f6v7y0"],
  "timestamp": 1698765432,
  "balanceType": "unlockedUnstaked",
  "threshold": "5500000000",
  "initialBalance": {"unlockedUnstaked": "6000000000"},
  "finalBalance": {"unlockedUnstaked": "5000000000"},
  "tx": {"txId": "def456..."}
}

Was this page helpful?