TOKEN_TRANSFER

---

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 TOKEN_TRANSFER, the available condition object fields are listed below.

Key	Type	Required	Description	Example Value
tokens	Array of object	true	Token information objects for which you want to monitor transfer events.
tokens[i].contractAddress	String	true	Contract address of the ERC20, ERC721, or ERC1155 token to monitor.	["0xdac17f958d2ee523a2206206994597c13d831ec7", "0x57f1887a8BF19b14fC0dF6Fd9B2acc9Af147eA85", "0xD4416b13d2b3a9aBae7AcD5D6C2BbDBE25686401"]
tokens[i].tokenId	String	false	Token ID to use when monitoring transfer events for a specific token within an ERC721 or ERC1155 contract.	"100"

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: 5084
subscription Event :  subscriptionId: 5084,
eventType: TOKEN_TRANSFER,
event: {
  "targetAddress": "0xdac17f958d2ee523a2206206994597c13d831ec7", , // ⚠️ This field will be deprecated soon
  "targetAddresses": [
    "0xdac17f958d2ee523a2206206994597c13d831ec7"
  ],
  "messages": [
    {
      "token_address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
      "from_address": "0x875a01980d993e7dca8f149205c9d8d0f7799af4",
      "to_address": "0x77edae6a5f332605720688c7fda7476476e8f83f",
      "value": "300000000",
      "transaction_hash": "0x7788a25f8dbb20837e55bbddabd7c40fa9b03a657c06e2dfba83f3b64536dfa4",
      "log_index": 23,
      "block_number": 21570538,
      "block_timestamp": 1736228123,
      "type": "erc20"
    }
  ]
}

📍 Type: ERC721

subscription_connected The user(8350954814192461336) is connected.
registered messageId: 123,
subscriptionId: 5084
subscription Event :  subscriptionId: 5084,
eventType: TOKEN_TRANSFER,
event: {
  "targetAddress": "0xbd3531da5cf5857e7cfaa92426877b022e612cf8", , // ⚠️ This field will be deprecated soon
  "targetAddresses": [
    "0xbd3531da5cf5857e7cfaa92426877b022e612cf8"
  ],
  "messages": [
    {
      "block_number": 21570577,
      "block_timestamp": 1736228591,
      "from_address": "0x7ff9ff105574a25b88c2a57ca0303f5aea55e98d",
      "log_index": 221,
      "to_address": "0xd6c701b895d2b93f34f1e365c30314590c02b2b3",
      "token_address": "0xbd3531da5cf5857e7cfaa92426877b022e612cf8",
      "token_id": "2633",
      "transaction_hash": "0x8877c7311cba7965169bb5a1003897028cfe3ebfc4777575a5221989bd13d445",
      "type": "erc721"
    }
  ]
}

📍 Type: ERC1155

subscription_connected The user(8350954814192461336) is connected.
registered messageId: 123,
subscriptionId: 5084
subscription Event :  subscriptionId: 5084,
eventType: TOKEN_TRANSFER,
event: {
  "targetAddress": "0xd4416b13d2b3a9abae7acd5d6c2bbdbe25686401", , // ⚠️ This field will be deprecated soon
  "targetAddresses": [
    "0xd4416b13d2b3a9abae7acd5d6c2bbdbe25686401"
  ],
  "messages": [
    {
      "token_address": "0xd4416b13d2b3a9abae7acd5d6c2bbdbe25686401",
      "from_address": "0x0000000000000000000000000000000000000000",
      "to_address": "0x7628008ec0cffc49663e99b3b81026a31a4e56fc",
      "value": "1",
      "token_id": "96043770593759298319042380490414687847756372775697807151726318973060518522837",
      "operator": "0x253553366da8546fc250f225fe3d25d0c782303b",
      "transaction_hash": "0x9bc868ca5bf0b85cdd2e868544000e4e61f0f33d41225324c6f2fdb1432e22da",
      "log_index": 322,
      "batch_index": 0,
      "block_number": 21570567,
      "block_timestamp": 1736228471,
      "type": "erc1155"
    }
  ]
}