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
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
Send a GET request to the
/api/wallet/{address}/{chain}/global-inventoryendpoint to retrieve NFT balances.Handle the response accordingly based on success or internal server error.
Note: Ensure the wallet address and blockchain chain are valid.
Last updated