Skip to main content

NFTS by Token

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

Query Parameters
  • contractAddress string

    contractAddress/ENS address to query

    Example (bayc):
    0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d
    Example (cryptoPunks):
    0xb47e3cd837ddf8e4c57f05d70ab865de6e193bbb
  • tokenId string[]

    tokenId to filter for (mint to filter for solana). Can be multiple tokens, comma separated (max 100). If this field is defined but empty, an empty result will be returned

  • traits string[]

    traits to filter for, format: type-value. Can be multiple tokens, comma separated (max 100). If this field is defined but empty, an empty result will be returned

  • chain string

    filter for a particular chain

  • cursor string

    cursor for pagination purposes

  • limit integer

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

  • sortBy string

    sort order: [<blank>|lowestAsk|highestAsk|tokenId[-asc|-desc]|rarity]. blank is most recent transaction first, lowestAsk is lowest ask first, highestAsk is ascending order of the highest ask by token. tokenId[-asc|-desc] is by tokenId ascending or descending. rarity is by rarity descending. If sortBy is either lowestAsk or highestAsk, pagination is only supported up to 10,000 items. Items with no asks will be sorted behind all items with asks

  • priceFilter string

    Filter items returned by lowest ask. Use comma separated values of the form <currency>,<min>,<max>. Not case-sensitive. Must always have 2 commas

    Example (both):
    ETH,10,15
    Example (minOnly):
    ETH,5,
    Example (maxOnly):
    DAI,,20
  • marketplaces string[]

    marketplaces to filter for. Can be multiple marketplaces, comma separated, non-case-sensitive. If this field is defined but empty, an empty result will be returned

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