Skip to main content

Single NFT Details

Surfaces details about a single NFT with its metadata including the collection it belongs to, token ID, traits, name, description, media (images/animations/audio), holders, transfers, and estimated value information.

Try it now

nftToken

Takes collectionAddress, network, and tokenId as input. Returns detailed data about a specific NFT including:

  • Token metadata
  • Current ownership
  • Transfer history
  • Traits and rarity
  • Media assets

Example Use Case: NFT Display

Let's say you want to display a specific NFT. Start by passing the collectionAddress, network, and tokenId to identify the NFT. Then return information about the token including its name, description, current estimatedValue, and media assets from mediasV3. You can also get trait information and current sale data.

Example Variables

{
"collectionAddress": "0xb47e3cd837ddf8e4c57f05d70ab865de6e193bbb",
"network": "ETHEREUM_MAINNET",
"tokenId": "7495"
}

Example Query

query NftTokenDetails($collectionAddress: String!, $network: Network!, $tokenId: String!) {
nftToken(collectionAddress: $collectionAddress, network: $network, tokenId: $tokenId) {
# Basic token information
id
name
description
tokenId

# Collection information
collection {
name
symbol
address
network
description
nftStandard
supply
circulatingSupply
holdersCount
socialLinks {
name
url
}
# Pricing data
floorPrice {
valueUsd
valueWithDenomination
denomination {
network
symbol
address
}
}
# Collection media assets
medias {
logo {
thumbnail
original
blurhash
}
banner {
original
blurhash
thumbnail
medium
large
width
height
mimeType
}
}
}
# Token media assets
mediasV3 {
images(first: 5) {
edges {
node {
original
thumbnail
medium
large
mimeType
width
height
blurhash
fileSize
}
}
pageInfo {
hasNextPage
endCursor
}
}
animations(first: 1) {
edges {
node {
original
mimeType
fileSize
url
}
}
pageInfo {
hasNextPage
endCursor
}
}
audios(first: 1) {
edges {
node {
original
mimeType
fileSize
}
}
pageInfo {
hasNextPage
endCursor
}
}
}

# Trait/attribute information
traits {
attributeName
attributeValue
supply
supplyPercentage
estimatedValueEth
}

# Ownership information
holdersCount
holders(first: 1) {
totalCount
edges {
node {
holdCount
holdTotalCount
account {
address
displayName {
value
source
}
farcasterProfile {
fid
username
metadata {
imageUrl
}
}
}
}
}
}

# Value and pricing information
estimatedValue {
valueUsd
valueWithDenomination
denomination {
network
address
symbol
}
}
lastSale {
valueUsd
valueWithDenomination
denomination {
network
address
symbol
}
}

# Transaction history
transfers(first: 3, order: { orderBy: TIMESTAMP, orderDirection: DESC }) {
edges {
node {
timestamp
txHash
payments {
tokenValueUSD
tokenValueETH
tokenSymbol
tokenValue
}
}
heldForInSeconds
}
}
}
}

Example Response

