Skip to content
Alchemy Logo

NFT Collections By Wallet

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

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.

This endpoint fans out across every requested network and merges the results. If one or more networks fail (upstream error or per-network timeout: 5s on paginated requests, 10s on fetch-all), the response is still HTTP 200 with a top-level error.partialErrors array listing the failed networks. See Handling partial failures for the recommended client pattern.

Path Parameters

stringrequireddefaults to docs-demo

For higher throughput, create your own API key

Request Body

Responses

200

Successful response!

400

Bad Request: Invalid input (e.g., malformed JSON).

429

Too Many Requests: Rate limit exceeded.

Was this page helpful?