Transfers by Block

Provide us with startBlockNumber and stopBlockNumber and we will return the NFT transfers that have taken place in those blocks. If no block numbers are supplied, it returns the transfers in the lastest block that we have processed.

Query Parameters

• startBlockNumber integer

  starting block number

• stopBlockNumber integer

  ending block number

• chain string

  filter for a particular chain

• cursor string

  cursor for pagination purposes

• limit integer

  number of items to return, maximum 30, default 30.

Responses

• 200

---

Schema

• data object[] required

  list of Transfers

  • contractAddress string

    contract address of an NFT contract deployed e.g. 0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d for Bored Ape Yacht Club (BAYC)

  • tokenId string required

    tokenId of a specific NFT

  • chain string required

    identifier of chain indexed. e.g. 'ethereum' for mainnet

  • blockNumber integer required

    blockNumber of the transfer

  • transactionHash string required

    transactionHash of the transfer

  • fromAddress string

    previous owner address of the NFT in this transaction

  • toAddress string

    current owner address of the NFT in this transaction

  • value string

    native-token value of the transaction if any (e.g. on mainnet, Ethereum, denoted in wei). in the case of a batch transfer, they will share the same value

  • nftValue object

    inferred value for transferred NFT in token amount

    allOf

    • tokenAddress string required
    • tokenName string
    • amount string required
  • swaps object[] required

    A P2P transaction or we are not able to infer the NFT value

    • contractAddress string required
    • tokenId string
    • fromAddress string required
    • toAddress string required
    • amount string required
    • market string
  • usdValue number

    USD value from inferred NFT value

  • ethValue number

    ETH value from inferred NFT value

  • isCommercial boolean

    whether the transfer happens on commercial markets

  • amount string required

    amount of the token. Relevant for ERC1155 which may have a non-1 amount of tokens

  • timestamp integer required

    unix timestamp in seconds

  • markets string[] required

    classified markets for the transaction (e.g. opensea if it interacts with opensea)

  • native
  • transferType string

    transferType: can be [mint, transfer, sale, swap, burn]

  • imageCacheUrl string

    imageUrl of the token

• nextCursor string

  pass into cursor variable to return next-page of responses, if any