NFTS by Wallet

Provide us with a wallet address/ENS address and receive information related to that wallet. We will return metadata and transfer related information from both on-chain and off-chain data sources where available.

Query Parameters

• chain string

  filter for a particular chain

• cursor string

  cursor for pagination purposes

• limit integer

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

• includeLastTransfer boolean
• address string required

  account address/ENS address

  Example (jordanBelfort):

  0xdbf2445e5049c04cda797dae60ac885e7d79df9d

  Example (mikeShinoda):

  0xb55eb9bd32d6ab75d7555192e7a3a7ca0bcd5738

  Example (vincentVanDough):

  vvd.eth

• contractAddress string

  contractAddress to filter for, possibly comma separated

  Example (bayc):

  0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d

  Example (cryptoPunks):

  0xb47e3cd837ddf8e4c57f05d70ab865de6e193bbb

Responses

• 200

---

Schema

• data object[] required

  a list of NFTs

  • contractAddress string

    contract the NFT was deployed to. case insensitive

  • contractStandard string

    contract standard

  • tokenId string required

    the tokenId representing the NFT. The contractAddress and tokenId together uniquely identify an NFT on a chain

  • uri string

    URL of the NFT

  • metadata object

    Metadata of the NFT

    allOf

    • name string

      Name of the NFT

    • description string

      Description of the NFT

    • imageMediaType string

      Type of media that the NFT points to. Will be in MIME type. e.g. image/jpeg, image/svg. Possible types: image

    • imageUrl string

      Original image URL of the NFT

    • imageCacheUrl string

      Gomu cached version of image media at original size

    • imageCachePreviewUrl string

      Gomu cached version of image media at preview (250x250) size

    • imageCacheThumbnailUrl string

      Gomu cached version of image media at thumbnail (128x128) size

    • mediaType string

      Type of animation media that the NFT points to. Will be in MIME type. e.g. image/gif, video/mp4. Possible types: image, video, music

    • mediaUrl string

      Original animation URL of the NFT

    • traits object[]

      List of traits

      • traitType string

        key of the trait

      • traitValue object

        value of the trait

      • traitRarity number

        rarity score of the trait

      • traitFrequency number

        frequency of the trait

      • traitPercentFrequency number

        population percent frequency of the trait

  • owner string required

    on-chain onwer

  • owners object[]

    Current owners of the NFT

    • address string required

      owner address

    • amount string required

      the number of tokens owned

    • enteredAtBlock number

      block number when this owner first owns the token

    • enteredAt number

      unix epoch time when this owner first owns the token

    • updatedAtBlock number

      block number when this owner last interacts with the token

    • updatedAt number

      unix epoch time when this owner last interacts with the token

  • minter string

    Minter of the NFT; this is the minting transaction's fromAddress

  • lastTransfer object

    lastTransfer event of the NFT

    allOf

    • 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

      • 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

  • markets string[]

    A list of markets that this NFT was transferred on e.g. ['opensea','0x']

  • rarity number

    rarity score of the NFT

  • orderbook string[]

    Orderbook details

  • native
  • rank number

    rank

• nextCursor string

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