Skip to main content

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

    filter for a particular chain

  • cursor string

    cursor for pagination purposes

  • limit integer

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

Responses

Schema
  • data object[] required

    a list of NFTs

    • contractAddress string

      contract the NFT was deployed to. case insensitive

    • contractStandard string

      contract standard

    • contract object
      allOf
      • chain string required

        the blockchain it is deployed to

      • address string required

        Address contract was deployed to

      • standard string required

        what standard of NFT it is; e.g. ERC721 or ERC1155

      • name string

        Name of the contract

      • symbol string

        Symbol of the contract

      • description string

        Description of the contract

      • type string

        Type of contract (e.g. non-fungible)

      • totalSupply string

        Maximum amount of supply (denominator)

      • tokensCount string

        Current amount of supply (numerator)

      • ownersCount string

        Number of owners

      • verified boolean

        Gomu verified status (aggregated)

      • discordUrl string

        URL of Discord server

      • telegramUrl string

        URL of Telegram channel

      • twitterUsername string

        Twitter username

      • instagramUsername string

        Instagram username

      • externalLink string

        The website of the contract

      • markets object[]

        Markets traded on

        • market string required

          Name of the market

        • slug string

          Opensea slug

        • name string

          Name of the contract on the market

        • profileImageUrl string

          Main profile picture URL

        • bannerImageUrl string

          Banner picture URL

        • payoutAddress string

          Payout address when interacting with Wyvern

        • oneDayStats object

          1-day change

          • volume number required

            volume in native protocol token (e.g. ETH/WETH)

          • change number required

            change in native protocol token (e.g. ETH/WETH)

          • sales number required

            sales in absolute number

          • averagePrice number required

            average price in native protocol token (e.g. ETH/WETH)

        • sevenDayStats object

          7-day change

          • volume number required

            volume in native protocol token (e.g. ETH/WETH)

          • change number required

            change in native protocol token (e.g. ETH/WETH)

          • sales number required

            sales in absolute number

          • averagePrice number required

            average price in native protocol token (e.g. ETH/WETH)

        • thirtyDayStats object

          30-day change

          • volume number required

            volume in native protocol token (e.g. ETH/WETH)

          • change number required

            change in native protocol token (e.g. ETH/WETH)

          • sales number required

            sales in absolute number

          • averagePrice number required

            average price in native protocol token (e.g. ETH/WETH)

        • totalVolume number

          Total volume in native protocol token (e.g. ETH/WETH)

        • totalSales number

          Total sales in absolute number

        • floorPrice number

          Current floor price in native protocol token (e.g. ETH/WETH)

        • averagePrice number

          Average price in native protocol token (e.g. ETH/WETH)

        • marketCap number

          Market capitalization in native protocol token (e.g. ETH/WETH)

    • 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

    • 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 object[]

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

      • market string required

        Name of the market

      • numSales number
    • numTraits number

      number of traits of the NFT

    • rarity number

      rarity score of the NFT

    • orderbook string[]

      Orderbook details

    • rollup24H object[]
      • tokenAddress string required
      • tokenName string
      • amount string required
    • rollup24HUSD number
    • native
    • rank number

      rank

  • nextCursor string

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