Retrieve NFTs

How to retrieve non-fungible tokens for a wallet.

Retrieve NFTs by:

  1. Wallet id
  2. Blockchain and wallet address
  3. Blockchain
  4. Blockchain, contract address, and token Id

📘

Optionally, you can filter the response using the two boolean query params:

  • includePossibleSpam: Indication to include possible spam NFTs in the response body or not.
  • includeNsfw: Indication to show the NSFW NFTs in the response body or not.

1. Get NFTs by wallet Id

Request Endpoint: reference

GET /api/wallets/{walletId}/nonfungibles
ParameterParam TypeDescriptionData TypeMandatory
{walletId}PathThe ID of the walletString

Request Example

GET https://api-wallet-sandbox.venly.io/api/wallets/da8d6b3b-5e4a-4e9d-b12f-59d68b396d6f/nonfungibles

Response Body

{ "success": true, "result": [ { "id": "36", "name": "My first NFT", "description": "Venly", "imageUrl": "https://cdn.simplehash.com/assets/bd615a8b9794af04d85d1e8b670efa1d8693c5db44fceb0c08635026d8391c50.png", "imagePreviewUrl": "https://lh3.googleusercontent.com/bmoIbpwC61Fzti43tCrO2I8ylJB67ly7JOwER5U8qxQBUyFfvJdesnQUwdSPULkwEp2uocvcU1XSJGHroy6q74M27WybaGRqx20", "imageThumbnailUrl": "https://lh3.googleusercontent.com/bmoIbpwC61Fzti43tCrO2I8ylJB67ly7JOwER5U8qxQBUyFfvJdesnQUwdSPULkwEp2uocvcU1XSJGHroy6q74M27WybaGRqx20=s250", "animationUrls": [], "fungible": false, "contract": { "name": "Burn NFT Collection", "description": "Sample description", "address": "0x86b16217e6df213aa9de167a11b009c4740a8c8c", "symbol": "BUNFCO", "media": [ { "type": "image", "value": "https://lh3.googleusercontent.com/WH-UcOGJ_6bTQJNPHQY3tMU2DieftTDVuomxWT12grRECKimext1PAIgVMqRogtezktTXD75CdU5xdsxo18s671m-iumkLD_VVw" } ], "type": "ERC_1155", "verified": false, "premium": false, "categories": [], "imageUrl": "https://lh3.googleusercontent.com/WH-UcOGJ_6bTQJNPHQY3tMU2DieftTDVuomxWT12grRECKimext1PAIgVMqRogtezktTXD75CdU5xdsxo18s671m-iumkLD_VVw" }, "attributes": [ { "type": "property", "name": "Token Type ID", "value": "34" } ], "balance": 1, "finalBalance": 1, "transferFees": false }, { "id": "35", "name": "My first NFT", "description": "Venly", "imageUrl": "https://cdn.simplehash.com/assets/bd615a8b9794af04d85d1e8b670efa1d8693c5db44fceb0c08635026d8391c50.png", "imagePreviewUrl": "https://lh3.googleusercontent.com/bmoIbpwC61Fzti43tCrO2I8ylJB67ly7JOwER5U8qxQBUyFfvJdesnQUwdSPULkwEp2uocvcU1XSJGHroy6q74M27WybaGRqx20", "imageThumbnailUrl": "https://lh3.googleusercontent.com/bmoIbpwC61Fzti43tCrO2I8ylJB67ly7JOwER5U8qxQBUyFfvJdesnQUwdSPULkwEp2uocvcU1XSJGHroy6q74M27WybaGRqx20=s250", "animationUrls": [], "fungible": false, "contract": { "name": "Burn NFT Collection", "description": "Sample description", "address": "0x86b16217e6df213aa9de167a11b009c4740a8c8c", "symbol": "BUNFCO", "media": [ { "type": "image", "value": "https://lh3.googleusercontent.com/WH-UcOGJ_6bTQJNPHQY3tMU2DieftTDVuomxWT12grRECKimext1PAIgVMqRogtezktTXD75CdU5xdsxo18s671m-iumkLD_VVw" } ], "type": "ERC_1155", "verified": false, "premium": false, "categories": [], "imageUrl": "https://lh3.googleusercontent.com/WH-UcOGJ_6bTQJNPHQY3tMU2DieftTDVuomxWT12grRECKimext1PAIgVMqRogtezktTXD75CdU5xdsxo18s671m-iumkLD_VVw" }, "attributes": [ { "type": "property", "name": "Token Type ID", "value": "34" } ], "balance": 1, "finalBalance": 1, "transferFees": false }, { "id": "1", "name": "My first NFT", "description": "Venly", "imageUrl": "https://cdn.simplehash.com/assets/bd615a8b9794af04d85d1e8b670efa1d8693c5db44fceb0c08635026d8391c50.png", "imagePreviewUrl": "https://lh3.googleusercontent.com/bmoIbpwC61Fzti43tCrO2I8ylJB67ly7JOwER5U8qxQBUyFfvJdesnQUwdSPULkwEp2uocvcU1XSJGHroy6q74M27WybaGRqx20", "imageThumbnailUrl": "https://lh3.googleusercontent.com/bmoIbpwC61Fzti43tCrO2I8ylJB67ly7JOwER5U8qxQBUyFfvJdesnQUwdSPULkwEp2uocvcU1XSJGHroy6q74M27WybaGRqx20=s250", "animationUrls": [], "fungible": true, "contract": { "name": "Burn NFT Collection", "description": "Sample description", "address": "0x86b16217e6df213aa9de167a11b009c4740a8c8c", "symbol": "BUNFCO", "media": [ { "type": "image", "value": "https://lh3.googleusercontent.com/WH-UcOGJ_6bTQJNPHQY3tMU2DieftTDVuomxWT12grRECKimext1PAIgVMqRogtezktTXD75CdU5xdsxo18s671m-iumkLD_VVw" } ], "type": "ERC_1155", "verified": false, "premium": false, "categories": [], "imageUrl": "https://lh3.googleusercontent.com/WH-UcOGJ_6bTQJNPHQY3tMU2DieftTDVuomxWT12grRECKimext1PAIgVMqRogtezktTXD75CdU5xdsxo18s671m-iumkLD_VVw" }, "attributes": [ { "type": "property", "name": "Token Type ID", "value": "1" } ], "balance": 10, "finalBalance": 10, "transferFees": false }, { "id": "6", "name": "My first NFT", "description": "Venly", "imageUrl": "https://cdn.simplehash.com/assets/bd615a8b9794af04d85d1e8b670efa1d8693c5db44fceb0c08635026d8391c50.png", "imagePreviewUrl": "https://lh3.googleusercontent.com/bmoIbpwC61Fzti43tCrO2I8ylJB67ly7JOwER5U8qxQBUyFfvJdesnQUwdSPULkwEp2uocvcU1XSJGHroy6q74M27WybaGRqx20", "imageThumbnailUrl": "https://lh3.googleusercontent.com/bmoIbpwC61Fzti43tCrO2I8ylJB67ly7JOwER5U8qxQBUyFfvJdesnQUwdSPULkwEp2uocvcU1XSJGHroy6q74M27WybaGRqx20=s250", "animationUrls": [], "fungible": false, "contract": { "name": "My first collection", "description": "Sample description", "address": "0x4df3e0285df213d0516bdbd495f0593f8b6ec31a", "symbol": "MYFICO", "media": [ { "type": "image", "value": "https://lh3.googleusercontent.com/WH-UcOGJ_6bTQJNPHQY3tMU2DieftTDVuomxWT12grRECKimext1PAIgVMqRogtezktTXD75CdU5xdsxo18s671m-iumkLD_VVw" } ], "type": "ERC_1155", "verified": false, "premium": false, "categories": [], "imageUrl": "https://lh3.googleusercontent.com/WH-UcOGJ_6bTQJNPHQY3tMU2DieftTDVuomxWT12grRECKimext1PAIgVMqRogtezktTXD75CdU5xdsxo18s671m-iumkLD_VVw" }, "attributes": [ { "type": "property", "name": "Token Type ID", "value": "1" } ], "balance": 1, "finalBalance": 1, "transferFees": false }, { "id": "5", "name": "My first NFT", "description": "Venly", "imageUrl": "https://cdn.simplehash.com/assets/bd615a8b9794af04d85d1e8b670efa1d8693c5db44fceb0c08635026d8391c50.png", "imagePreviewUrl": "https://lh3.googleusercontent.com/bmoIbpwC61Fzti43tCrO2I8ylJB67ly7JOwER5U8qxQBUyFfvJdesnQUwdSPULkwEp2uocvcU1XSJGHroy6q74M27WybaGRqx20", "imageThumbnailUrl": "https://lh3.googleusercontent.com/bmoIbpwC61Fzti43tCrO2I8ylJB67ly7JOwER5U8qxQBUyFfvJdesnQUwdSPULkwEp2uocvcU1XSJGHroy6q74M27WybaGRqx20=s250", "animationUrls": [], "fungible": false, "contract": { "name": "My first collection", "description": "Sample description", "address": "0x4df3e0285df213d0516bdbd495f0593f8b6ec31a", "symbol": "MYFICO", "media": [ { "type": "image", "value": "https://lh3.googleusercontent.com/WH-UcOGJ_6bTQJNPHQY3tMU2DieftTDVuomxWT12grRECKimext1PAIgVMqRogtezktTXD75CdU5xdsxo18s671m-iumkLD_VVw" } ], "type": "ERC_1155", "verified": false, "premium": false, "categories": [], "imageUrl": "https://lh3.googleusercontent.com/WH-UcOGJ_6bTQJNPHQY3tMU2DieftTDVuomxWT12grRECKimext1PAIgVMqRogtezktTXD75CdU5xdsxo18s671m-iumkLD_VVw" }, "attributes": [ { "type": "property", "name": "Token Type ID", "value": "1" }, { "type": "property", "name": "Mint Number", "value": "4" } ], "balance": 1, "finalBalance": 1, "transferFees": false }, { "id": "4", "name": "My first NFT", "description": "Venly", "imageUrl": "https://cdn.simplehash.com/assets/bd615a8b9794af04d85d1e8b670efa1d8693c5db44fceb0c08635026d8391c50.png", "imagePreviewUrl": "https://lh3.googleusercontent.com/bmoIbpwC61Fzti43tCrO2I8ylJB67ly7JOwER5U8qxQBUyFfvJdesnQUwdSPULkwEp2uocvcU1XSJGHroy6q74M27WybaGRqx20", "imageThumbnailUrl": "https://lh3.googleusercontent.com/bmoIbpwC61Fzti43tCrO2I8ylJB67ly7JOwER5U8qxQBUyFfvJdesnQUwdSPULkwEp2uocvcU1XSJGHroy6q74M27WybaGRqx20=s250", "animationUrls": [], "fungible": false, "contract": { "name": "My first collection", "description": "Sample description", "address": "0x4df3e0285df213d0516bdbd495f0593f8b6ec31a", "symbol": "MYFICO", "media": [ { "type": "image", "value": "https://lh3.googleusercontent.com/WH-UcOGJ_6bTQJNPHQY3tMU2DieftTDVuomxWT12grRECKimext1PAIgVMqRogtezktTXD75CdU5xdsxo18s671m-iumkLD_VVw" } ], "type": "ERC_1155", "verified": false, "premium": false, "categories": [], "imageUrl": "https://lh3.googleusercontent.com/WH-UcOGJ_6bTQJNPHQY3tMU2DieftTDVuomxWT12grRECKimext1PAIgVMqRogtezktTXD75CdU5xdsxo18s671m-iumkLD_VVw" }, "attributes": [ { "type": "property", "name": "Token Type ID", "value": "1" }, { "type": "property", "name": "Mint Number", "value": "3" } ], "balance": 1, "finalBalance": 1, "transferFees": false }, { "id": "3", "name": "My first NFT", "description": "Venly", "imageUrl": "https://cdn.simplehash.com/assets/bd615a8b9794af04d85d1e8b670efa1d8693c5db44fceb0c08635026d8391c50.png", "imagePreviewUrl": "https://lh3.googleusercontent.com/bmoIbpwC61Fzti43tCrO2I8ylJB67ly7JOwER5U8qxQBUyFfvJdesnQUwdSPULkwEp2uocvcU1XSJGHroy6q74M27WybaGRqx20", "imageThumbnailUrl": "https://lh3.googleusercontent.com/bmoIbpwC61Fzti43tCrO2I8ylJB67ly7JOwER5U8qxQBUyFfvJdesnQUwdSPULkwEp2uocvcU1XSJGHroy6q74M27WybaGRqx20=s250", "animationUrls": [], "fungible": false, "contract": { "name": "My first collection", "description": "Sample description", "address": "0x4df3e0285df213d0516bdbd495f0593f8b6ec31a", "symbol": "MYFICO", "media": [ { "type": "image", "value": "https://lh3.googleusercontent.com/WH-UcOGJ_6bTQJNPHQY3tMU2DieftTDVuomxWT12grRECKimext1PAIgVMqRogtezktTXD75CdU5xdsxo18s671m-iumkLD_VVw" } ], "type": "ERC_1155", "verified": false, "premium": false, "categories": [], "imageUrl": "https://lh3.googleusercontent.com/WH-UcOGJ_6bTQJNPHQY3tMU2DieftTDVuomxWT12grRECKimext1PAIgVMqRogtezktTXD75CdU5xdsxo18s671m-iumkLD_VVw" }, "attributes": [ { "type": "property", "name": "Token Type ID", "value": "1" }, { "type": "property", "name": "Mint Number", "value": "2" } ], "balance": 1, "finalBalance": 1, "transferFees": false }, { "id": "2", "name": "My first NFT", "description": "Venly", "imageUrl": "https://cdn.simplehash.com/assets/bd615a8b9794af04d85d1e8b670efa1d8693c5db44fceb0c08635026d8391c50.png", "imagePreviewUrl": "https://lh3.googleusercontent.com/bmoIbpwC61Fzti43tCrO2I8ylJB67ly7JOwER5U8qxQBUyFfvJdesnQUwdSPULkwEp2uocvcU1XSJGHroy6q74M27WybaGRqx20", "imageThumbnailUrl": "https://lh3.googleusercontent.com/bmoIbpwC61Fzti43tCrO2I8ylJB67ly7JOwER5U8qxQBUyFfvJdesnQUwdSPULkwEp2uocvcU1XSJGHroy6q74M27WybaGRqx20=s250", "animationUrls": [], "fungible": false, "contract": { "name": "My first collection", "description": "Sample description", "address": "0x4df3e0285df213d0516bdbd495f0593f8b6ec31a", "symbol": "MYFICO", "media": [ { "type": "image", "value": "https://lh3.googleusercontent.com/WH-UcOGJ_6bTQJNPHQY3tMU2DieftTDVuomxWT12grRECKimext1PAIgVMqRogtezktTXD75CdU5xdsxo18s671m-iumkLD_VVw" } ], "type": "ERC_1155", "verified": false, "premium": false, "categories": [], "imageUrl": "https://lh3.googleusercontent.com/WH-UcOGJ_6bTQJNPHQY3tMU2DieftTDVuomxWT12grRECKimext1PAIgVMqRogtezktTXD75CdU5xdsxo18s671m-iumkLD_VVw" }, "attributes": [ { "type": "property", "name": "Token Type ID", "value": "1" }, { "type": "property", "name": "Mint Number", "value": "1" } ], "balance": 1, "finalBalance": 1, "transferFees": false } ] }

