Get Global Inventory

The endpoint "Get Global Inventory" allows you to retrieve the NFTs associated with a specific wallet address in the Polygon Network.

Overview

Endpoint

• Method: GET

• URL: /api/wallet/{address}/{chain}/global-inventory

Parameters

• address (Path Parameter): Wallet address (string).

• chain (Path Parameter): Blockchain (string). Available values: polygon only.

Responses

Success (Code 200)

{
  "ownedNfts": [
    {
      "contract": {
        "address": "0xb4412c146Ec8b02c27045F1f969a87e2B900EB4C",
        "name": "Avatars",
        "symbol": "AVA",
        "totalSupply": null,
        "tokenType": "ERC721",
        "contractDeployer": "0x7cA139225dA1bC1cC88cA05A45aFF05E32E8c125",
        "deployedBlockNumber": 43924399,
        "openSeaMetadata": {
          "floorPrice": null,
          "collectionName": null,
          "collectionSlug": null,
          "safelistRequestStatus": null,
          "imageUrl": null,
          "description": null,
          "externalUrl": null,
          "twitterUsername": null,
          "discordUrl": null,
          "bannerImageUrl": null,
          "lastIngestedAt": "2024-01-03T17:12:35.000Z"
        },
        "isSpam": null,
        "spamClassifications": []
      },
      "tokenId": "6",
      "tokenType": "ERC721",
      "name": "Rongo Sunn",
      "description": "Player",
      "tokenUri": "https://ipfs.io/ipfs/QmbMRP8Vk3H8yko2FxxYe1WJwPfmYRQbgGqsHpwKGEDCmF",
      "image": {
        "cachedUrl": "https://xerial-main-bucket.s3.us-east-1.amazonaws.com/d8f646ba9597ad9db1811b3484bd36afb92974f64ea48ead66c0e3042edb08ee-Screen%20Shot%202023-12-27%20at%2016.13.00.png",
        "thumbnailUrl": null,
        "pngUrl": null,
        "contentType": null,
        "size": null,
        "originalUrl": "https://xerial-main-bucket.s3.us-east-1.amazonaws.com/d8f646ba9597ad9db1811b3484bd36afb92974f64ea48ead66c0e3042edb08ee-Screen%20Shot%202023-12-27%20at%2016.13.00.png"
      },
      "raw": {
        "tokenUri": "https://purple-jealous-spoonbill-384.mypinata.cloud/ipfs/QmbMRP8Vk3H8yko2FxxYe1WJwPfmYRQbgGqsHpwKGEDCmF",
        "metadata": {
          "name": "Rongo Sunn",
          "description": "Player",
          "image": "https://xerial-main-bucket.s3.us-east-1.amazonaws.com/d8f646ba9597ad9db1811b3484bd36afb92974f64ea48ead66c0e3042edb08ee-Screen%20Shot%202023-12-27%20at%2016.13.00.png",
          "externalUrl": "https://joko.xerial.io/",
          "animationUrls": [],
          "attributes": [],
          "contract": {
            "address": "0xb4412c146Ec8b02c27045F1f969a87e2B900EB4C",
            "name": "Avatars",
            "symbol": "AVA",
            "image": "https://xerial-main-bucket.s3.us-east-1.amazonaws.com/2f2f53a5f69ad6d9b5cea7fbe3299587f86f7b002aef0a739d6dc34cd6dff7ef-_%20%284%29.jpeg",
            "description": "Ava",
            "externalUrl": "https://google.com"
          },
          "maxSupply": "5",
          "edition": 1
        },
        "error": null
      },
      "collection": null,
      "mint": {
        "mintAddress": "0xb49c7417661a4d4b46fa64be91ff93d80d163a82",
        "blockNumber": 44364249,
        "timestamp": "2024-01-04T00:26:12Z",
        "transactionHash": "0x09fc3dd8ca7fa06b9d4a462da22afbf5d3e8cd982eda9bc311e1e0f3d0aa80f4"
      },
      "owners": null,
      "timeLastUpdated": "2024-01-05T18:01:53.073Z",
      "balance": "1",
      "acquiredAt": {
        "blockTimestamp": null,
        "blockNumber": null
      }
    },
    {
      "contract": {
        "address": "0xb4412c146Ec8b02c27045F1f969a87e2B900EB4C",
        "name": "Avatars",
        "symbol": "AVA",
        "totalSupply": null,
        "tokenType": "ERC721",
        "contractDeployer": "0x7cA139225dA1bC1cC88cA05A45aFF05E32E8c125",
        "deployedBlockNumber": 43924399,
        "openSeaMetadata": {
          "floorPrice": null,
          "collectionName": null,
          "collectionSlug": null,
          "safelistRequestStatus": null,
          "imageUrl": null,
          "description": null,
          "externalUrl": null,
          "twitterUsername": null,
          "discordUrl": null,
          "bannerImageUrl": null,
          "lastIngestedAt": "2024-01-03T17:12:35.000Z"
        },
        "isSpam": null,
        "spamClassifications": []
      },
      "tokenId": "7",
      "tokenType": "ERC721",
      "name": "Rongo Sunn",
      "description": "Player",
      "tokenUri": "https://ipfs.io/ipfs/QmbMRP8Vk3H8yko2FxxYe1WJwPfmYRQbgGqsHpwKGEDCmF",
      "image": {
        "cachedUrl": "https://xerial-main-bucket.s3.us-east-1.amazonaws.com/d8f646ba9597ad9db1811b3484bd36afb92974f64ea48ead66c0e3042edb08ee-Screen%20Shot%202023-12-27%20at%2016.13.00.png",
        "thumbnailUrl": null,
        "pngUrl": null,
        "contentType": null,
        "size": null,
        "originalUrl": "https://xerial-main-bucket.s3.us-east-1.amazonaws.com/d8f646ba9597ad9db1811b3484bd36afb92974f64ea48ead66c0e3042edb08ee-Screen%20Shot%202023-12-27%20at%2016.13.00.png"
      },
      "raw": {
        "tokenUri": "https://purple-jealous-spoonbill-384.mypinata.cloud/ipfs/QmbMRP8Vk3H8yko2FxxYe1WJwPfmYRQbgGqsHpwKGEDCmF",
        "metadata": {
          "name": "Rongo Sunn",
          "description": "Player",
          "image": "https://xerial-main-bucket.s3.us-east-1.amazonaws.com/d8f646ba9597ad9db1811b3484bd36afb92974f64ea48ead66c0e3042edb08ee-Screen%20Shot%202023-12-27%20at%2016.13.00.png",
          "externalUrl": "https://joko.xerial.io/",
          "animationUrls": [],
          "attributes": [],
          "contract": {
            "address": "0xb4412c146Ec8b02c27045F1f969a87e2B900EB4C",
            "name": "Avatars",
            "symbol": "AVA",
            "image": "https://xerial-main-bucket.s3.us-east-1.amazonaws.com/2f2f53a5f69ad6d9b5cea7fbe3299587f86f7b002aef0a739d6dc34cd6dff7ef-_%20%284%29.jpeg",
            "description": "Ava",
            "externalUrl": "https://google.com"
          },
          "maxSupply": "5",
          "edition": 1
        },
        "error": null
      },
      "collection": null,
      "mint": {
        "mintAddress": "0xb49c7417661a4d4b46fa64be91ff93d80d163a82",
        "blockNumber": 44392816,
        "timestamp": "2024-01-04T17:18:23Z",
        "transactionHash": "0x2cec711a07f49242c3ed5a058f7b94e50e653053c39e585b23bf554653832e81"
      },
      "owners": null,
      "timeLastUpdated": "2024-01-05T18:01:53.082Z",
      "balance": "1",
      "acquiredAt": {
        "blockTimestamp": null,
        "blockNumber": null
      }
    }
  ],
  "totalCount": 2,
  "validAt": {
    "blockNumber": 44433072,
    "blockHash": "0x8aaf90505c7b9ed4f4acaa7e74072a50974afa39b375ccff6251d19904ddfe84",
    "blockTimestamp": "2024-01-05T18:01:51Z"
  },
  "pageKey": null
}

• Media Type: application/json.

• Example Value: An object containing the information of the NFTs of an address and the total amount it owns in the Polygon Network.

Internal Server Error (Code 500)

{
  "error": "Internal Server Error"
}

• Media Type: application/json

• Example Value: An error response indicating an internal server error.

Usage

1. Send a GET request to the /api/wallet/{address}/{chain}/global-inventory endpoint to retrieve NFT balances.

2. Handle the response accordingly based on success or internal server error.

Note: Ensure the wallet address and blockchain chain are valid.