NFTs By Owner

post https://api.g.alchemy.com/data/v1/{apiKey}/assets/nfts/by-address

Retrieves all NFTs currently owned by multiple addresses using network and address pairs. This endpoint is supported on Ethereum and many L2s, including Polygon, Arbitrum, Optimism, Base, World Chain and more. See the full list of supported networks here.

Path Params

apiKey

string

required

Defaults to docs-demo

For higher throughput, create your own API key

Body Params

addresses

array of objects

required

length between 1 and 2

Array of address and networks pairs (limit 2 pairs, max 5 networks each). Networks should match network enums.

addresses*

address

string

required

Defaults to 0x1E6E8695FAb3Eb382534915eA8d7Cc1D1994B152

Wallet address.

networks

array of strings

required

length between 1 and 5

Defaults to eth-mainnet,base-mainnet,matic-mainnet

Network identifier (e.g., eth-mainnet). Find more network enums here

networks*

withMetadata

boolean

Defaults to true

Boolean - if set to true, returns metadata. Setting this to false will reduce payload size and may result in a faster API call. Defaults to true.

pageKey

string

String - key for pagination. If more results are available, a pageKey will be returned in the response. Pass back the pageKey as a param to fetch the next page of results.

pageSize

string

Number of NFTs to be returned per page. Defaults to 100. Max is 100.

Responses

Language


xxxxxxxxxx
18
1
const options = {
2
  method: 'POST',
3
  headers: {accept: 'application/json', 'content-type': 'application/json'},
4
  body: JSON.stringify({
5
    addresses: [
6
      {
7
        address: '0x1E6E8695FAb3Eb382534915eA8d7Cc1D1994B152',
8
        networks: ['eth-mainnet', 'base-mainnet', 'matic-mainnet']
9
      }
10
    ],
11
    withMetadata: true
12
  })
13
};
14
15
fetch('https://api.g.alchemy.com/data/v1/docs-demo/assets/nfts/by-address', options)
16
  .then(res => res.json())
17
  .then(res => console.log(res))
18
  .catch(err => console.error(err));