2. Get NFTs by blockchain and wallet address

Request Endpoint: reference

GET /api/wallets/{secretType}/{walletAddress}/nonfungibles
ParameterParam TypeDescriptionData TypeMandatory
{secretType}PathIndication on which chain the balance should be fetchedString
{walletAddress}PathThe address of the walletString

Example Request

GET https://api-wallet.venly.io/api/wallets/ETHEREUM/0x548372d982F478683FC1fc59b2e3224b4899fFBE/nonfungibles

Response Body

{ "success": true, "result": [ { "id": "36", "name": "My first NFT", "description": "Venly", "imageUrl": "https://cdn.simplehash.com/assets/bd615a8b9794af04d85d1e8b670efa1d8693c5db44fceb0c08635026d8391c50.png", "imagePreviewUrl": "https://lh3.googleusercontent.com/bmoIbpwC61Fzti43tCrO2I8ylJB67ly7JOwER5U8qxQBUyFfvJdesnQUwdSPULkwEp2uocvcU1XSJGHroy6q74M27WybaGRqx20", "imageThumbnailUrl": "https://lh3.googleusercontent.com/bmoIbpwC61Fzti43tCrO2I8ylJB67ly7JOwER5U8qxQBUyFfvJdesnQUwdSPULkwEp2uocvcU1XSJGHroy6q74M27WybaGRqx20=s250", "animationUrls": [], "fungible": false, "contract": { "name": "Burn NFT Collection", "description": "Sample description", "address": "0x86b16217e6df213aa9de167a11b009c4740a8c8c", "symbol": "BUNFCO", "media": [ { "type": "image", "value": "https://lh3.googleusercontent.com/WH-UcOGJ_6bTQJNPHQY3tMU2DieftTDVuomxWT12grRECKimext1PAIgVMqRogtezktTXD75CdU5xdsxo18s671m-iumkLD_VVw" } ], "type": "ERC_1155", "verified": false, "premium": false, "categories": [], "imageUrl": "https://lh3.googleusercontent.com/WH-UcOGJ_6bTQJNPHQY3tMU2DieftTDVuomxWT12grRECKimext1PAIgVMqRogtezktTXD75CdU5xdsxo18s671m-iumkLD_VVw" }, "attributes": [ { "type": "property", "name": "Token Type ID", "value": "34" } ], "balance": 1, "finalBalance": 1, "transferFees": false }, { "id": "35", "name": "My first NFT", "description": "Venly", "imageUrl": "https://cdn.simplehash.com/assets/bd615a8b9794af04d85d1e8b670efa1d8693c5db44fceb0c08635026d8391c50.png", "imagePreviewUrl": "https://lh3.googleusercontent.com/bmoIbpwC61Fzti43tCrO2I8ylJB67ly7JOwER5U8qxQBUyFfvJdesnQUwdSPULkwEp2uocvcU1XSJGHroy6q74M27WybaGRqx20", "imageThumbnailUrl": "https://lh3.googleusercontent.com/bmoIbpwC61Fzti43tCrO2I8ylJB67ly7JOwER5U8qxQBUyFfvJdesnQUwdSPULkwEp2uocvcU1XSJGHroy6q74M27WybaGRqx20=s250", "animationUrls": [], "fungible": false, "contract": { "name": "Burn NFT Collection", "description": "Sample description", "address": "0x86b16217e6df213aa9de167a11b009c4740a8c8c", "symbol": "BUNFCO", "media": [ { "type": "image", "value": "https://lh3.googleusercontent.com/WH-UcOGJ_6bTQJNPHQY3tMU2DieftTDVuomxWT12grRECKimext1PAIgVMqRogtezktTXD75CdU5xdsxo18s671m-iumkLD_VVw" } ], "type": "ERC_1155", "verified": false, "premium": false, "categories": [], "imageUrl": "https://lh3.googleusercontent.com/WH-UcOGJ_6bTQJNPHQY3tMU2DieftTDVuomxWT12grRECKimext1PAIgVMqRogtezktTXD75CdU5xdsxo18s671m-iumkLD_VVw" }, "attributes": [ { "type": "property", "name": "Token Type ID", "value": "34" } ], "balance": 1, "finalBalance": 1, "transferFees": false }, { "id": "1", "name": "My first NFT", "description": "Venly", "imageUrl": "https://cdn.simplehash.com/assets/bd615a8b9794af04d85d1e8b670efa1d8693c5db44fceb0c08635026d8391c50.png", "imagePreviewUrl": "https://lh3.googleusercontent.com/bmoIbpwC61Fzti43tCrO2I8ylJB67ly7JOwER5U8qxQBUyFfvJdesnQUwdSPULkwEp2uocvcU1XSJGHroy6q74M27WybaGRqx20", "imageThumbnailUrl": "https://lh3.googleusercontent.com/bmoIbpwC61Fzti43tCrO2I8ylJB67ly7JOwER5U8qxQBUyFfvJdesnQUwdSPULkwEp2uocvcU1XSJGHroy6q74M27WybaGRqx20=s250", "animationUrls": [], "fungible": true, "contract": { "name": "Burn NFT Collection", "description": "Sample description", "address": "0x86b16217e6df213aa9de167a11b009c4740a8c8c", "symbol": "BUNFCO", "media": [ { "type": "image", "value": "https://lh3.googleusercontent.com/WH-UcOGJ_6bTQJNPHQY3tMU2DieftTDVuomxWT12grRECKimext1PAIgVMqRogtezktTXD75CdU5xdsxo18s671m-iumkLD_VVw" } ], "type": "ERC_1155", "verified": false, "premium": false, "categories": [], "imageUrl": "https://lh3.googleusercontent.com/WH-UcOGJ_6bTQJNPHQY3tMU2DieftTDVuomxWT12grRECKimext1PAIgVMqRogtezktTXD75CdU5xdsxo18s671m-iumkLD_VVw" }, "attributes": [ { "type": "property", "name": "Token Type ID", "value": "1" } ], "balance": 10, "finalBalance": 10, "transferFees": false }, { "id": "6", "name": "My first NFT", "description": "Venly", "imageUrl": "https://cdn.simplehash.com/assets/bd615a8b9794af04d85d1e8b670efa1d8693c5db44fceb0c08635026d8391c50.png", "imagePreviewUrl": "https://lh3.googleusercontent.com/bmoIbpwC61Fzti43tCrO2I8ylJB67ly7JOwER5U8qxQBUyFfvJdesnQUwdSPULkwEp2uocvcU1XSJGHroy6q74M27WybaGRqx20", "imageThumbnailUrl": "https://lh3.googleusercontent.com/bmoIbpwC61Fzti43tCrO2I8ylJB67ly7JOwER5U8qxQBUyFfvJdesnQUwdSPULkwEp2uocvcU1XSJGHroy6q74M27WybaGRqx20=s250", "animationUrls": [], "fungible": false, "contract": { "name": "My first collection", "description": "Sample description", "address": "0x4df3e0285df213d0516bdbd495f0593f8b6ec31a", "symbol": "MYFICO", "media": [ { "type": "image", "value": "https://lh3.googleusercontent.com/WH-UcOGJ_6bTQJNPHQY3tMU2DieftTDVuomxWT12grRECKimext1PAIgVMqRogtezktTXD75CdU5xdsxo18s671m-iumkLD_VVw" } ], "type": "ERC_1155", "verified": false, "premium": false, "categories": [], "imageUrl": "https://lh3.googleusercontent.com/WH-UcOGJ_6bTQJNPHQY3tMU2DieftTDVuomxWT12grRECKimext1PAIgVMqRogtezktTXD75CdU5xdsxo18s671m-iumkLD_VVw" }, "attributes": [ { "type": "property", "name": "Token Type ID", "value": "1" } ], "balance": 1, "finalBalance": 1, "transferFees": false }, { "id": "5", "name": "My first NFT", "description": "Venly", "imageUrl": "https://cdn.simplehash.com/assets/bd615a8b9794af04d85d1e8b670efa1d8693c5db44fceb0c08635026d8391c50.png", "imagePreviewUrl": "https://lh3.googleusercontent.com/bmoIbpwC61Fzti43tCrO2I8ylJB67ly7JOwER5U8qxQBUyFfvJdesnQUwdSPULkwEp2uocvcU1XSJGHroy6q74M27WybaGRqx20", "imageThumbnailUrl": "https://lh3.googleusercontent.com/bmoIbpwC61Fzti43tCrO2I8ylJB67ly7JOwER5U8qxQBUyFfvJdesnQUwdSPULkwEp2uocvcU1XSJGHroy6q74M27WybaGRqx20=s250", "animationUrls": [], "fungible": false, "contract": { "name": "My first collection", "description": "Sample description", "address": "0x4df3e0285df213d0516bdbd495f0593f8b6ec31a", "symbol": "MYFICO", "media": [ { "type": "image", "value": "https://lh3.googleusercontent.com/WH-UcOGJ_6bTQJNPHQY3tMU2DieftTDVuomxWT12grRECKimext1PAIgVMqRogtezktTXD75CdU5xdsxo18s671m-iumkLD_VVw" } ], "type": "ERC_1155", "verified": false, "premium": false, "categories": [], "imageUrl": "https://lh3.googleusercontent.com/WH-UcOGJ_6bTQJNPHQY3tMU2DieftTDVuomxWT12grRECKimext1PAIgVMqRogtezktTXD75CdU5xdsxo18s671m-iumkLD_VVw" }, "attributes": [ { "type": "property", "name": "Token Type ID", "value": "1" }, { "type": "property", "name": "Mint Number", "value": "4" } ], "balance": 1, "finalBalance": 1, "transferFees": false }, { "id": "4", "name": "My first NFT", "description": "Venly", "imageUrl": "https://cdn.simplehash.com/assets/bd615a8b9794af04d85d1e8b670efa1d8693c5db44fceb0c08635026d8391c50.png", "imagePreviewUrl": "https://lh3.googleusercontent.com/bmoIbpwC61Fzti43tCrO2I8ylJB67ly7JOwER5U8qxQBUyFfvJdesnQUwdSPULkwEp2uocvcU1XSJGHroy6q74M27WybaGRqx20", "imageThumbnailUrl": "https://lh3.googleusercontent.com/bmoIbpwC61Fzti43tCrO2I8ylJB67ly7JOwER5U8qxQBUyFfvJdesnQUwdSPULkwEp2uocvcU1XSJGHroy6q74M27WybaGRqx20=s250", "animationUrls": [], "fungible": false, "contract": { "name": "My first collection", "description": "Sample description", "address": "0x4df3e0285df213d0516bdbd495f0593f8b6ec31a", "symbol": "MYFICO", "media": [ { "type": "image", "value": "https://lh3.googleusercontent.com/WH-UcOGJ_6bTQJNPHQY3tMU2DieftTDVuomxWT12grRECKimext1PAIgVMqRogtezktTXD75CdU5xdsxo18s671m-iumkLD_VVw" } ], "type": "ERC_1155", "verified": false, "premium": false, "categories": [], "imageUrl": "https://lh3.googleusercontent.com/WH-UcOGJ_6bTQJNPHQY3tMU2DieftTDVuomxWT12grRECKimext1PAIgVMqRogtezktTXD75CdU5xdsxo18s671m-iumkLD_VVw" }, "attributes": [ { "type": "property", "name": "Token Type ID", "value": "1" }, { "type": "property", "name": "Mint Number", "value": "3" } ], "balance": 1, "finalBalance": 1, "transferFees": false }, { "id": "3", "name": "My first NFT", "description": "Venly", "imageUrl": "https://cdn.simplehash.com/assets/bd615a8b9794af04d85d1e8b670efa1d8693c5db44fceb0c08635026d8391c50.png", "imagePreviewUrl": "https://lh3.googleusercontent.com/bmoIbpwC61Fzti43tCrO2I8ylJB67ly7JOwER5U8qxQBUyFfvJdesnQUwdSPULkwEp2uocvcU1XSJGHroy6q74M27WybaGRqx20", "imageThumbnailUrl": "https://lh3.googleusercontent.com/bmoIbpwC61Fzti43tCrO2I8ylJB67ly7JOwER5U8qxQBUyFfvJdesnQUwdSPULkwEp2uocvcU1XSJGHroy6q74M27WybaGRqx20=s250", "animationUrls": [], "fungible": false, "contract": { "name": "My first collection", "description": "Sample description", "address": "0x4df3e0285df213d0516bdbd495f0593f8b6ec31a", "symbol": "MYFICO", "media": [ { "type": "image", "value": "https://lh3.googleusercontent.com/WH-UcOGJ_6bTQJNPHQY3tMU2DieftTDVuomxWT12grRECKimext1PAIgVMqRogtezktTXD75CdU5xdsxo18s671m-iumkLD_VVw" } ], "type": "ERC_1155", "verified": false, "premium": false, "categories": [], "imageUrl": "https://lh3.googleusercontent.com/WH-UcOGJ_6bTQJNPHQY3tMU2DieftTDVuomxWT12grRECKimext1PAIgVMqRogtezktTXD75CdU5xdsxo18s671m-iumkLD_VVw" }, "attributes": [ { "type": "property", "name": "Token Type ID", "value": "1" }, { "type": "property", "name": "Mint Number", "value": "2" } ], "balance": 1, "finalBalance": 1, "transferFees": false }, { "id": "2", "name": "My first NFT", "description": "Venly", "imageUrl": "https://cdn.simplehash.com/assets/bd615a8b9794af04d85d1e8b670efa1d8693c5db44fceb0c08635026d8391c50.png", "imagePreviewUrl": "https://lh3.googleusercontent.com/bmoIbpwC61Fzti43tCrO2I8ylJB67ly7JOwER5U8qxQBUyFfvJdesnQUwdSPULkwEp2uocvcU1XSJGHroy6q74M27WybaGRqx20", "imageThumbnailUrl": "https://lh3.googleusercontent.com/bmoIbpwC61Fzti43tCrO2I8ylJB67ly7JOwER5U8qxQBUyFfvJdesnQUwdSPULkwEp2uocvcU1XSJGHroy6q74M27WybaGRqx20=s250", "animationUrls": [], "fungible": false, "contract": { "name": "My first collection", "description": "Sample description", "address": "0x4df3e0285df213d0516bdbd495f0593f8b6ec31a", "symbol": "MYFICO", "media": [ { "type": "image", "value": "https://lh3.googleusercontent.com/WH-UcOGJ_6bTQJNPHQY3tMU2DieftTDVuomxWT12grRECKimext1PAIgVMqRogtezktTXD75CdU5xdsxo18s671m-iumkLD_VVw" } ], "type": "ERC_1155", "verified": false, "premium": false, "categories": [], "imageUrl": "https://lh3.googleusercontent.com/WH-UcOGJ_6bTQJNPHQY3tMU2DieftTDVuomxWT12grRECKimext1PAIgVMqRogtezktTXD75CdU5xdsxo18s671m-iumkLD_VVw" }, "attributes": [ { "type": "property", "name": "Token Type ID", "value": "1" }, { "type": "property", "name": "Mint Number", "value": "1" } ], "balance": 1, "finalBalance": 1, "transferFees": false } ] }

