Get TRC721 Inventory

1. Overview & Typical Use

Returns the token inventory list for a specified TRC721 contract, including the holder address, name, description, and image for each tokenId.

Typical use: TRC721 NFT collection browsing, inventory display, NFT holder lookup.
When not to use: for TRC721 transfer records use “Get TRC721 tokenId Transfer List”; for TRC1155 inventory use “Get TRC1155 Inventory”.
contract is a required parameter.
total is capped at 10000; rangeTotal reflects the true total count.

GET /api/trc721/token

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

Parameter	Type	Required	Default	Description
`contract`	string	Yes	—	TRC721 contract address
`tokenId`	string	No	—	Token ID within the TRC721 contract
`start`	integer	No	`0`	Start offset; `start + limit ≤ 10000`
`limit`	integer	No	`20`	Page size, max 50
`ownerAddress`	string	No	—	TRC721 token holder address
`sort`	string	No	—	Sort: `tokenId` (ascending), `-tokenId` (descending)

Top-level

Field	Type	Required	Description	Unit/Precision
`total`	integer	Required	Match count, capped at 10000	—
`rangeTotal`	integer	Required	True total count	—
`page_size`	integer	Required	Number of records returned on the current page	—
`code`	integer	Required	Response status code; 200 = success	—
`data`	array	Required	Inventory record array; see below	—
`contractMap`	object	Optional	Address → whether it is a contract mapping	—

data[] elements

Field	Type	Required	Description	Unit/Precision
`token_id`	string	Required	Token ID	—
`owner_address`	string	Required	Holder address	—
`owner_address_tag`	string	Optional	Holder address tag	—
`owner_address_tag_logo`	string	Optional	Holder address tag logo URL	—
`token_name`	string	Optional	Token name	—
`token_description`	string	Optional	Token description	—
`token_image`	string	Optional	Token image URL (external link)	—
`token_url`	string	Optional	Token metadata URL	—
`token_imageInnerUrl`	string	Optional	Token image URL (site-cached)	—
`latest_transfer_timestamp`	integer	Required	Most recent transfer time	Millisecond timestamp ms

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

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