Skip to main content

Transfers by Timestamp

Provide us with startTimestamp and stopTimestamp and we will return the NFT transfers that have taken place between those timestamps. If no timestamps are supplied, it returns the transfers in the lastest block that we have processed.

Query Parameters
  • startTimestamp integer

    starting unix timestamp in seconds

  • stopTimestamp integer

    ending unix timestamp in seconds

  • 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