Address Activity

---

Supported Network

Network	Supporting
Ethereum Mainnet	✅
Ethereum Testnet (sepolia)	✅
Ethereum Testnet (holesky)	✅
Base Mainnet	✅
Base Testnet(sepolia)	✅
Polygon Mainnet	✅
Polygon Testnet (amoy)	✅
Arbitrum Mainnet	✅
Arbitrum Testnet (sepolia)	✅
Optimism Mainnet	✅
Optimism Testnet (sepolia)	✅
Kaia Mainnet	✅
Kaia Testnet (kairos)	✅
Aptos Mainnet	❌
Aptos Testnet	❌

Webhook Creation Request Example

When setting the eventType value to ADDRESS_ACTIVITY, the available condition object fields are as follows. A Webhook message is received whenever a transaction, token (ERC20) transfer, or NFT (ERC721, ERC1155) transfer occurs involving any address registered in the addresses array.

Key	Type	Required	Description	Example Value
addresses	Array of Address	true	The list of addresses to monitor for events.	["0xdac17f958d2ee523a2206206994597c13d831ec7", "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"]

Request Example

curl --location 'https://web3.nodit.io/v1/ethereum/mainnet/webhooks' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: ••••••' \
--data '{
  "eventType": "ADDRESS_ACTIVITY",
  "description": "{WEBHOOK_DESCRIPTION}",
  "notification": {
    "webhookUrl": "{WEBHOOK_LISTENER_ENDPOINT}"
  },
  "isInstant": false,
  "condition": {
    "addresses": [
        "0xdAC17F958D2ee523a2206206994597C13D831ec7"
    ]
  }
}'

Response Example

:::warning Response fields may vary depending on the Event type that occurs. :::

###📍 Type: Transaction

{
  "subscriptionId": "4975",
  "sequenceNumber": "2",
  "description": "{WEBHOOK_DESCRIPTION}",
  "protocol": "ethereum",
  "network": "mainnet",
  "subscriptionType": "WEBHOOK",
  "notification": {
    "webhookUrl": "{WEBHOOK_LISTENER_ENDPOINT}"
  },
  "eventType": "ADDRESS_ACTIVITY",
  "event": {
    "targetAddress": "0xdac17f958d2ee523a2206206994597c13d831ec7", // ⚠️ This field will be deprecated soon
    "targetAddresses": [
			"0xdac17f958d2ee523a2206206994597c13d831ec7",
			"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"
		],
    "messages": [
      {
        "block_hash": "0x494be06126a80322fa5808168b0d1e180abbcb154591409d2fe7d4e6629f9089",
        "block_number": 21491830,
        "block_timestamp": 1735278755,
        "from_address": "0x199a08c6f0d587ebb1102843217d8be54dfa5a74",
        "gas": 69373,
        "gas_price": 10670603914,
        "hash": "0x1ad17c5fdc26ee40a5a086a839d715564c1f56a865fec4a96fb8ac64a7f246e9",
        "input": "0xa9059cbb0000000000000000000000009642b23ed1e01df1092b92641051881a322f5d4e0000000000000000000000000000000000000000000000000000000012ddef48",
        "max_fee_per_gas": null,
        "max_priority_fee_per_gas": null,
        "nonce": 2,
        "to_address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
        "transaction_index": 2,
        "transaction_type": 0,
        "value": "0",
        "access_list": null,
        "receipt_contract_address": null,
        "receipt_cumulative_gas_used": 83309,
        "receipt_effective_gas_price": 10670603914,
        "receipt_gas_used": 41309,
        "receipt_root": null,
        "receipt_status": 1,
        "type": "transaction"
      }
    ]
  },
  "createdAt": "2024-12-27T05:54:40.797Z"
}

📍 Type: ERC20

