---
title: "Get Wallet NFTs"
method: GET
path: "/v1/wallets/{address}/nfts"
tags: ["Gateway"]
---

# Get Wallet NFTs

`GET /v1/wallets/{address}/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.

## Path parameters

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

## Query parameters

- `chainId` integer[], 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
- `contractAddresses` string[] — NFT contract addresses to filter by. If provided, only NFTs with these addresses will be returned.
- `limit` integer — The number of NFTs to return per chain (default: 20, max: 500).
- `page` integer — The page number for pagination (default: 1, max: 20).

## Response `200`

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

- object
  - `result` object, required
    - `nfts` object[], required — Array of wallet NFTs.
      - `animation_url` string — The animation URL of the NFT
      - `attributes` object[] — The attributes/traits of the NFT
        - `display_type` string — The display type
        - `trait_type` string — The trait type
        - `value` union — The trait value
          - string
          - number
      - `chain_id` number, required — The chain ID of the NFT
      - `collection` object — Collection information
        - `description` string — The collection description
        - `external_url` string — The collection external URL
        - `image` string — The collection image URL
        - `name` string — The collection name
      - `description` string — The description of the NFT
      - `external_url` string — The external URL of the NFT
      - `image_url` string — The image URL of the NFT
      - `metadata` object — Additional metadata for the NFT
      - `name` string — The name of the NFT
      - `token_address` string, required — The contract address of the NFT collection
      - `token_id` string, required — The token ID of the NFT
    - `pagination` object, required
      - `hasMore` boolean — Whether there are more items available
      - `limit` number, nullable — Number of items per page
      - `page` number, nullable — Current page number
      - `totalCount` number, nullable — Total number of items available

## Other responses

- `400` — Invalid request parameters. This occurs when the wallet address format is invalid, chainId array is empty or exceeds the maximum limit of 50, or pagination parameters are out of range.
- `401` — Authentication required. The request must include a valid `x-client-id` header for frontend usage or `x-secret-key` for backend usage.
- `404` — Wallet not found or no NFTs available for the specified wallet address on the given blockchain networks.
- `500` — Internal server error. This may occur due to network connectivity issues, external service unavailability, or unexpected server errors.

---

[API](https://skmtc.net/thirdweb/apis/thirdweb-api.md) · [All operations](https://skmtc.net/thirdweb/apis/thirdweb-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/thirdweb/thirdweb-api/revisions/fb4cb67da1c7/schema)