Check ownership in NFT collection for specific token

Commonly used to verify ownership of a specific token (ERC-721 or ERC-1155) within a collection.

^{Credit Cost: 1 per call.
Processing: Batch}

Related guides

How Token Gating and Membership dApps Use the GoldRush API

How to Block NFT Spam

How to Verify NFT Ownership in a Collection

How to Create an NFT Allowlist (AKA Whitelist)

Path Parameters

chainName

string

required

The chain name eg: eth-mainnet.

walletAddress

string

required

The requested address. Passing in an ENS, RNS, Lens Handle, or an Unstoppable Domain resolves automatically.

collectionContract

string

required

The requested collection address. Passing in an ENS, RNS, Lens Handle, or an Unstoppable Domain resolves automatically.

tokenId

string

required

The requested token ID.

Response

200 - application/json

address

string

The requested address.

collection

string

The requested collection.

is_spam

boolean

Denotes whether the token is suspected spam. Supports eth-mainnet and matic-mainnet.

items

object[]

List of response items.

Show child attributes

items.balance

string

b;Nft balance.

items.balance24h

string

items.contract_address

string

Use the relevant contract_address to lookup prices, logos, token transfers, etc.

items.contract_name

string

The string returned by the name() method.

items.contract_ticker_symbol

string

The ticker symbol for this contract. This field is set by a developer and non-unique across a network.

items.last_transfered_at

string

items.nft_data

object

Show child attributes

items.nft_data.asset_cached

boolean

If true, the asset data is available from the Covalent CDN.

items.nft_data.current_owner

string

The current holder of this NFT.

items.nft_data.external_data

object

Show child attributes

items.nft_data.external_data.animation_url

string

items.nft_data.external_data.asset_file_extension

string

items.nft_data.external_data.asset_mime_type

string

items.nft_data.external_data.asset_properties

object

The asset properties.

Show child attributes

items.nft_data.external_data.asset_properties.asset_height

integer

The height of the asset.

items.nft_data.external_data.asset_properties.asset_width

integer

The width of the asset.

items.nft_data.external_data.asset_properties.dominant_color

string

The dominant color of the asset.

items.nft_data.external_data.asset_size_bytes

string

items.nft_data.external_data.asset_url

string

items.nft_data.external_data.attributes

object[]

Show child attributes

items.nft_data.external_data.attributes.trait_type

string

items.nft_data.external_data.attributes.value

string

items.nft_data.external_data.description

string

items.nft_data.external_data.external_url

string

items.nft_data.external_data.image

string

items.nft_data.external_data.image_preview

string

The image preview URL.

items.nft_data.external_data.image1024

string

items.nft_data.external_data.image256

string

items.nft_data.external_data.image512

string

items.nft_data.external_data.name

string

items.nft_data.external_data.thumbnails

object

Various thumbnails of the asset.

Show child attributes

items.nft_data.external_data.thumbnails.image_opengraph_url

string

Resized image of the asset for OpenGraph.

items.nft_data.external_data.thumbnails.image1024

string

Resized 1024x1024 image of the asset.

items.nft_data.external_data.thumbnails.image256

string

Resized 256x256 image of the asset.

items.nft_data.external_data.thumbnails.image512

string

Resized 512x512 image of the asset.

items.nft_data.external_data.thumbnails.thumbhash

string

Base64 encoded hash of the thumbnail.

items.nft_data.image_cached

boolean

If true, the image data is available from the Covalent CDN.

items.nft_data.original_owner

string

The original minter.

items.nft_data.token_id

string

b;The token's id.

items.nft_data.token_url

string

items.supports_erc

string[]

A list of supported standard ERC interfaces, eg: ERC20 and ERC721.

items.token_id

string

b;The token's id.

items.type

string

updated_at

string

The timestamp when the response was generated. Useful to show data staleness to users.