Retrieve wallets containing an NFT

Retrieve all wallets that hold/own a specific NFT

GET https://api-wallet.venly.io/api/nonfungibles/{chain}/{contract}/{tokenId}/wallets

Retrieve all wallets that own a given (N)FT

Path Parameters

Name	Type	Description
chain*	String	the blockchain on which the NFT resides
contract*	String	The collection-contract of the NFT
tokenId*	String	The token id of the specific NFT

Query Parameters

Name	Type	Description
page	String	The page to be requested
size	String	The number of elements to include in the page

200: OK The list of wallets owning the NFT

{
    // Response
}

Usage

Use this API when you want to know who (a wallet) owns a specific NFT. As a result you will get all the wallet addresses that own this NFT.

Note that the result can be a list. This is the case for fungible tokens. A fungible token can be distributed across multiple owners. A "true" non-fungible token can only be owned by one wallet. In the latter case, only one result will be returned.

In the response you will also find the tokenBalance. This is the number of tokens that the respective wallet hold of the requested (N)FT. Note that this can only be greater than 0 for a fungible token.

Example

Request

https://api-wallet.venly.io/api/nonfungibles/MATIC/0xb3ccba9310e123e1d5b15b76bbc0165e410f492e/23/wallets

Response

{
    "success": true,
    "pagination": {
        "pageNumber": 0,
        "pageSize": 10,
        "numberOfPages": 1,
        "numberOfElements": 1,
        "hasNextPage": false,
        "hasPreviousPage": false
    },
    "result": [
        {
            "walletAddress": "0xb538acdcf1ded376f44edfeb5cf6a299314ea36a",
            "contractAddress": "0xb3ccba9310e123e1d5b15b76bbc0165e410f492e",
            "tokenBalance": 1
        }
    ]
}