3. Get NFTs by blockchain

Request Endpoint: reference

GET /api/wallets/nonfungibles
ParameterParam TypeDescriptionData TypeMandatory
secretTypeQueryThe blockchain to filter and retrieve NFTs byString

Example Request

GET https://api-wallet-sandbox.venly.io/api/wallets/nonfungibles?secretType=ETHEREUM

Response Body

{ "success": true, "result": [ { "id": "36", "name": "My first NFT", "description": "Venly", "imageUrl": "https://cdn.simplehash.com/assets/bd615a8b9794af04d85d1e8b670efa1d8693c5db44fceb0c08635026d8391c50.png", "imagePreviewUrl": "https://lh3.googleusercontent.com/bmoIbpwC61Fzti43tCrO2I8ylJB67ly7JOwER5U8qxQBUyFfvJdesnQUwdSPULkwEp2uocvcU1XSJGHroy6q74M27WybaGRqx20", "imageThumbnailUrl": "https://lh3.googleusercontent.com/bmoIbpwC61Fzti43tCrO2I8ylJB67ly7JOwER5U8qxQBUyFfvJdesnQUwdSPULkwEp2uocvcU1XSJGHroy6q74M27WybaGRqx20=s250", "animationUrls": [], "fungible": false, "contract": { "name": "Burn NFT Collection", "description": "Sample description", "address": "0x86b16217e6df213aa9de167a11b009c4740a8c8c", "symbol": "BUNFCO", "media": [ { "type": "image", "value": "https://lh3.googleusercontent.com/WH-UcOGJ_6bTQJNPHQY3tMU2DieftTDVuomxWT12grRECKimext1PAIgVMqRogtezktTXD75CdU5xdsxo18s671m-iumkLD_VVw" } ], "type": "ERC_1155", "verified": false, "premium": false, "categories": [], "imageUrl": "https://lh3.googleusercontent.com/WH-UcOGJ_6bTQJNPHQY3tMU2DieftTDVuomxWT12grRECKimext1PAIgVMqRogtezktTXD75CdU5xdsxo18s671m-iumkLD_VVw" }, "attributes": [ { "type": "property", "name": "Token Type ID", "value": "34" } ], "balance": 1, "finalBalance": 1, "transferFees": false }, { "id": "35", "name": "My first NFT", "description": "Venly", "imageUrl": "https://cdn.simplehash.com/assets/bd615a8b9794af04d85d1e8b670efa1d8693c5db44fceb0c08635026d8391c50.png", "imagePreviewUrl": "https://lh3.googleusercontent.com/bmoIbpwC61Fzti43tCrO2I8ylJB67ly7JOwER5U8qxQBUyFfvJdesnQUwdSPULkwEp2uocvcU1XSJGHroy6q74M27WybaGRqx20", "imageThumbnailUrl": "https://lh3.googleusercontent.com/bmoIbpwC61Fzti43tCrO2I8ylJB67ly7JOwER5U8qxQBUyFfvJdesnQUwdSPULkwEp2uocvcU1XSJGHroy6q74M27WybaGRqx20=s250", "animationUrls": [], "fungible": false, "contract": { "name": "Burn NFT Collection", "description": "Sample description", "address": "0x86b16217e6df213aa9de167a11b009c4740a8c8c", "symbol": "BUNFCO", "media": [ { "type": "image", "value": "https://lh3.googleusercontent.com/WH-UcOGJ_6bTQJNPHQY3tMU2DieftTDVuomxWT12grRECKimext1PAIgVMqRogtezktTXD75CdU5xdsxo18s671m-iumkLD_VVw" } ], "type": "ERC_1155", "verified": false, "premium": false, "categories": [], "imageUrl": "https://lh3.googleusercontent.com/WH-UcOGJ_6bTQJNPHQY3tMU2DieftTDVuomxWT12grRECKimext1PAIgVMqRogtezktTXD75CdU5xdsxo18s671m-iumkLD_VVw" }, "attributes": [ { "type": "property", "name": "Token Type ID", "value": "34" } ], "balance": 1, "finalBalance": 1, "transferFees": false }, { "id": "1", "name": "My first NFT", "description": "Venly", "imageUrl": "https://cdn.simplehash.com/assets/bd615a8b9794af04d85d1e8b670efa1d8693c5db44fceb0c08635026d8391c50.png", "imagePreviewUrl": "https://lh3.googleusercontent.com/bmoIbpwC61Fzti43tCrO2I8ylJB67ly7JOwER5U8qxQBUyFfvJdesnQUwdSPULkwEp2uocvcU1XSJGHroy6q74M27WybaGRqx20", "imageThumbnailUrl": "https://lh3.googleusercontent.com/bmoIbpwC61Fzti43tCrO2I8ylJB67ly7JOwER5U8qxQBUyFfvJdesnQUwdSPULkwEp2uocvcU1XSJGHroy6q74M27WybaGRqx20=s250", "animationUrls": [], "fungible": true, "contract": { "name": "Burn NFT Collection", "description": "Sample description", "address": "0x86b16217e6df213aa9de167a11b009c4740a8c8c", "symbol": "BUNFCO", "media": [ { "type": "image", "value": "https://lh3.googleusercontent.com/WH-UcOGJ_6bTQJNPHQY3tMU2DieftTDVuomxWT12grRECKimext1PAIgVMqRogtezktTXD75CdU5xdsxo18s671m-iumkLD_VVw" } ], "type": "ERC_1155", "verified": false, "premium": false, "categories": [], "imageUrl": "https://lh3.googleusercontent.com/WH-UcOGJ_6bTQJNPHQY3tMU2DieftTDVuomxWT12grRECKimext1PAIgVMqRogtezktTXD75CdU5xdsxo18s671m-iumkLD_VVw" }, "attributes": [ { "type": "property", "name": "Token Type ID", "value": "1" } ], "balance": 10, "finalBalance": 10, "transferFees": false }, { "id": "6", "name": "My first NFT", "description": "Venly", "imageUrl": "https://cdn.simplehash.com/assets/bd615a8b9794af04d85d1e8b670efa1d8693c5db44fceb0c08635026d8391c50.png", "imagePreviewUrl": "https://lh3.googleusercontent.com/bmoIbpwC61Fzti43tCrO2I8ylJB67ly7JOwER5U8qxQBUyFfvJdesnQUwdSPULkwEp2uocvcU1XSJGHroy6q74M27WybaGRqx20", "imageThumbnailUrl": "https://lh3.googleusercontent.com/bmoIbpwC61Fzti43tCrO2I8ylJB67ly7JOwER5U8qxQBUyFfvJdesnQUwdSPULkwEp2uocvcU1XSJGHroy6q74M27WybaGRqx20=s250", "animationUrls": [], "fungible": false, "contract": { "name": "My first collection", "description": "Sample description", "address": "0x4df3e0285df213d0516bdbd495f0593f8b6ec31a", "symbol": "MYFICO", "media": [ { "type": "image", "value": "https://lh3.googleusercontent.com/WH-UcOGJ_6bTQJNPHQY3tMU2DieftTDVuomxWT12grRECKimext1PAIgVMqRogtezktTXD75CdU5xdsxo18s671m-iumkLD_VVw" } ], "type": "ERC_1155", "verified": false, "premium": false, "categories": [], "imageUrl": "https://lh3.googleusercontent.com/WH-UcOGJ_6bTQJNPHQY3tMU2DieftTDVuomxWT12grRECKimext1PAIgVMqRogtezktTXD75CdU5xdsxo18s671m-iumkLD_VVw" }, "attributes": [ { "type": "property", "name": "Token Type ID", "value": "1" } ], "balance": 1, "finalBalance": 1, "transferFees": false }, { "id": "5", "name": "My first NFT", "description": "Venly", "imageUrl": "https://cdn.simplehash.com/assets/bd615a8b9794af04d85d1e8b670efa1d8693c5db44fceb0c08635026d8391c50.png", "imagePreviewUrl": "https://lh3.googleusercontent.com/bmoIbpwC61Fzti43tCrO2I8ylJB67ly7JOwER5U8qxQBUyFfvJdesnQUwdSPULkwEp2uocvcU1XSJGHroy6q74M27WybaGRqx20", "imageThumbnailUrl": "https://lh3.googleusercontent.com/bmoIbpwC61Fzti43tCrO2I8ylJB67ly7JOwER5U8qxQBUyFfvJdesnQUwdSPULkwEp2uocvcU1XSJGHroy6q74M27WybaGRqx20=s250", "animationUrls": [], "fungible": false, "contract": { "name": "My first collection", "description": "Sample description", "address": "0x4df3e0285df213d0516bdbd495f0593f8b6ec31a", "symbol": "MYFICO", "media": [ { "type": "image", "value": "https://lh3.googleusercontent.com/WH-UcOGJ_6bTQJNPHQY3tMU2DieftTDVuomxWT12grRECKimext1PAIgVMqRogtezktTXD75CdU5xdsxo18s671m-iumkLD_VVw" } ], "type": "ERC_1155", "verified": false, "premium": false, "categories": [], "imageUrl": "https://lh3.googleusercontent.com/WH-UcOGJ_6bTQJNPHQY3tMU2DieftTDVuomxWT12grRECKimext1PAIgVMqRogtezktTXD75CdU5xdsxo18s671m-iumkLD_VVw" }, "attributes": [ { "type": "property", "name": "Token Type ID", "value": "1" }, { "type": "property", "name": "Mint Number", "value": "4" } ], "balance": 1, "finalBalance": 1, "transferFees": false }, { "id": "4", "name": "My first NFT", "description": "Venly", "imageUrl": "https://cdn.simplehash.com/assets/bd615a8b9794af04d85d1e8b670efa1d8693c5db44fceb0c08635026d8391c50.png", "imagePreviewUrl": "https://lh3.googleusercontent.com/bmoIbpwC61Fzti43tCrO2I8ylJB67ly7JOwER5U8qxQBUyFfvJdesnQUwdSPULkwEp2uocvcU1XSJGHroy6q74M27WybaGRqx20", "imageThumbnailUrl": "https://lh3.googleusercontent.com/bmoIbpwC61Fzti43tCrO2I8ylJB67ly7JOwER5U8qxQBUyFfvJdesnQUwdSPULkwEp2uocvcU1XSJGHroy6q74M27WybaGRqx20=s250", "animationUrls": [], "fungible": false, "contract": { "name": "My first collection", "description": "Sample description", "address": "0x4df3e0285df213d0516bdbd495f0593f8b6ec31a", "symbol": "MYFICO", "media": [ { "type": "image", "value": "https://lh3.googleusercontent.com/WH-UcOGJ_6bTQJNPHQY3tMU2DieftTDVuomxWT12grRECKimext1PAIgVMqRogtezktTXD75CdU5xdsxo18s671m-iumkLD_VVw" } ], "type": "ERC_1155", "verified": false, "premium": false, "categories": [], "imageUrl": "https://lh3.googleusercontent.com/WH-UcOGJ_6bTQJNPHQY3tMU2DieftTDVuomxWT12grRECKimext1PAIgVMqRogtezktTXD75CdU5xdsxo18s671m-iumkLD_VVw" }, "attributes": [ { "type": "property", "name": "Token Type ID", "value": "1" }, { "type": "property", "name": "Mint Number", "value": "3" } ], "balance": 1, "finalBalance": 1, "transferFees": false }, { "id": "3", "name": "My first NFT", "description": "Venly", "imageUrl": "https://cdn.simplehash.com/assets/bd615a8b9794af04d85d1e8b670efa1d8693c5db44fceb0c08635026d8391c50.png", "imagePreviewUrl": "https://lh3.googleusercontent.com/bmoIbpwC61Fzti43tCrO2I8ylJB67ly7JOwER5U8qxQBUyFfvJdesnQUwdSPULkwEp2uocvcU1XSJGHroy6q74M27WybaGRqx20", "imageThumbnailUrl": "https://lh3.googleusercontent.com/bmoIbpwC61Fzti43tCrO2I8ylJB67ly7JOwER5U8qxQBUyFfvJdesnQUwdSPULkwEp2uocvcU1XSJGHroy6q74M27WybaGRqx20=s250", "animationUrls": [], "fungible": false, "contract": { "name": "My first collection", "description": "Sample description", "address": "0x4df3e0285df213d0516bdbd495f0593f8b6ec31a", "symbol": "MYFICO", "media": [ { "type": "image", "value": "https://lh3.googleusercontent.com/WH-UcOGJ_6bTQJNPHQY3tMU2DieftTDVuomxWT12grRECKimext1PAIgVMqRogtezktTXD75CdU5xdsxo18s671m-iumkLD_VVw" } ], "type": "ERC_1155", "verified": false, "premium": false, "categories": [], "imageUrl": "https://lh3.googleusercontent.com/WH-UcOGJ_6bTQJNPHQY3tMU2DieftTDVuomxWT12grRECKimext1PAIgVMqRogtezktTXD75CdU5xdsxo18s671m-iumkLD_VVw" }, "attributes": [ { "type": "property", "name": "Token Type ID", "value": "1" }, { "type": "property", "name": "Mint Number", "value": "2" } ], "balance": 1, "finalBalance": 1, "transferFees": false }, { "id": "2", "name": "My first NFT", "description": "Venly", "imageUrl": "https://cdn.simplehash.com/assets/bd615a8b9794af04d85d1e8b670efa1d8693c5db44fceb0c08635026d8391c50.png", "imagePreviewUrl": "https://lh3.googleusercontent.com/bmoIbpwC61Fzti43tCrO2I8ylJB67ly7JOwER5U8qxQBUyFfvJdesnQUwdSPULkwEp2uocvcU1XSJGHroy6q74M27WybaGRqx20", "imageThumbnailUrl": "https://lh3.googleusercontent.com/bmoIbpwC61Fzti43tCrO2I8ylJB67ly7JOwER5U8qxQBUyFfvJdesnQUwdSPULkwEp2uocvcU1XSJGHroy6q74M27WybaGRqx20=s250", "animationUrls": [], "fungible": false, "contract": { "name": "My first collection", "description": "Sample description", "address": "0x4df3e0285df213d0516bdbd495f0593f8b6ec31a", "symbol": "MYFICO", "media": [ { "type": "image", "value": "https://lh3.googleusercontent.com/WH-UcOGJ_6bTQJNPHQY3tMU2DieftTDVuomxWT12grRECKimext1PAIgVMqRogtezktTXD75CdU5xdsxo18s671m-iumkLD_VVw" } ], "type": "ERC_1155", "verified": false, "premium": false, "categories": [], "imageUrl": "https://lh3.googleusercontent.com/WH-UcOGJ_6bTQJNPHQY3tMU2DieftTDVuomxWT12grRECKimext1PAIgVMqRogtezktTXD75CdU5xdsxo18s671m-iumkLD_VVw" }, "attributes": [ { "type": "property", "name": "Token Type ID", "value": "1" }, { "type": "property", "name": "Mint Number", "value": "1" } ], "balance": 1, "finalBalance": 1, "transferFees": false } ] }

