ADDRESS_ACTIVITY

---

Supported Network

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

Conditions

When eventType is set to ADDRESS_ACTIVITY, the available condition object fields are listed below. A message is received whenever a transaction, ERC20 token transfer, or NFT (ERC721, ERC1155) transfer occurs involving any address registered in the value.

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

Response Example

Response fields may vary depending on the event type.

📍 Type: Transaction

subscription_connected The user(8350954814192461336) is connected. 
registered messageId: 123,
subscriptionId: 5074
subscription Event : 
  subscriptionId: 5074,
  eventType: ADDRESS_ACTIVITY,
  event: {
  "targetAddress": "0xdac17f958d2ee523a2206206994597c13d831ec7", // ⚠️ This field will be deprecated soon
  "targetAddresses": [
    "0xdac17f958d2ee523a2206206994597c13d831ec7"
  ],
  "messages": [
    {
      "block_hash": "0x0340186e5a762cca61285ca713d4b80231886343f103e56a290bd41b85969c49",
      "block_number": 21570981,
      "block_timestamp": 1736233451,
      "from_address": "0xeca19db2c8058c229a5b71e36276031fed05bb5b",
      "gas": 69355,
      "gas_price": 10953653697,
      "hash": "0xe4b61d57871c46bd3dba0baab1faea53e8bcc2608d70aac44bcffe81180d2897",
      "input": "0xa9059cbb0000000000000000000000009642b23ed1e01df1092b92641051881a322f5d4e0000000000000000000000000000000000000000000000000000000033464b7f",
      "max_fee_per_gas": null,
      "max_priority_fee_per_gas": null,
      "nonce": 0,
      "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": 10953653697,
      "receipt_gas_used": 41309,
      "receipt_root": null,
      "receipt_status": 1,
      "type": "transaction"
    }
  ]
}

📍 Type: ERC20

subscription_connected The user(8350954814192461336) is connected. 
registered messageId: 123,
subscriptionId: 5075
subscription Event :  subscriptionId: 5075,
eventType: ADDRESS_ACTIVITY,
event: {
  "targetAddress": "0xdac17f958d2ee523a2206206994597c13d831ec7", // ⚠️ This field will be deprecated soon
  "targetAddresses": [
    "0xdac17f958d2ee523a2206206994597c13d831ec7"
  ],
  "messages": [
    {
      "token_address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
      "from_address": "0xeca19db2c8058c229a5b71e36276031fed05bb5b",
      "to_address": "0x9642b23ed1e01df1092b92641051881a322f5d4e",
      "value": "860244863",
      "transaction_hash": "0xe4b61d57871c46bd3dba0baab1faea53e8bcc2608d70aac44bcffe81180d2897",
      "log_index": 0,
      "block_number": 21570981,
      "block_timestamp": 1736233451,
      "type": "erc20"
    },
    {
      "token_address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
      "from_address": "0x67e022256e5de118994476a621d709d658b65f04",
      "to_address": "0x5f3774670bef36ee9153436fca9a7b1bee23f313",
      "value": "105000000",
      "transaction_hash": "0x7f0de06dde3704d909f377b2031cf17ec1f98276ccc634ec48115d0f29a8507a",
      "log_index": 97,
      "block_number": 21570981,
      "block_timestamp": 1736233451,
      "type": "erc20"
    }
  ]
}

📍 Type: ERC721

subscription_connected The user(8350954814192461336) is connected.
registered messageId: 123,
subscriptionId: 5079
subscription Event : subscriptionId: 5079,
eventType: ADDRESS_ACTIVITY,
event: {
  "targetAddress": "0xbd3531da5cf5857e7cfaa92426877b022e612cf8", // ⚠️ This field will be deprecated soon
  "targetAddresses": [
    "0xbd3531da5cf5857e7cfaa92426877b022e612cf8"
  ],
  "messages": [
    {
      "token_address": "0xbd3531da5cf5857e7cfaa92426877b022e612cf8",
      "from_address": "0x64f56f2c0091c6daade892fd535b911b751618d1",
      "to_address": "0x066b4894be13ac0d49b24fc588668e428ec404e9",
      "token_id": "5811",
      "transaction_hash": "0xc08d9dbf8def48c4b420138c5de6be91ded13ea6d6c6e15eb9ad73a8e760f86f",
      "log_index": 139,
      "block_number": 21571140,
      "block_timestamp": 1736235359,
      "type": "erc721"
    }
  ]
}
  ]
}

📍 Type: ERC1155

subscription_connected The user(8350954814192461336) is connected.
registered messageId: 123,
subscriptionId: 5079
subscription Event : subscriptionId: 5079,
eventType: ADDRESS_ACTIVITY,
event: {
  "targetAddress": "0xd4416b13d2b3a9abae7acd5d6c2bbdbe25686401", , // ⚠️ This field will be deprecated soon
  "targetAddresses": ["0xd4416b13d2b3a9abae7acd5d6c2bbdbe25686401"],
  "messages": [
    {
      "batch_index": 0,
      "block_number": 21570325,
      "block_timestamp": 1736225555,
      "from_address": "0x0000000000000000000000000000000000000000",
      "log_index": 436,
      "operator": "0x253553366da8546fc250f225fe3d25d0c782303b",
      "to_address": "0xaa53fc83a445356c7aa22bfaf1ca7b7a71fa6d62",
      "token_address": "0xd4416b13d2b3a9abae7acd5d6c2bbdbe25686401",
      "token_id": "111132410891957713282240139609071409342652389978307630009530067920638862855368",
      "transaction_hash": "0x1feaa0015830869b964d4ed4cad3bba67a44e8f93c3994833c7b5320e172a986",
      "value": "1",
      "type": "erc1155"
    }
  ]
}