Transfers by Market

Provide us a market and we will return all known NFT transfers related to that market.

Query Parameters

• market string required

  filter by a particular market e.g. opensea, looksrare, rarible, cryptopunks, gemswap, genieswap, x2y2 etc.

• 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