API Reference
Go to Nodit!

TOKEN_TRANSFER

토큰(ERC20) 전송 또는 NFT(ERC721, ERC1155) 전송이 발생할 경우 알림을 제공합니다. 사용자는 특정 컨트랙트 주소를 지정하여 해당 컨트랙트에서 발생하는 토큰 이동을 모니터링할 수 있습니다. 또한, ERC721과 ERC1155 표준에 따른 NFT의 경우, 특정 토큰 ID를 조건으로 설정하여 해당 ID의 토큰 전송만을 추적하는 것이 가능합니다.

Supported Network

NetworkSupporting
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값을 TOKEN_TRANSFER 로 설정하는 경우, 사용 가능한 condition 객체 필드는 아래와 같습니다.

KeyTypeRequiredDescriptionExample Value
tokensArray of objecttrue전송 이벤트를 모니터링 하고자 하는 토큰 정보 객체
tokens[i].contractAddressStringtrue모니터링 하고자 하는 ERC20 또는 ERC721, ERC1155 토큰의 컨트랙트 주소["0xdac17f958d2ee523a2206206994597c13d831ec7",
"0x57f1887a8BF19b14fC0dF6Fd9B2acc9Af147eA85",
"0xD4416b13d2b3a9aBae7AcD5D6C2BbDBE25686401"]
tokens[i].tokenIdStringfalse해당 ERC721 또는 ERC1155 컨트랙트의 특정 토큰에 대한 전송 이벤트만 모니터링 하고자 하는 경우, 토큰 ID"100"

Response Example

🚧

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

📍 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"
    }
  ]
}