GET
/
v1
/
{chainName}
/
nft
/
{contractAddress}
/
metadata
/
Credit Cost: 15 per call.
Processing: Realtime

Path Parameters

chainName
string
required

The chain name eg: eth-mainnet.

contractAddress
string
required

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

Query Parameters

no-metadata
boolean

Omit metadata.

page-size
integer

Number of items per page. Omitting this parameter defaults to 50.

page-number
integer

0-indexed page number to begin pagination.

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. Accepts comma-separated values, 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. If used with "traits-filter", only NFTs matching both filters will be returned. Accepts comma-separated values, is case-sensitive, and requires proper URL encoding.

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
updated_at
string

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

items
object[]

List of response items.

pagination
object

Pagination metadata.

Get NFTs for addressGet single NFT with external metadata from contract