Get TRC1155 tokenId Holdings

1. Overview & Typical Use

Returns the holder list for a specific tokenId within a TRC1155 contract, along with each holder’s holding details.

Typical use: querying the holder distribution and holding-amount ranking for a specific TRC1155 NFT.
When not to use: to query all tokenId inventory for a TRC1155 contract use “Get TRC1155 Inventory”.
Both contract and tokenId are required parameters.
limit max is 50; start + limit ≤ 10000.

GET /api/trc1155/token/inventory

For Base URL and authentication, see Common Network & Authentication.

Parameter	Type	Required	Default	Description
`contract`	string	Yes	—	TRC1155 contract address
`tokenId`	string	Yes	—	Token ID within the TRC1155 contract
`start`	integer	No	`0`	Start offset; `start + limit ≤ 10000`
`limit`	integer	No	`20`	Page size, max 50

Top-level

Field	Type	Required	Description	Unit/Precision
`total`	integer	Required	Total number of holders	—
`rangeTotal`	integer	Required	Total count within the filter range	—
`page_size`	integer	Required	Number of records returned on the current page	—
`code`	integer	Required	Response status code; 200 = success	—
`data`	array	Required	Holdings record array; see below	—

data[] elements

Field	Type	Required	Description	Unit/Precision
`token_id`	string	Required	Token ID	—
`holder_count`	string	Required	Quantity held by this address	—
`owner_address`	string	Required	Holder address	—
`token_name`	string	Required	Token name	—
`token_description`	string	Optional	Token description	—
`token_image`	string	Optional	Token image URL (external link)	—
`token_imageInnerUrl`	string	Optional	Token image URL (site-cached)	—
`token_url`	string	Optional	Token metadata URL	—

For HTTP status codes, see Common Errors. Notes for this endpoint:

Both contract and tokenId are required: omitting either returns a missing-parameter error.
Empty result is not an error: no matches returns 200 + data: [], which is a normal response.