NFT Collections By Wallet

import requests
url = "https://api.g.alchemy.com/data/v1/docs-demo/assets/nfts/contracts/by-address"
payload = { "addresses": [
        {
            "address": "0x1E6E8695FAb3Eb382534915eA8d7Cc1D1994B152",
            "networks": ["eth-mainnet"]
        }
    ] }
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.json())

{
  "data": {
    "contracts": [
      {
        "network": "string",
        "address": "string",
        "contract": {
          "address": "string",
          "name": "string",
          "symbol": "string",
          "totalSupply": "string",
          "tokenType": "ERC721",
          "contractDeployer": "string",
          "deployedBlockNumber": 1.1,
          "openseaMetadata": {
            "floorPrice": 1.1,
            "collectionName": "string",
            "safelistRequestStatus": "string",
            "imageUrl": "string",
            "description": "string",
            "externalUrl": "string",
            "twitterUsername": "string",
            "discordUrl": "string",
            "bannerImageUrl": "string",
            "lastIngestedAt": "string"
          },
          "isSpam": "string",
          "spamClassifications": [
            "string"
          ]
        }
      }
    ],
    "totalCount": 1,
    "pageKey": "string"
  }
}

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

apiKeystringRequiredDefaults to docs-demo

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

orderByenumOptional

Field to order results by

Allowed values:

sortOrderenumOptional

Sort order for results

Allowed values:

Response

Successful response!

dataobject

List of nft collections.

Path parameters

Request

Response

Errors