{
"data": {
"nftToken": {
"id": "TmZ0VG9rZW5FcmM3MjEtNzE5MTU1NDg=",
"name": "CryptoPunk #7495",
"description": null,
"tokenId": "7495",
"collection": {
"name": "CryptoPunks",
"symbol": "PUNK",
"address": "0xb47e3cd837ddf8e4c57f05d70ab865de6e193bbb",
"network": "ETHEREUM_MAINNET",
"description": "CryptoPunks launched as a fixed set of 10,000 items in mid-2017 and became one of the inspirations for the ERC-721 standard. They have been featured in places like The New York Times, Christie’s of London, Art|Basel Miami, and The PBS NewsHour.",
"nftStandard": "ERC_721",
"supply": "10000",
"circulatingSupply": "9998",
"holdersCount": "3905",
"socialLinks": [
{
"name": "opensea",
"url": "https://opensea.io/collection/cryptopunks"
},
{
"name": "website",
"url": "https://cryptopunks.app/"
},
{
"name": "discord",
"url": "https://discord.gg/tQp4pSE"
},
{
"name": "twitter",
"url": "https://twitter.com/cryptopunksnfts"
}
],
"floorPrice": {
"valueUsd": 71213.91788318769,
"valueWithDenomination": 37.9849,
"denomination": {
"network": "ethereum",
"symbol": "ETH",
"address": "0x0000000000000000000000000000000000000000"
}
},
"medias": {
"logo": {
"thumbnail": "https://zapper.xyz/z/images/?url=https%3A%2F%2Fstorage.googleapis.com%2Fzapper-fi-assets%2Fnfts%2Fcollections%2Fethereum%2F0xb47e3cd837ddf8e4c57f05d70ab865de6e193bbb%2Flogo.png&width=100&checksum=d654e",
"original": "https://zapper.xyz/z/images/?url=https%3A%2F%2Fstorage.googleapis.com%2Fzapper-fi-assets%2Fnfts%2Fcollections%2Fethereum%2F0xb47e3cd837ddf8e4c57f05d70ab865de6e193bbb%2Flogo.png&checksum=cf0e4",
"blurhash": "UGCZ|rt7GwXnpJbIjDn$X:j[rWbHg3bHoJn$"
},
"banner": {
"original": "https://zapper.xyz/z/images/?url=https%3A%2F%2Fstorage.googleapis.com%2Fzapper-fi-assets%2Fnfts%2Fcollections%2Fethereum%2F0xb47e3cd837ddf8e4c57f05d70ab865de6e193bbb%2Fbanner.png&checksum=0fade",
"blurhash": "U6CHE4%Nu4D-=tDOk7%%Y7NGngx]Tz.8ohD$",
"thumbnail": "https://zapper.xyz/z/images/?url=https%3A%2F%2Fstorage.googleapis.com%2Fzapper-fi-assets%2Fnfts%2Fcollections%2Fethereum%2F0xb47e3cd837ddf8e4c57f05d70ab865de6e193bbb%2Fbanner.png&width=100&checksum=62633",
"medium": "https://zapper.xyz/z/images/?url=https%3A%2F%2Fstorage.googleapis.com%2Fzapper-fi-assets%2Fnfts%2Fcollections%2Fethereum%2F0xb47e3cd837ddf8e4c57f05d70ab865de6e193bbb%2Fbanner.png&width=250&checksum=e481f",
"large": "https://zapper.xyz/z/images/?url=https%3A%2F%2Fstorage.googleapis.com%2Fzapper-fi-assets%2Fnfts%2Fcollections%2Fethereum%2F0xb47e3cd837ddf8e4c57f05d70ab865de6e193bbb%2Fbanner.png&width=500&checksum=3b086",
"width": 1400,
"height": 400,
"mimeType": "image/png"
}
}
},
"mediasV3": {
"images": {
"edges": [
{
"node": {
"original": "https://zapper.xyz/z/images/?url=https%3A%2F%2Fstorage.googleapis.com%2Fzapper-fi-assets%2Fnfts%2Fmedias%2F00f8b24c79685e376e42fa775bfeab0eb3fc55e09e77be0ee31c43193e81c71e.png&checksum=e9d0c",
"thumbnail": "https://zapper.xyz/z/images/?url=https%3A%2F%2Fstorage.googleapis.com%2Fzapper-fi-assets%2Fnfts%2Fmedias%2F00f8b24c79685e376e42fa775bfeab0eb3fc55e09e77be0ee31c43193e81c71e.png&width=100&checksum=173cf",
"medium": "https://zapper.xyz/z/images/?url=https%3A%2F%2Fstorage.googleapis.com%2Fzapper-fi-assets%2Fnfts%2Fmedias%2F00f8b24c79685e376e42fa775bfeab0eb3fc55e09e77be0ee31c43193e81c71e.png&width=250&checksum=b1c6e",
"large": "https://zapper.xyz/z/images/?url=https%3A%2F%2Fstorage.googleapis.com%2Fzapper-fi-assets%2Fnfts%2Fmedias%2F00f8b24c79685e376e42fa775bfeab0eb3fc55e09e77be0ee31c43193e81c71e.png&width=500&checksum=eecbe",
"mimeType": "image/png",
"width": 312,
"height": 312,
"blurhash": "UIBX7sjFpytmu5kDZ~aKXokCivaxt7f6WAj[",
"fileSize": 2825
}
}
],
"pageInfo": {
"hasNextPage": false,
"endCursor": "MA=="
}
},
"animations": {
"edges": [],
"pageInfo": {
"hasNextPage": false,
"endCursor": null
}
},
"audios": {
"edges": [],
"pageInfo": {
"hasNextPage": false,
"endCursor": null
}
}
},
"traits": [
{
"attributeName": "accessory",
"attributeValue": "Straight Hair",
"supply": "151",
"supplyPercentage": 1.51,
"estimatedValueEth": "32.61979777415307"
},
{
"attributeName": "type",
"attributeValue": "Female",
"supply": "3839",
"supplyPercentage": 38.39,
"estimatedValueEth": "28.370084838104244"
},
{
"attributeName": "accessory",
"attributeValue": "Purple Lipstick",
"supply": "655",
"supplyPercentage": 6.55,
"estimatedValueEth": "37.522065602107126"
},
{
"attributeName": "accessory",
"attributeValue": "Cigarette",
"supply": "961",
"supplyPercentage": 9.61,
"estimatedValueEth": "31.894761925920264"
}
],
"holdersCount": "1",
"holders": {
"totalCount": 1,
"edges": [
{
"node": {
"holdCount": "1",
"holdTotalCount": "1",
"account": {
"address": "0xdfa7777507f7ba68aa42192d714f747f77c07f97",
"displayName": {
"value": "0xdfa7...7f97",
"source": "ADDRESS"
},
"farcasterProfile": null
}
}
}
]
},
"estimatedValue": {
"valueUsd": 70346.69492361581,
"valueWithDenomination": 37.522330626256576,
"denomination": {
"network": "ethereum",
"address": "0x0000000000000000000000000000000000000000",
"symbol": "ETH"
}
},
"lastSale": {
"valueUsd": 110612.93185208,
"valueWithDenomination": 59,
"denomination": {
"network": "ethereum",
"address": "0x0000000000000000000000000000000000000000",
"symbol": "ETH"
}
},
"transfers": {
"edges": [
{
"node": {
"timestamp": 1705709819,
"txHash": "0x67fb91827d8e5cb71ffc0dc3c8744aed902ee6e0339085c4dda9ca63db89ec0a",
"payments": [
{
"tokenValueUSD": "145559.12",
"tokenValueETH": "59",
"tokenSymbol": null,
"tokenValue": "59"
}
]
},
"heldForInSeconds": 35930459
},
{
"node": {
"timestamp": 1666942439,
"txHash": "0x9bc238c2ca93c8767773b10efcbc4ae7e332fd041e2f94e7f419029c42117198",
"payments": [
{
"tokenValueUSD": "98424.92",
"tokenValueETH": "64.74",
"tokenSymbol": null,
"tokenValue": "64.74"
}
]
},
"heldForInSeconds": 38767380
},
{
"node": {
"timestamp": 1666707455,
"txHash": "0xacb37103082c9a9851dfa712040a459599930887475f004d0b5fc117d157386a",
"payments": [
{
"tokenValueUSD": "84304.01",
"tokenValueETH": "62.69",
"tokenSymbol": null,
"tokenValue": "62.69"
}
]
},
"heldForInSeconds": 234984
}
]
}
}
}
}

