Fetch All Wallet NFTs

This API fetches all the NFTs present in user's wallet and their details such as name, collection name, description, and image.

Fetch all wallet NFTs

get

Fetch all wallet NFTs

Authorizations

Path parameters

user_uuidstringrequired

user_uuid of the user whose wallet balance summary needs to be fetched

Query parameters

refresh_balancestringoptional

setting refresh_balance as true hard refreshes wallet balances in metasky systems immediately

onchain_contract_addressstringoptional

blockchain address of an NFT contract

network_nameobject · enumoptional

Network name of blockchain whose NFT balances need to be filtered

Example: ETHEREUM

Available options:

pageSizeinteger · int64required

page length in pagination

Example: 10

pageNumberinteger · int64required

page number in pagination

Example: 10

Responses

application/json

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://www.developer.metasky.me/api/v1/user/{user_uuid}/wallet/balance/nfts?pageSize=10&pageNumber=10' \
  --header 'api_key: YOUR_API_KEY'

200

400

401

404

200

{
  "message": "NFT balances fetched successfully",
  "status": "success",
  "request_id": "7e0c3676-82c9-43dc-8678-61bc4aa7c72c",
  "data": {
    "nfts": [
      {
        "nft_uuid": "nftsbobo4-4d0d-4b16-a580-2e29cb8e73e7",
        "collection_uuid": "tokenbobo4-4d0d-4b16-a580-2e29cb8e73e7",
        "quantity": 10,
        "onchain_token_id": "3",
        "onchain_contract_address": "0x0500065b7943102e06c31dc16a8d2a7414330d7a",
        "image": "https://skywallet-public-resources.s3.ap-southeast-1.amazonaws.com/pebblepotli/potli.png",
        "animation": "https://skywallet-public-resources.s3.ap-southeast-1.amazonaws.com/pebblepotli/potli.gif",
        "description": "A mystical handbag that holds 20000 pebbles. Offer your pebble potli along with Minato Chitoseame Candy in Tanuki shrine to claim Minato Chan PFP.",
        "name": "Pebble potli",
        "media_type": "image",
        "properties": {},
        "creator": {
          "name": "Tanukiverse",
          "onchain_address": "tanukiverse.eth"
        },
        "network": {
          "type": "EVM",
          "chain_id": "1",
          "name": "ETHEREUM"
        },
        "rarity": 0.3,
        "rarityRank": 10
      }
    ],
    "total_count": 1000,
    "page_number": 10,
    "page_size": 10
  }
}

NFT balances fetched successfully