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

Get wallets by any NFT

Retrieve the wallet that holds/owns a specific 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
ParameterParam TypeDescriptionTypeRequired
{secretType}PathBlockchain to filter byString
{contractAddress}PathThe contract address of the specific NFTString
{tokenId}PathThe token ID of the NFTString

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
        }
    ]
}