NFT Token Transfers API: ERC-721 and ERC-1155 Transfers on Ethereum

NFT transfers on Ethereum live in the same Transfers cube as token transfers, marked by Currency.Fungible: false and carrying the token Id, the collection contract, sender, receiver and, for ERC-1155, the amount. That means one cube answers the collection question, the wallet question and the mint question, and the same filter runs as a query over history or as a live subscription. Every example runs in the IDE on a free account. The worked collection is CryptoKitties, 0x06012c8cf97bead5deae237070f9587f8e7a266d, which still changes hands a few times a day, nine years after launch. For collection-level views such as token lists and holders see the NFT collection API.

Latest transfers of one collection

The combined dataset reaches history, so this works for a collection whether it moved a minute ago or a year ago. Saved query here.

{
  EVM(dataset: combined, network: eth) {
    Transfers(
      where: {
        Transfer: {
          Currency: { SmartContract: { is: "0x06012c8cf97bead5deae237070f9587f8e7a266d" } }
        }
      }
      limit: { count: 20 }
      orderBy: { descending: Block_Time }
    ) {
      Block {
        Time
        Number
      }
      Transfer {
        Id
        Sender
        Receiver
        Currency {
          Name
          Symbol
          SmartContract
        }
      }
      Transaction {
        Hash
      }
    }
  }
}

Every NFT transfer on Ethereum, live

Drop the contract and keep Fungible: false to stream all ERC-721 and ERC-1155 transfers as blocks are indexed. Saved stream here.

subscription {
  EVM(network: eth) {
    Transfers(where: { Transfer: { Currency: { Fungible: false } } }) {
      Block {
        Time
      }
      Transfer {
        Id
        Amount
        Sender
        Receiver
        Currency {
          Name
          Symbol
          SmartContract
        }
      }
      Transaction {
        Hash
      }
    }
  }
}

Add the collection contract back into the filter to stream one collection; a quiet collection can then go hours between messages, so check it with the query above first.

One wallet's NFT activity

An any block matches transfers where the wallet is the sender or the receiver. The example is a large BAYC holder.

{
  EVM(dataset: combined, network: eth) {
    Transfers(
      where: {
        Transfer: { Currency: { Fungible: false } }
        any: [
          { Transfer: { Sender: { is: "0x29469395eaf6f95920e59f858042f0e28d98a20b" } } }
          { Transfer: { Receiver: { is: "0x29469395eaf6f95920e59f858042f0e28d98a20b" } } }
        ]
      }
      limit: { count: 20 }
      orderBy: { descending: Block_Time }
    ) {
      Block {
        Time
      }
      Transfer {
        Id
        Sender
        Receiver
        Currency {
          Name
          SmartContract
        }
      }
      Transaction {
        Hash
      }
    }
  }
}

Mints

A mint is a transfer from the zero address; the receiver is the minter. For CryptoKitties a mint is a kitty being born.

{
  EVM(dataset: combined, network: eth) {
    Transfers(
      where: {
        Transfer: {
          Currency: { SmartContract: { is: "0x06012c8cf97bead5deae237070f9587f8e7a266d" } }
          Sender: { is: "0x0000000000000000000000000000000000000000" }
        }
      }
      limit: { count: 20 }
      orderBy: { descending: Block_Time }
    ) {
      Block {
        Time
      }
      Transfer {
        Id
        Receiver
      }
      Transaction {
        Hash
      }
    }
  }
}

Fields worth knowing

• Transfer.Id is the token id; Transfer.Amount is 1 for ERC-721 and the quantity for ERC-1155.
• Transfer.URI is the metadata link when the contract exposes one; fetch it yourself for the image and attributes.
• Currency.Fungible is the ERC-721/1155 flag; Currency.HasURI says whether a URI exists.
• dataset: combined on the EVM root joins archive and realtime; without it a query reads the realtime window only.

Frequently Asked Questions

How do I get NFT transfers on Ethereum?

Query Transfers on EVM(network: eth) with Currency.Fungible false, plus the collection contract, a wallet or the zero address as sender for mints. Use dataset combined for history or a subscription for a live feed.

Does the same query cover ERC-1155?

Yes. ERC-1155 transfers are rows in the same cube with the token Id and the Amount moved; ERC-721 rows carry an Amount of 1.

How do I stream every NFT transfer on Ethereum?

Subscribe to Transfers with Currency.Fungible false and no other filter. Each message is a transfer as its block is indexed.

How do I see a wallet's NFT history?

Use an any block with the wallet as Sender in one branch and Receiver in the other, together with Currency.Fungible false, on the combined dataset.

How do I find who minted an NFT?

Filter the collection contract with Sender set to the zero address; the Receiver of that transfer is the minter and the transaction hash leads to the mint call.

Related pages

• Ethereum NFT collection API
• Ethereum NFT API
• Ethereum token transfers API
• Transfers cube