Example Use Case: Royalty Details

When available, the API returns royalty data according to ERC-2981. This allows you to find the royalty receipient as well as the amount earned for a given salePrice.

Try it now

Variables

{
"collectionAddress": "0xfd1ef6771604aa9ed57b8d557a7ae00f051b08fd",
"network": "BASE_MAINNET",
"tokenId": "1",
"salePrice": "10000"
}

Example Response

{
"data": {
"nftToken": {
"royaltyInfo": {
"amount": "1000",
"receiver": "0xc2a76176e1575d48354cde3ee78d0590ae48c36f"
}
}
}
}

Arguments

ArgumentDescriptionTypeRequired
collectionAddressThe contract address of the NFT collectionString!Yes
networkThe blockchain network where the NFT existsNetwork!Yes
tokenIdThe unique identifier of the NFT within its collectionString!Yes

Fields

FieldDescriptionType
idUnique identifier for the NFTID!
tokenIdToken ID within the collectionString!
nameName of the NFTString!
descriptionDescription of the NFTString
supplyTotal supply of this tokenBigDecimal!
circulatingSupplyNumber of tokens in circulationBigDecimal!
holdersCountNumber of unique holders (ERC-1155)BigDecimal!
socialLinksSocial media links[SocialLink!]!
collectionParent collection informationNftCollection!
traitsToken traits/attributes[NftTrait!]!
mediasV2Media assets (legacy format)[NftMediaV2!]!
mediasV3Media assets (current format)NftMedias!
transfersTransfer historyNftTransferConnection
holdersCurrent token holdersNftHolderConnection!
holdersFollowedByAddressHolders followed by given address[NftHolder!]!
isHiddenWhether token is hidden by ownerBoolean!
estimatedValueCurrent estimated valueNftValueDenomination
lastSaleMost recent sale detailsNftValueDenomination
rarityRankToken rarity ranking (deprecated)Int
lastSaleEthLast sale price in ETH (deprecated)BigDecimal
estimatedValueEthEstimated value in ETH (deprecated)BigDecimal

Enums

enum NftTransferSort {
TIMESTAMP
}

enum OrderDirectionOption {
DESC
ASC
}

Notes

  • Returns comprehensive NFT metadata
  • Includes current value estimates and last sale data
  • Provides access to high-quality media assets
  • Shows detailed trait information
  • Includes ownership and transfer history
  • Supports both ERC721 and ERC1155 standards