{
  "subscriptionId": "4975",
  "sequenceNumber": "2",
  "description": "{WEBHOOK_DESCRIPTION}",
  "protocol": "ethereum",
  "network": "mainnet",
  "subscriptionType": "WEBHOOK",
  "notification": {
    "webhookUrl": "{WEBHOOK_LISTENER_ENDPOINT}"
  },
  "eventType": "ADDRESS_ACTIVITY",
  "event": {
    "targetAddress": "0xdac17f958d2ee523a2206206994597c13d831ec7", // ⚠️ This field will be deprecated soon
    "targetAddresses": [
			"0xdac17f958d2ee523a2206206994597c13d831ec7",
			"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"
		],
    "messages": [
      {
        "token_address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
        "from_address": "0x199a08c6f0d587ebb1102843217d8be54dfa5a74",
        "to_address": "0x9642b23ed1e01df1092b92641051881a322f5d4e",
        "value": "316534600",
        "transaction_hash": "0x1ad17c5fdc26ee40a5a086a839d715564c1f56a865fec4a96fb8ac64a7f246e9",
        "log_index": 0,
        "block_number": 21491830,
        "block_timestamp": 1735278755,
        "type": "erc20"
      }
    ]
  },
  "createdAt": "2024-12-27T05:54:40.801Z"
}

📍 Type: ERC721

{
  "subscriptionId": "4975",
  "sequenceNumber": "2",
  "description": "{WEBHOOK_DESCRIPTION}",
  "protocol": "ethereum",
  "network": "mainnet",
  "subscriptionType": "WEBHOOK",
  "notification": {
    "webhookUrl": "{WEBHOOK_LISTENER_ENDPOINT}"
  },
  "eventType": "ADDRESS_ACTIVITY",
  "event": {
    "targetAddress": "0x59325733eb952a92e069c87f0a6168b29e80627f", // ⚠️ This field will be deprecated soon
    "targetAddresses": [
			"0x59325733eb952a92e069c87f0a6168b29e80627f",
			"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"
		],
    "messages": [
      {
        "token_address": "0x59325733eb952a92e069c87f0a6168b29e80627f",
        "from_address": "0x3bf56c083ef2de9c79df6edde9c95a29a1f11044",
        "to_address": "0x3bd3ebadbfb6b30139fe747a57acc18ce090575c",
        "token_id": "3255",
        "transaction_hash": "0x16c181ac5c9c53a8bbf5f42fe47be344565f7baf3412b934b43db0ae0c7ce3ed",
        "log_index": 171,
        "block_number": 21491933,
        "block_timestamp": 1735280015,
        "type": "erc721"
      }
    ]
  },
  "createdAt": "2024-12-27T06:15:37.335Z"
}

📍 Type: ERC1155

{
  "subscriptionId": "4975",
  "sequenceNumber": "2",
  "description": "{WEBHOOK_DESCRIPTION}",
  "protocol": "ethereum",
  "network": "mainnet",
  "subscriptionType": "WEBHOOK",
  "notification": {
    "webhookUrl": "{WEBHOOK_LISTENER_ENDPOINT}"
  },
  "eventType": "ADDRESS_ACTIVITY",
  "event": {
    "targetAddress": "0x7e6027a6a84fc1f6db6782c523efe62c923e46ff", // ⚠️ This field will be deprecated soon
    "targetAddresses": [
			"0x7e6027a6a84fc1f6db6782c523efe62c923e46ff",
			"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"
		],
    "messages": [
      {
        "batch_index": 0,
        "block_number": 21491967,
        "block_timestamp": 1735280423,
        "from_address": "0xa0c6db727ce729f49dc23dafe905fe61fa65324b",
        "log_index": 745,
        "operator": "0x1e0049783f008a0085193e00003d00cd54003c71",
        "to_address": "0x9878e0079f5d51241e4dadea3d3ef9d5cfb9361e",
        "token_address": "0x7e6027a6a84fc1f6db6782c523efe62c923e46ff",
        "token_id": "12280399071338265579933953693534156686237169383673762100623894355092729371128",
        "transaction_hash": "0xefc3acb7ebfe6e5ada1c2890df884599ead6a585e357d686e347cc8aeb684bbb",
        "value": "1",
        "type": "erc1155"
      }
    ]
  },
  "createdAt": "2024-12-27T06:22:05.509Z"
}