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”.
contractis a required parameter.totalis capped at 10000;rangeTotalreflects the true total count.
2. Endpoint & Authentication
GET /api/trc721/token
For Base URL and authentication, see Common Network & Authentication.
3. Request
Fields
| 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) |
4. Response
Fields
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) | — |
token_level | string | Optional | Token level, returned when querying by tokenId or ownerAddress: 0 (UNKNOWN), 1 (NEUTRAL), 2 (OK), 3 (SUSPICIOUS), 4 (UNSAFE) | — |
latest_transfer_timestamp | integer | Required | Most recent transfer time | Millisecond timestamp ms |
5. Errors
For HTTP status codes, see Common Errors. Notes for this endpoint:
contractis required: omitting it returns a missing-parameter error.- Empty result is not an error: no matches returns
200+data: [], which is a normal response.
Last updated on: