Account Holding Distribution

This endpoint returns NFT holding distribution statistics for an account address referring to NFTScan Portfolio.

API Endpoint

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

method_path:/api/v2/statistics/distribution/{account_address}/{chain_name}

method_type:GET

Request:

Parameters	Descriptions	Query Type	Required	Data Type
account_address	The account addressdefaultValue{0xca1257ade6f4fa6c6834fdc42e030be6c0f5a813}	path	true	string
chain_name	Name 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;	path	true	string
distribution_type	} defaultValue{volume}	query	false	string

Response:

Parameters	Descriptions	Data Type	schema
code	Response status code (200 means the request was successful, 4XX or 5XX means the request failed)	integer(int32)	integer(int32)
data	Response data	AccountHoldingDistributionModel	AccountHoldingDistributionModel
distribution	The NFT holding distribution	array	HoldingDistributionModel
contract	The contract address	string
name	The contract name	string
proportion	The proportion of holdings	string
value	The value(amount or volume)	number
total	The total volume or amount	integer(int64)
msg	Error message when request fails	string

Example:

{
	"code": 200,
	"data": {
		"distribution": "[{\"proportion\":\"74.63%\",\"contract\":\"0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d\",\"name\":\"BoredApeYachtClub\",\"value\":1868.1},{\"proportion\":\"14.20%\",\"contract\":\"0x60e4d786628fea6478f785a6d7e704777c86a7c6\",\"name\":\"MutantApeYachtClub\",\"value\":355.58},{\"proportion\":\"6.71%\",\"contract\":\"0xba30e5f9bb24caa003e9f2f0497ad287fdf95623\",\"name\":\"BoredApeKennelClub\",\"value\":167.877},{\"proportion\":\"4.06%\",\"contract\":\"0x34d85c9cdeb23fa97cb08333b511ac86e1c4e258\",\"name\":\"Otherdeed\",\"value\":101.75},{\"proportion\":\"0.29%\",\"contract\":\"0x764aeebcf425d56800ef2c84f2578689415a2daa\",\"name\":\"SewerPass\",\"value\":7.317},{\"proportion\":\"0.11%\",\"name\":\"other\",\"value\":2.6452}]",
		"total": 0
	},
	"msg": ""
}