ADDRESS_ACTIVITY

사용자가 지정한 주소 배열에 포함된 계정들의 활동을 모니터링합니다. 이 이벤트는 해당 계정들이 트랜잭션의 발신자(from) 또는 수신자(to)로 포함되어 있는 경우, 즉 트랜잭션, 토큰 전송(ERC20), 또는 NFT 전송(ERC721, ERC1155)이 발생할 때마다 알림을 제공합니다. 이 서비스는 사용자가 다수의 주소에 대한 활동을 실시간으로 파악할 수 있게 해 주어, 자산의 이동과 거래를 효과적으로 추적할 수 있도록 돕습니다.

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

eventType값을 ADDRESS_ACTIVITY로 설정하는 경우, 사용 가능한 condition 객체 필드는 아래와 같습니다. Value에 등록된 모든 주소들과 관련된 트랜잭션, 토큰(ERC20) Transfer, 또는 NFT(ERC721, ERC1155) Transfer가 발생하는 경우 메시지를 수신할 수 있습니다.

Key	Type	Required	Description	Example Value
addresses	Array of Address	true	이벤트를 모니터링 하고자 하는 주소들의 목록입니다.	["0xe688b84b23f322a994a53dbf8e15fa82cdb71127", "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"]

Response Example

🚧
Response 필드는 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"
    }
  ]
}

Supported Network

Conditions

Response Example

🚧Response 필드는 Event type에 따라 달라질 수 있습니다.

📍 Type: Transaction

📍 Type: ERC20

📍 Type: ERC721

📍 Type: ERC1155

🚧
Response 필드는 Event type에 따라 달라질 수 있습니다.