NFT Collections By Wallet

POST

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

POST

/data/v1/:apiKey/assets/nfts/contracts/by-address

1 curl -X POST https://api.g.alchemy.com/data/v1/docs-demo/assets/nfts/contracts/by-address \
2      -H "Content-Type: application/json" \
3      -d '{
4   "addresses": [
5     {
6       "address": "0x1E6E8695FAb3Eb382534915eA8d7Cc1D1994B152",
7       "networks": [
8         "eth-mainnet"
9       ]
10     }
11   ]
12 }'

Try it

200portfolioApiEndpointsGetNftContractsByAddressExample

1 {
2   "data": {
3     "ownedNfts": [
4       {
5         "network": "foo",
6         "address": "foo",
7         "contract": {
8           "address": "foo",
9           "name": "foo",
10           "symbol": "foo",
11           "totalSupply": "foo",
12           "tokenType": "ERC721",
13           "contractDeployer": "foo",
14           "deployedBlockNumber": 42,
15           "openseaMetadata": {
16             "floorPrice": 42,
17             "collectionName": "foo",
18             "safelistRequestStatus": "foo",
19             "imageUrl": "foo",
20             "description": "foo",
21             "externalUrl": "foo",
22             "twitterUsername": "foo",
23             "discordUrl": "foo",
24             "lastIngestedAt": "foo"
25           },
26           "isSpam": "foo",
27           "spamClassifications": [
28             "foo"
29           ]
30         },
31         "tokenId": "44",
32         "tokenType": "foo",
33         "name": "foo",
34         "description": "foo",
35         "image": {
36           "cachedUrl": "foo",
37           "thumbnailUrl": "foo",
38           "pngUrl": "foo",
39           "contentType": "foo",
40           "size": 42,
41           "originalUrl": "foo"
42         },
43         "raw": {
44           "tokenUri": "foo",
45           "metadata": {
46             "image": "foo",
47             "name": "foo",
48             "description": "foo",
49             "attributes": [
50               {
51                 "value": "foo",
52                 "trait_type": "foo"
53               }
54             ]
55           },
56           "error": "foo"
57         },
58         "collection": {
59           "name": "foo",
60           "slug": "foo",
61           "externalUrl": "foo",
62           "bannerImageUrl": "foo"
63         },
64         "tokenUri": "foo",
65         "timeLastUpdated": "foo",
66         "acquiredAt": {
67           "blockTimestamp": "foo",
68           "blockNumber": "foo"
69         }
70       }
71     ],
72     "totalCount": 42,
73     "pageKey": "foo"
74   }
75 }

Fetches NFT collections (contracts) for multiple wallet addresses and networks. Returns a list of collections and metadata for each wallet/network combination. 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 parameters

apiKeystringRequired

Request

This endpoint expects an object.

addresseslist of objectsRequired

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

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

pageKeystringOptional

pageSizeintegerOptionalDefaults to 100

Response

Successful response!

dataobject

List of nfts by address with appropriate metadata.

Path parameters

Request

Response

Errors