Get TRC721 tokenId Transfer List

1. Overview & Typical Use

Returns the transfer record list for a specific tokenId within a TRC721 contract.

GET /api/trc721/transfers

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

Parameter	Type	Required	Default	Description
`contract`	string	Yes	—	TRC721 contract address
`tokenId`	string	Yes	—	TRC721 token ID (numeric string)
`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 match count	—
`rangeTotal`	integer	Required	Total count within range	—
`token_transfers`	array	Required	Transfer record array; see below	—
`token_id_info`	object	Optional	tokenId info (contains `tokenIdName`, `tokenIdImage`)	—
`contractMap`	object	Optional	Address → whether it is a contract mapping	—
`contractInfo`	object	Optional	Contract address → tag info (value schema below)	—

token_transfers[] elements

Field	Type	Required	Description	Unit/Precision
`transaction_id`	string	Required	Transaction hash	—
`block_ts`	integer	Required	Block time	Millisecond timestamp ms
`block`	integer	Required	Block height	—
`from_address`	string	Required	Sender address	—
`to_address`	string	Required	Recipient address	—
`contract_address`	string	Required	Contract address	—
`token_id`	string	Required	NFT token ID	—
`event_type`	string	Required	Event type (e.g. `Transfer`)	—
`confirmed`	boolean	Required	Whether confirmed	—
`contractRet`	string	Required	Contract execution result (e.g. `SUCCESS`)	—
`finalResult`	string	Required	Final result (e.g. `SUCCESS`)	—
`revert`	boolean	Required	Whether reverted	—
`tokenInfo`	object	Required	Token metadata (value schema below)	—
`from_address_tag`	string	Required	Sender address tag (empty string when no tag)	—
`to_address_tag`	string	Required	Recipient address tag (empty string when no tag)	—

contractInfo[<addr>] object schema (8 fields):

Field	Type	Required	Description
`tag1`	string	Required	Primary label (project name / contract name / exchange name)
`tag1Url`	string	Required	URL of the primary label (may be an empty string)
`name`	string	Required	Formal contract / project name
`isToken`	boolean	Required	Whether it is a token contract (`true` / `false`)
`vip`	boolean	Required	Whether it is a VIP entity (`true` / `false`)
`risk`	boolean \| string	Required	Risk label; most endpoints return boolean, some return a string risk type (`blacklist` / `fraud`, etc.)
`publicTagDesc`	string	Required	Public label description; empty string for most accounts
`publicTag`	string	Optional	Public label (e.g. `"USDT Token"` / `"Binance"`); returned only for well-known entities or certain endpoints

tokenInfo object schema (9 common fields + issuerAddr):

Field	Type	Required	Description	Unit/Precision
`tokenId`	string	Required	Token contract address (Base58); TRX placeholder is `_`	—
`tokenAbbr`	string	Required	Token abbreviation (e.g. `USDT` / `TRX`)	—
`tokenName`	string	Required	Token name	—
`tokenDecimal`	integer	Required	Decimal precision (required to convert the `amount` field)	—
`tokenCanShow`	integer	Required	Whether displayable (`1` yes / `0` no)	—
`tokenType`	string	Required	Token type (`trc10` / `trc20` / `trc721` / `trc1155`)	—
`tokenLogo`	string	Required	Token logo URL	—
`tokenLevel`	string	Required	Token level: `0` (UNKNOWN), `1` (NEUTRAL), `2` (OK), `3` (SUSPICIOUS), `4` (UNSAFE)	—
`vip`	boolean	Required	Whether it is a VIP token	—
`issuerAddr`	string	Required	Issuer address (Base58)	—

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

Both contract and tokenId are required: omitting either returns {"message": "some parameters are missing"}.
Empty result is not an error: no matches returns 200 + token_transfers: [].