Get NFT owners by contract

This endpoint returns a list of owners for an ERC721 NFT contract address. The NFTs are sorted by token_id with ascending direction.

API Endpoint

https://open-platform.nodereal.io/{apiKey}/nftscan

method_path:/api/v2/asset/collection/amount/{chain_name}

method_type:GET

Request:

ParametersDescriptionsQuery TypeRequiredData Typeschema
chain_nameName of the chain you’re querying. List of supported values: "eth" for Ethereum; "bnb" for BNB Smart Chain; "polygon" for Polygon; "moonbeam" for Moonbeam; "arbitrum" for Arbitrum One; "optimism" for Optimism; "platon" for PlatON; "avalanche" for Avalanche; "cronos" for Cronos; "fantom" for Fantom; "gnosis" for Gnosis;pathtrue
contract_addressThe NFT contract address defaultValue{0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d}querytruestring
cursorA cursor to retrieve the next pagequeryfalsestring
limitPage size. Defaults to 20, capped at 100queryfalseinteger(int32)

Response:

ParametersDescriptionsData Typeschema
codeResponse status code (200 means the request was successful, 4XX or 5XX means the request failed)integer(int32)integer(int32)
dataResponse dataICursor«NftOwnerAssetModel »ICursor«NftOwnerAssetModel »
  contentThe data contentarrayNftOwnerAssetModel
    contract_token_idThe token ID of the NFT in Hexstring
    ownerThe owner of the itemstring
    token_idThe token ID of the NFT in Numberstring
  nextThe next cursor to be supplied as a query param to retrieve the next pagestring
  totalThe total of the results matching the queryinteger(int64)
msgError message when request failsstring

Example:

{
    "code": 200,
    "data": {
        "content": [
            {
                "contract_token_id": "0x0000000000000000000000000000000000000000000000000000000000000001",
                "owner": "0x2e97778b97db81b62eb64103813e019f353537cd",
                "token_id": "1"
            }
        ],
        "next": "NS871DD6359B64187E",
        "total": 30000
    },
    "msg": ""
}