ALLOW_LIST_CALLER

---

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 setting the eventType value to ALLOW_LIST_CALLER, the available condition object fields are as follows.

Key	Type	Required	Description	Example Value
address	String	true	The target address whose token transfer events you want to monitor.	0xE4a27d6b7C751b33b2f033019fDf196e8b329D7A
allowListCallers	Array of String	true	The list of addresses from which you want to receive notifications when a token transfer to the target address occurs.	\[0xcc869c4d92c19776d8998dec4688a9539d5c8ae6]

Response Example

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

📍 Type: ERC20

subscription_connected The user(8350954814192461336) is connected.
registered messageId: 123,
subscriptionId: 5091
subscription Event :  subscriptionId: 5091,
eventType: ALLOW_LIST_CALLER,
event: {
  "targetAddress": "0xdac17f958d2ee523a2206206994597c13d831ec7",
  "allowListCaller": "0xdfd5293d8e347dfe59e90efd55b2956a1343963d",
  "allowListCallers": [
    "0xdfd5293d8e347dfe59e90efd55b2956a1343963d"
  ],
  "messages": [
    {
      "block_hash": "0x72ead2932d1adcaa2d8194bbbccc94704a3c9d343f34cbd4c610ce9dcbd7efe9",
      "block_number": 21570639,
      "block_timestamp": 1736229335,
      "from_address": "0xdfd5293d8e347dfe59e90efd55b2956a1343963d",
      "gas": 220436,
      "gas_price": 6681013225,
      "hash": "0x3dd3d4e3fbf848e686342a157d8e986dcd9b8eee598010e9ae9ea16091fbc15b",
      "input": "0xa9059cbb000000000000000000000000ac362803d14edd890a352e27a64e435c1e2934fa0000000000000000000000000000000000000000000000000000000f24638674",
      "max_fee_per_gas": 102000000000,
      "max_priority_fee_per_gas": 2000000000,
      "nonce": 10542440,
      "to_address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
      "transaction_index": 68,
      "transaction_type": 2,
      "value": "0",
      "access_list": [],
      "receipt_contract_address": null,
      "receipt_cumulative_gas_used": 9340339,
      "receipt_effective_gas_price": 6681013225,
      "receipt_gas_used": 46121,
      "receipt_root": null,
      "receipt_status": 1,
      "type": "transaction"
    }
  ]
}

📍 Type: ERC721

subscription_connected The user(8350954814192461336) is connected.
registered messageId: 123,
subscriptionId: 5091
subscription Event :  subscriptionId: 5091,
eventType: ALLOW_LIST_CALLER,
event: {
  "targetAddress": "0xBd3531dA5CF5857e7CfAA92426877b022e612cf8",
  "allowListCaller": "0xdfd5293d8e347dfe59e90efd55b2956a1343963d",
  "allowListCallers": [
    "0xdfd5293d8e347dfe59e90efd55b2956a1343963d"
  ],
  "messages": [
    {
      "block_hash": "0xeab8a4f8ecc6335e5859182e022ac96909ee01e9831664799bc9c42cea8731d0",
      "block_number": 21570769,
      "block_timestamp": 1736229335,
      "from_address": "0xdfd5293d8e347dfe59e90efd55b2956a1343963d",
      "gas": 146458,
      "gas_price": 5296209271,
      "hash": "0x841b0e12db029caf00487ef9d77e708f8ac03f695cbee3e76739e38e3f2c70a0",
      "input": "0x23b872dd000000000000000000000000e82e5c47d1136806354b6aac5dec6c87a979694f0000000000000000000000008766d42076962de7147d4106f0769546932ad6ab000000000000000000000000000000000000000000000000000000000000089e",
      "max_fee_per_gas": 102000000000,
      "max_priority_fee_per_gas": 2000000000,
      "nonce": 10542440,
      "to_address": "0x8766d42076962De7147d4106f0769546932aD6Ab",
      "transaction_index": 68,
      "transaction_type": 2,
      "value": "0",
      "access_list": [],
      "receipt_contract_address": null,
      "receipt_cumulative_gas_used": 9340339,
      "receipt_effective_gas_price": 6681013225,
      "receipt_gas_used": 46121,
      "receipt_root": null,
      "receipt_status": 1,
      "type": "transaction"
    }
  ]
}

📍 Type: ERC1155

subscription_connected The user(8350954814192461336) is connected.
registered messageId: 123,
subscriptionId: 5091
subscription Event :  subscriptionId: 5091,
eventType: ALLOW_LIST_CALLER,
event: {
  "targetAddress": "0xD4416b13d2b3a9aBae7AcD5D6C2BbDBE25686401",
  "allowListCaller": "0xdfd5293d8e347dfe59e90efd55b2956a1343963d",
  "allowListCallers": [
    "0xdfd5293d8e347dfe59e90efd55b2956a1343963d"
  ],
  "messages": [
    {
      "block_hash": "0xee41f07a79ab5951cee5dda31d87d20937597cf8f88e76ed776dbb3387af56f6",
      "block_number": 21570688,
      "block_timestamp": 1736229335,
      "from_address": "0x74024DCa09dAc188614d837f2ad4f5463946D657",
      "gas": 300363,
      "gas_price": 5204471625,
      "hash": "0x5f4bf87277a4c451e991bff9f87347bd3b7f3495d3cef942b2636720f9c30683",
      "input": "0x74694a2b000000000000000000000000000000000000000000000000000000000000010000000000000000000000000074024dca09dac188614d837f2ad4f5463946d6570000000000000000000000000000000000000000000000000000000003c267009923eb940000000304e294da75f36f9db9435da4e16b9843d919b0160f6e2c77000000000000000000000000231b0ee14048e9dccd1d247744d114a4eb5e8e63000000000000000000000000000000000000000000000000000000000000014000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000572656e636f0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000a48b95dd717a91de101d5056fe72687ebf1511c97ac0fece32dead625a2c972bb301c3c8af000000000000000000000000000000000000000000000000000000000000003c0000000000000000000000000000000000000000000000000000000000000060000000000000000000000000000000000000000000000000000000000000001474024dca09dac188614d837f2ad4f5463946d65700000000000000000000000000000000000000000000000000000000000000000000000000000000",
      "max_fee_per_gas": 102000000000,
      "max_priority_fee_per_gas": 2000000000,
      "nonce": 10542440,
      "to_address": "0x74024DCa09dAc188614d837f2ad4f5463946D657",
      "transaction_index": 68,
      "transaction_type": 2,
      "value": "0",
      "access_list": [],
      "receipt_contract_address": null,
      "receipt_cumulative_gas_used": 9340339,
      "receipt_effective_gas_price": 6681013225,
      "receipt_gas_used": 46121,
      "receipt_root": null,
      "receipt_status": 1,
      "type": "transaction"
    }
  ]
}