Skip to main content

TOKEN_TRANSFER

Supported Network​

Network

Supporting

Ethereum Mainnet

✅

Ethereum Testnet (sepolia)

✅

Ethereum Testnet (holesky)

✅

Base Mainnet

✅

Base Testnet(sepolia)

✅

Polygon Mainnet

✅

Polygon Testnet (amoy)

✅

Arbitrum Mainnet

✅

Arbitrum Testnet (sepolia)

✅

Optimism Mainnet

✅

Optimism Testnet (sepolia)

✅

Kaia Mainnet

✅

Kaia Testnet (kairos)

✅

Aptos Mainnet

❌

Aptos Testnet

❌



Webhook Creation Request Example​

When eventType is set to TOKEN_TRANSFER, the available condition object fields are as follows.

Key

Type

Required

Description

Example Value

tokens

Array of object

true

Objects describing the tokens whose transfer events you want to monitor

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 when you want to monitor only transfers of a specific token for that ERC721 or ERC1155 contract

"100"



Request Example​

curl --location 'https://web3.nodit.io/v1/ethereum/mainnet/webhooks' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: ••••••' \
--data '{
  "eventType": "TOKEN_TRANSFER",
  "description": "{WEBHOOK_DESCRIPTION}",
  "notification": {
    "webhookUrl": "{WEBHOOK_LISTENER_ENDPOINT}"
  },
  "isInstant": false,
  "condition": {
    "tokens": [
        { "contractAddress": "0xdAC17F958D2ee523a2206206994597C13D831ec7"},
        { "contractAddress": "0x57f1887a8BF19b14fC0dF6Fd9B2acc9Af147eA85"},
        { "contractAddress": "0xD4416b13d2b3a9aBae7AcD5D6C2BbDBE25686401"}
    ]
  }
}'

Response Example​

Response fields may vary depending on the event type.

📍 Type: ERC20​

{
  "subscriptionId": "4975",
  "sequenceNumber": "2",
  "description": "{WEBHOOK_DESCRIPTION}",
  "protocol": "ethereum",
  "network": "mainnet",
  "subscriptionType": "WEBHOOK",
  "notification": {
    "webhookUrl": "{WEBHOOK_LISTENER_ENDPOINT}"
  },
  "eventType": "TOKEN_TRANSFER",
  "event": {
    "targetAddress": "0xdac17f958d2ee523a2206206994597c13d831ec7", // ⚠️ This field will be deprecated soon
    "targetAddresses": [
			"0xdac17f958d2ee523a2206206994597c13d831ec7",
			"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"
		],
    "messages": [
      {
        "token_address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
        "from_address": "0xfaa815b53a138ed4f08bf87c2be5f52dc2e6ab23",
        "to_address": "0x4924dd05fcfb613ff260da6f24352860764e7255",
        "value": "107606900",
        "transaction_hash": "0x2566c14ec70760df6c0ace8e2deee24ab0bb972d72838910a036274e464ebead",
        "log_index": 4,
        "block_number": 21492237,
        "block_timestamp": 1735283663,
        "type": "erc20"
      },

📍 Type: ERC721​

{
  "subscriptionId": "4975",
  "sequenceNumber": "2",
  "description": "{WEBHOOK_DESCRIPTION}",
  "protocol": "ethereum",
  "network": "mainnet",
  "subscriptionType": "WEBHOOK",
  "notification": {
    "webhookUrl": "{WEBHOOK_LISTENER_ENDPOINT}"
  },
  "eventType": "TOKEN_TRANSFER",
  "event": {
    "targetAddress": "0x57f1887a8BF19b14fC0dF6Fd9B2acc9Af147eA85", // ⚠️ This field will be deprecated soon
    "targetAddresses": [
			"0x57f1887a8BF19b14fC0dF6Fd9B2acc9Af147eA85",
			"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"
		],
    "messages": [
      {
        "token_address": "0x57f1887a8bf19b14fc0df6fd9b2acc9af147ea85",
        "from_address": "0x0000000000000000000000000000000000000000",
        "to_address": "0xd4416b13d2b3a9abae7acd5d6c2bbdbe25686401",
        "token_id": "95197913785858091751534103000665038599586647876989060841354808045194649190236",
        "transaction_hash": "0xe3f0dddc2a70c4be9dddeb6a1f38cee8e8ed597ee8338f14b054acc06c817432",
        "log_index": 61,
        "block_number": 21492236,
        "block_timestamp": 1735283651,
        "type": "erc721"
      }
    ]
  },
  "createdAt": "2024-12-27T07:16:06.778Z"
}

📍 Type: ERC1155​

{
  "subscriptionId": "4975",
  "sequenceNumber": "2",
  "description": "{WEBHOOK_DESCRIPTION}",
  "protocol": "ethereum",
  "network": "mainnet",
  "subscriptionType": "WEBHOOK",
  "notification": {
    "webhookUrl": "{WEBHOOK_LISTENER_ENDPOINT}"
  },
  "eventType": "TOKEN_TRANSFER",
  "event": {
    "targetAddress": "0xd4416b13d2b3a9abae7acd5d6c2bbdbe25686401", // ⚠️ This field will be deprecated soon
    "targetAddresses": [
			"0xd4416b13d2b3a9abae7acd5d6c2bbdbe25686401",
			"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"
		],
    "messages": [
      {
        "batch_index": 0,
        "block_number": 21492235,
        "block_timestamp": 1735283639,
        "from_address": "0x0000000000000000000000000000000000000000",
        "log_index": 420,
        "operator": "0x253553366da8546fc250f225fe3d25d0c782303b",
        "to_address": "0x52c36a6ea28ff827b6e66bdcc4c8649ab0fe4bfe",
        "token_address": "0xd4416b13d2b3a9abae7acd5d6c2bbdbe25686401",
        "token_id": "115634552403929373829103474254372791928891252898198171937249544067046190758705",
        "transaction_hash": "0xdcf22bdb9ff4b47a6067bde64329417b95c13799443c12654762d053c9a90c3a",
        "value": "1",
        "type": "erc1155"
      }
    ]
  },
  "createdAt": "2024-12-27T07:15:40.958Z"
}