Check ownership in NFT collection

Commonly used to verify ownership of NFTs (including ERC-721 and 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

Mastering the ERC-1155 Multi-Token Standard (Part 2)

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.

Query Parameters

traits-filter

string

Filters NFTs based on a specific trait. If this filter is used, the API will return all NFTs with the specified trait. Must be used with "values-filter", is case-sensitive, and requires proper URL encoding.

values-filter

string

Filters NFTs based on a specific trait value. If this filter is used, the API will return all NFTs with the specified trait value. Must be used with "traits-filter", is case-sensitive, and requires proper URL encoding.

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.