These docs are for v2.0. Click to read the latest docs for v3.0.

Get NFTs by any wallet

Retrieve all tokens that are stored on a wallet address.

This API endpoint allows you to fetch a comprehensive list of all Non-Fungible Tokens (NFTs) held within a specific wallet. It requires two mandatory parameters: the blockchain network and the wallet address. Optionally, you can filter NFTs by supplying the contract address in the query.

Request Endpoint: reference

 GET /api/wallets/{secretType}/{walletAddress}/nonfungibles
ParameterParam TypeDescriptionTypeRequired
{secretType}PathBlockchain to filter byString
{walletAddress}PathWallet address to get NFTsString
contract-addressesQueryWhen set, the result will only contain tokens of these NFT contract addresses. Multiple values can be set.Array of strings

Example Request:

GET https://api-wallet.venly.io/api/wallets/HEDERA/0.0.18402479/nonfungibles

Response Body:

{
    "success": true,
    "result": {
        "id": "25",
        "name": "Agumon",
        "description": "A Reptile Digimon with an appearance resembling a small dinosaur, it has grown and become able to walk on two legs. Its strength is weak as it is still in the process of growing, but it has a fearless and rather ferocious personality. Hard, sharp claws grow from both its hands and feet, and their power is displayed in battle. It also foreshadows an evolution into a great and powerful Digimon. Its Special Move is spitting a fiery breath from its mouth to attack the opponent (Baby Flame).",
        "url": "https://wikimon.net/Agumon",
        "backgroundColor": null,
        "imageUrl": "https://wikimon.net/images/6/67/Agumon_cs.jpg",
        "imagePreviewUrl": "https://wikimon.net/images/6/67/Agumon_cs.jpg",
        "imageThumbnailUrl": "https://wikimon.net/images/6/67/Agumon_cs.jpg",
        "animationUrl": null,
        "animationUrls": [],
        "fungible": false,
        "contract": {
            "name": "Digimon",
            "description": null,
            "address": "0.0.2850147",
            "symbol": "DGM",
            "media": null,
            "type": "NON_FUNGIBLE_UNIQUE",
            "verified": false,
            "premium": false,
            "categories": [],
            "url": null,
            "imageUrl": null
        },
        "attributes": [
            {
                "type": "property",
                "name": "Level",
                "value": "Child",
                "displayType": null,
                "traitCount": null,
                "maxValue": null
            },
            {
                "type": "property",
                "name": "Type",
                "value": "Reptile",
                "displayType": null,
                "traitCount": null,
                "maxValue": null
            },
            {
                "type": "property",
                "name": "Attribute",
                "value": "Vaccine",
                "displayType": null,
                "traitCount": null,
                "maxValue": null
            },
            {
                "type": "stat",
                "name": "Min. weight",
                "value": "15",
                "displayType": "number",
                "traitCount": null,
                "maxValue": 20
            },
            {
                "type": "system",
                "name": "tokenTypeId",
                "value": "1",
                "displayType": null,
                "traitCount": null,
                "maxValue": null
            }
        ]
    }
}