---
title: "Get wallet NFT collections"
method: GET
path: "/v1/wallets/{address}/nft-collections/"
tags: ["wallets"]
---

# Get wallet NFT collections

`GET /v1/wallets/{address}/nft-collections/`

This endpoint returns a list of the NFT collections held by a specific wallet.

This endpoint supports testnets. To get data for testnets use `X-Env` header.

If the wallet address has not been previously added, this endpoint may return a `202` status code. This indicates that the wallet's collections are not yet available, but will be in the near future. In this case, the client should periodically request this endpoint until a `200` status code is returned.

> NOTE: It is important to stop retrying after a reasonable period of time. If a `200` status code is not returned within 2 minutes, it is likely that an unexpected error has occurred, and the client should stop polling.

> NOTE: This endpoint provides support for filters, sorting. Ensure that the length of the request URL falls within a safe range for your platform. Typically, a length of 2000 characters is a safe limit for most combinations of client and server software.

> NOTE: Consider all IDs as abstract strings, without making any assumptions about their format or relying on such assumptions. There is a non-zero probability that IDs may change in the future, and this should not result in any breaking changes.

## Path parameters

- `address` union, required — A wallet address, which can be either an EVM or Solana address
  - string — Ethereum-compatible address (EVM).
  - string — Solana address

## Query parameters

- `filter[chain_ids]` string[]
- `sort` '-max_changed_at' | 'min_changed_at' | 'total_floor_price' | '-total_floor_price'
- `currency` 'eth' | 'btc' | 'usd' | 'eur' | 'krw' | 'rub' | 'gbp' | 'aud' | 'cad' | 'inr' | 'jpy' | 'nzd' | 'try' | 'zar' | 'cny' | 'chf'
- `include` string[]

## Headers

- `X-Env` 'testnet'

## Response `200`

Response for requested list of NFT collections.

- Response5
  - `links` ResponseLinks5, required
    - `self` string, url, required
  - `data` object[], required
    - `type` string, required — NFT collection resource type.
    - `id` integer, required — NFT collection's unique ID.
    - `attributes` Attributes8, required
      - `min_changed_at` string, nullable — The earliest `changed_at` date and time alongside all wallet's positions from the collection.
      - `max_changed_at` string, nullable — The most recent `changed_at` date and time alongside all wallet's positions from the collection.
      - `nfts_count` string, required — The total quantity of the wallet's NFT positions from the collection.
      - `total_floor_price` number, float, required — The lowest price (floor) of the all wallet's NFTs positions from the collection. Measured in the requested currency.
      - `collection_info` Info3 — Represents an NFT collection short info.
        - `name` string — The name of the collection.
        - `description` string — The description of the collection.
        - `content` Content2
          - `icon` object — Icon related to object.
            - `url` string, url, nullable — URL of the icon.
          - `banner` object — The URL for the collection's banner image.
            - `url` string, url, required — URL to the content
            - `content_type` string — MIME content type
    - `relationships` Relationships5
      - `chains` Relationship[], required — The blockchain on which the NFT collection exists.
        - `links` RelationshipLinks, required
          - `related` string, url, required — URL to the current chain.
        - `data` ContainerShort, required
          - `type` string, required — Chain resource type.
          - `id` string, required — Chain unique identifier.
      - `nft_collection` object, required — The NFT collection itself.
        - `data` ContainerShort4, required
          - `type` string — NFT collections resource type.
          - `id` integer — Unique NFT collection ID.
    - `included` Container6[]
      - `type` string — NFT collections resource type.
      - `id` integer — Unique NFT collection ID.
      - `attributes` ContainerAttributes — Represents an NFT collection attributes corresponding to JSON API specification.
        - `metadata` Metadata2 — Metadata associated with the NFT.
          - `name` string — The name of the collection.
          - `description` string — The description of the collection.
          - `content` Content2
            - `icon` object — Icon related to object.
              - …
            - `banner` object — The URL for the collection's banner image.
              - …
          - `payment_token_symbol` string — The symbol for the payment token used by the collection.
        - `market_data` MarketData3 — Contains marketplace data for a collection of NFTs.
          - `prices` MarketDataPrices2 — Prices associated with the NFT collection expressed in the currency specified in the request parameters.
            - `floor` number, float — The lowest known price for an NFT in the collection.
        - `implementations` Implementation2[] — List of blockchain implementations where this collection is deployed
          - `chain_id` string, required — The chain ID where the collection is deployed.
          - `address` string, nullable, required — The contract address of the collection on the chain.

## Other responses

- `202` — Request accepted, but NFT collections held by the wallet are still being aggregated.
- `400` — Parameters are malformed
- `401` — Unathenticated request
- `429` — Too many requests error

---

[API](https://skmtc.dev/zerion/apis/rest-api.md) · [All operations](https://skmtc.dev/zerion/apis/rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/zerion/rest-api/revisions/2ef116ef914f/schema)