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 nownftToken
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
.
Variables
{
"collectionAddress": "0xfd1ef6771604aa9ed57b8d557a7ae00f051b08fd",
"network": "BASE_MAINNET",
"tokenId": "1",
"salePrice": "10000"
}
Example Response
{
"data": {
"nftToken": {
"royaltyInfo": {
"amount": "1000",
"receiver": "0xc2a76176e1575d48354cde3ee78d0590ae48c36f"
}
}
}
}
Arguments
Argument | Description | Type | Required |
---|---|---|---|
collectionAddress | The contract address of the NFT collection | String! | Yes |
network | The blockchain network where the NFT exists | Network! | Yes |
tokenId | The unique identifier of the NFT within its collection | String! | Yes |
Fields
Field | Description | Type |
---|---|---|
id | Unique identifier for the NFT | ID! |
tokenId | Token ID within the collection | String! |
name | Name of the NFT | String! |
description | Description of the NFT | String |
supply | Total supply of this token | BigDecimal! |
circulatingSupply | Number of tokens in circulation | BigDecimal! |
holdersCount | Number of unique holders (ERC-1155) | BigDecimal! |
socialLinks | Social media links | [SocialLink!]! |
collection | Parent collection information | NftCollection! |
traits | Token traits/attributes | [NftTrait!]! |
mediasV2 | Media assets (legacy format) | [NftMediaV2!]! |
mediasV3 | Media assets (current format) | NftMedias! |
transfers | Transfer history | NftTransferConnection |
holders | Current token holders | NftHolderConnection! |
holdersFollowedByAddress | Holders followed by given address | [NftHolder!]! |
isHidden | Whether token is hidden by owner | Boolean! |
estimatedValue | Current estimated value | NftValueDenomination |
lastSale | Most recent sale details | NftValueDenomination |
rarityRank | Token rarity ranking (deprecated) | Int |
lastSaleEth | Last sale price in ETH (deprecated) | BigDecimal |
estimatedValueEth | Estimated 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