Skip to main content

Transfers by Wallet​

Provide us with a wallet address/ENS address and we will return all known NFT transfers related to that wallet.

Query Parameters
  • address string required

    account address/ENS address (typically an owner) that we want to query

    Example (jordanBelfort):
    0xdbf2445e5049c04cda797dae60ac885e7d79df9d
    Example (mikeShinoda):
    0xb55eb9bd32d6ab75d7555192e7a3a7ca0bcd5738
  • contractAddress string

    contract the NFT was deployed to. case insensitive

    Example (bayc):
    0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d
    Example (cryptoPunks):
    0xb47e3cd837ddf8e4c57f05d70ab865de6e193bbb
  • market string

    filter by a particular market e.g. 'opensea'

  • 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
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