Get wallets by any 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

HTTP

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

Parameter	Param Type	Description	Type	Required
{secretType}	Path	Blockchain to filter by	String	✅
{contractAddress}	Path	The contract address of the specific NFT	String	✅
{tokenId}	Path	The token ID of the NFT	String	✅

Example Request:

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

Response Body:

JSON

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