Get NFTs for address

GET

{chainName}

address

{walletAddress}

balances_nft

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

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.

Query Parameters

no-spam

boolean

If true, the suspected spam tokens are removed. Supports eth-mainnet and matic-mainnet.

no-nft-asset-metadata

boolean

If true, the response shape is limited to a list of collections and token ids, omitting metadata and asset information. Helpful for faster response times and wallets holding a large number of NFTs.

with-uncached

boolean

By default, this endpoint only works on chains where we've cached the assets and the metadata. When set to true, the API will fetch metadata from upstream servers even if it's not cached - the downside being that the upstream server can block or rate limit the call and therefore resulting in time outs or slow response times on the Covalent side.

Response

200 - application/json

address

string

The requested address.

updated_at

string

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

items

object[]

List of response items.

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.contract_address

string

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

items.supports_erc

string[]

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

items.is_spam

boolean

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

items.last_transfered_at

string

items.balance

string

b;The asset balance. Use contract_decimals to scale this balance for display purposes.

items.balance24h

string

items.type

string

items.floor_price_quote

number

The current floor price converted to fiat in quote-currency. The floor price is determined by the last minimum sale price within the last 30 days across all the supported markets where the collection is sold on.

items.pretty_floor_price_quote

string

A prettier version of the floor price quote for rendering purposes.

items.floor_price_native_quote

number

The current floor price in native currency. The floor price is determined by the last minimum sale price within the last 30 days across all the supported markets where the collection is sold on.

items.nft_data

object[]

items.nft_data.token_id

string

b;The token's id.

items.nft_data.token_url

string

items.nft_data.original_owner

string

The original minter.

items.nft_data.current_owner

string

The current holder of this NFT.

items.nft_data.external_data

object

items.nft_data.asset_cached

boolean

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

items.nft_data.image_cached

boolean

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

Get all transactions in a block (v3)Get NFTs from contract with metadata

API Reference

Cross Chain

Balances

Transactions

NFT

Security

Bitcoin

Utility

Path Parameters

Query Parameters

Response