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: ETHEREUMPossible values:

pageSizeinteger · int64Required

page length in pagination

Example: 10

pageNumberinteger · int64Required

page number in pagination

Example: 10

Responses

200

NFT balances fetched successfully

application/json

400

Invalid request

application/json

401

Authorization error

application/json

404

User not found

application/json

get

HTTPcURLJavaScriptPython

GET /api/v1/user/{user_uuid}/wallet/balance/nfts HTTP/1.1
Host: www.developer.metasky.me
api_key: YOUR_API_KEY
Accept: */*

{
  "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
  }
}