Retrieve wallets containing an NFT

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 holds of the requested (N)FT. Note that this can only be greater than 0 for a fungible token.

Request Endpoint: reference

 GET /api/nonfungibles/{secretType}/{contractAddress}/{tokenId}/wallets

Example Request:

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

Response Body:

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