v1

latestOpenAPI 3.1.02026-07-13570316.1 KB
Gateway

Get Wallet NFTs

Retrieves NFTs for a specific wallet address across one or more blockchain networks. This endpoint provides comprehensive NFT data including metadata, attributes, and collection information. Results can be filtered by chain and paginated to meet specific requirements.

Authentication: Pass x-client-id header for frontend usage from allowlisted origins or x-secret-key for backend usage.

get/v1/wallets/{address}/nfts

Path parameters

addressstring required

A valid Ethereum address (0x-prefixed hex string) or ENS name (e.g., vitalik.eth).

A valid Ethereum address (0x-prefixed hex string) or ENS name (e.g., vitalik.eth).

Query parameters

chainIdinteger[] required

Chain ID(s) to request NFT data for. You can specify multiple chain IDs by repeating the parameter, up to a maximum of 50. Example: ?chainId=1&chainId=137

Chain ID(s) to request NFT data for. You can specify multiple chain IDs by repeating the parameter, up to a maximum of 50. Example: ?chainId=1&chainId=137

contractAddressesstring[]

NFT contract addresses to filter by. If provided, only NFTs with these addresses will be returned.

NFT contract addresses to filter by. If provided, only NFTs with these addresses will be returned.

limitinteger

The number of NFTs to return per chain (default: 20, max: 500).

The number of NFTs to return per chain (default: 20, max: 500).

pageinteger

The page number for pagination (default: 1, max: 20).

The page number for pagination (default: 1, max: 20).

Response

Wallet NFTs retrieved successfully. Returns NFT data with metadata including pagination information and chain details. Includes NFT metadata, attributes, and collection information when available.