4. Get NFTs by blockchain, contract address, and token Id

Request Endpoint: reference

GET /api/nonfungibles/{secretType}/{contractAddress}/{tokenId}
ParameterParam TypeDescriptionData TypeMandatory
{secretType}PathIndication on which chain the balance should be fetchedString
{contractAddress}PathThe contract address of the NFTString
{tokenId}PathThe token ID of the NFTString

Response Body

{ "success": true, "result": { "id": "36", "name": "My first NFT", "description": "Venly", "imageUrl": "https://cdn.simplehash.com/assets/bd615a8b9794af04d85d1e8b670efa1d8693c5db44fceb0c08635026d8391c50.png", "imagePreviewUrl": "https://lh3.googleusercontent.com/bmoIbpwC61Fzti43tCrO2I8ylJB67ly7JOwER5U8qxQBUyFfvJdesnQUwdSPULkwEp2uocvcU1XSJGHroy6q74M27WybaGRqx20", "imageThumbnailUrl": "https://lh3.googleusercontent.com/bmoIbpwC61Fzti43tCrO2I8ylJB67ly7JOwER5U8qxQBUyFfvJdesnQUwdSPULkwEp2uocvcU1XSJGHroy6q74M27WybaGRqx20=s250", "animationUrls": [], "fungible": false, "contract": { "name": "Burn NFT Collection", "description": "Sample description", "address": "0x86b16217e6df213aa9de167a11b009c4740a8c8c", "symbol": "BUNFCO", "media": [ { "type": "image", "value": "https://lh3.googleusercontent.com/WH-UcOGJ_6bTQJNPHQY3tMU2DieftTDVuomxWT12grRECKimext1PAIgVMqRogtezktTXD75CdU5xdsxo18s671m-iumkLD_VVw" } ], "type": "ERC_1155", "verified": false, "premium": false, "categories": [], "imageUrl": "https://lh3.googleusercontent.com/WH-UcOGJ_6bTQJNPHQY3tMU2DieftTDVuomxWT12grRECKimext1PAIgVMqRogtezktTXD75CdU5xdsxo18s671m-iumkLD_VVw" }, "attributes": [ { "type": "property", "name": "Token Type ID", "value": "34" } ], "transferFees": false } }

5. Get wallets that contain specific NFTs

Request Endpoint: reference

GET /api/nonfungibles/{secretType}/{contractAddress}/{tokenId}/wallets
ParameterParam TypeDescriptionData TypeMandatory
{secretType}PathIndication on which chain the balance should be fetchedString
{contractAddress}PathThe contract address of the NFTString
{tokenId}PathThe token ID of the NFTString

Did this page help you?