---
title: "Get NFTs owned by address"
method: GET
path: "/v1/account/nfts"
tags: ["NFT Balances"]
---

# Get NFTs owned by address

`GET /v1/account/nfts`

Get the list of NFTs owned by an account.

## Query parameters

- `chain_id` string, required — chain network id, see [list of details](/platform/features/api/web3-api)
- `address` string, required — A hex string referencing a wallet address
- `contract_address` string — The address of the NFT contract, or filter multiple addresses, (max 100), eg:contract_address=0xed5af388653567af2f388e6224dc7c4b3241c545,0x1a92f7381b9f03921564a437210bb9396471050c
- `page` integer — The page offset
- `limit` integer — The desired page size limit. Less or equal than 100

## Headers

- `x-api-key` string, required

## Response `200`

Successful Response

- ResponseGetAccountNFTs
  - `code` integer
  - `message` string
  - `data` NFTDetail[]
    - `contract_address` string, required — The contract address
    - `erc_type` string, required — ERC standard related to the contract.
    - `metadata` object — The metadata of the item.
    - `mint_time` string, date-time, required — The timestamp when the item was minted.
    - `mint_transaction_hash` string, required — The block number when the item was minted.
    - `name` string, required — The name of the item.
    - `owner` string, required — The user address who owns the item now (null if the item is an ERC-1155 NFT).
    - `symbol` string, required — The symbol of the NFT contract.
    - `token_id` string, required — The token ID number of the item.
    - `token_uri` string, required — The token URI of the item.
    - `image_uri` string, required — The image URI of the item.
    - `total` integer, required — The total amount of the item.
    - `total_string` string, required — The total amount of item in string.
    - `traits` unknown
    - `rarity_score` number — The rarity score for the item.
    - `rarity_rank` integer — The rarity rank for the item.
    - `floor_prices` NFTCollectionFloorPrice[] — List of floor prices.
      - `value` string — The amount of the ERC-20 token.
      - `symbol` string — The symbol of the ERC-20 token.
      - `address` string — The address of the ERC-20 token.
  - `next_page` integer
  - `count` integer

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `422` — Unprocessable Entity
- `500` — Internal Server Error

---

[API](https://skmtc.dev/chainbase/apis/data-cloud-task-api.md) · [All operations](https://skmtc.dev/chainbase/apis/data-cloud-task-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/chainbase/data-cloud-task-api/revisions/4013781aa422/schema)