Get owners by an NFT

This endpoint returns a list of owners for an ERC1155 NFT. The NFTs are sorted by account_address with ascending direction.

API Endpoint

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

method_path:/api/v2/asset/owners/{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{0x28472a58a490c5e09a238847f66a68a47cc76f0f}querytruestring
token_idThe NFT token ID. Can be in Hex or in Number defaultValue{1}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«OwnersModel »ICursor«OwnersModel »
  contentThe data contentarrayOwnersModel
    account_addressThe account address who owns the NFTstring
    amountThe quantity of the NFT the account ownsstring
  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": [
			{
				"account_address": "0xe525fae3fc6fbb23af05e54ff413613a6573cff2",
				"amount": "120"
			}
		],
		"next": "NS871DD6359B64187E",
		"total": 30000
	},
	"msg": ""
}