Skip to main content
Monitor ERC-721 Transfer events across multiple NFT collections to track collection activity, analyze whale movements, or build NFT analytics platforms.

​
Use Case

NFT transfer tracking enables you to:
  • Build NFT transfer trackers and analytics
  • Monitor collection activity and floor prices
  • Track whale movements across collections
  • Analyze trading patterns and market trends

​
Code Example

curl --compressed -X POST 'https://portal.sqd.dev/datasets/ethereum-mainnet/stream' \
  -H 'Content-Type: application/json' \
  -d '{
    "type": "evm",
    "fromBlock": 18000000,
    "toBlock": 18010000,
    "fields": {
      "block": {
        "number": true,
        "timestamp": true
      },
      "log": {
        "address": true,
        "topics": true,
        "transactionHash": true
      }
    },
    "logs": [{
      "address": [
        "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D",
        "0x60E4d786628Fea6478F785A6d7e704777c86a7c6",
        "0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB"
      ],
      "topic0": ["0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef"]
    }]
  }'
Try it yourself with the interactive query interface below:

​
Key Parameters

ParameterDescription
addressNFT collection contract addresses. Multiple addresses use OR logic
topic0Transfer event signature (same for ERC-721 and ERC-20)
topics[1]From address (indexed parameter)
topics[2]To address (indexed parameter)
topics[3]Token ID (indexed parameter in ERC-721)
ERC-721 Transfer events have the token ID in topics[3]. ERC-20 transfers don’t have this field (amount is in data instead).

​
Expected Output

{
  "header": {
    "number": 18000123,
    "timestamp": 1697544779
  },
  "logs": [
    {
      "address": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",
      "topics": [
        "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
        "0x000000000000000000000000a9d1e08c7793af67e9d92fe308d5697fb81d3e43",
        "0x00000000000000000000000028c6c06298d514db089934071355e5743bf21d60",
        "0x0000000000000000000000000000000000000000000000000000000000000001"
      ],
      "transactionHash": "0x123..."
    }
  ]
}

​
Track Specific Wallet Activity

Monitor NFT transfers for a specific wallet address: 
curl --compressed -X POST 'https://portal.sqd.dev/datasets/ethereum-mainnet/stream' \
  -H 'Content-Type: application/json' \
  -d '{
    "type": "evm",
    "fromBlock": 18000000,
    "toBlock": 18010000,
    "fields": {
      "log": {
        "address": true,
        "topics": true,
        "transactionHash": true
      }
    },
    "logs": [{
      "address": ["0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D"],
      "topic0": ["0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef"],
      "topic2": ["0x00000000000000000000000028c6c06298d514db089934071355e5743bf21d60"]
    }]
  }'

​
Track Minting Events

Monitor NFT mints (transfers from null address): 
const blocks = await dataSource.getBlocks({
  from: 18000000,
  to: 18010000,
  fields: {
    log: { address: true, topics: true },
  },
  logs: [
    {
      address: ["0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D"],
      topic0: ["0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef"],
      topic1: ["0x0000000000000000000000000000000000000000000000000000000000000000"], // From null
    },
  ],
});
Minting is represented as a transfer from the zero address (0x000...000).

​
ERC-1155 Transfers

For ERC-1155 NFTs, use different event signatures: 
// ERC-1155 TransferSingle event
const TRANSFER_SINGLE = "0xc3d58168c5ae7397731d063d5bbf3d657854427343f4c083240f7aacaa2d0f62";

// ERC-1155 TransferBatch event
const TRANSFER_BATCH = "0x4a39dc06d4c0dbc64b70af90fd698a233a518aa5d07e595d983b8c0526c8f7fb";

const blocks = await dataSource.getBlocks({
  from: 18000000,
  to: 18010000,
  fields: {
    log: { address: true, topics: true, data: true },
  },
  logs: [
    {
      address: ["0x..."], // ERC-1155 contract
      topic0: [TRANSFER_SINGLE, TRANSFER_BATCH],
    },
  ],
});

​
Performance Tips

  1. Filter by collection: Specify exact contract addresses
  2. Use topic filters: Filter by from/to addresses at Portal level
  3. Batch processing: Query 10k-50k blocks at a time
  4. Minimal fields: Request only needed fields

Query Event Logs

General event log querying

Index DEX Swaps

Track DEX trading activity

Query Transactions

Monitor transaction activity

API Reference

View complete API docs