Get TRC10/TRX Transfer List

1. Overview & Typical Use

Returns the transfer list for TRC10 tokens or TRX. Supports multi-dimensional filtering by address, issuer, and time range.

Typical use: TRC10/TRX transfer history query, address inflow/outflow details.
When not to use: for TRC20/TRC721 transfers use “Get TRC20 & TRC721 Transfer List”; for TRC1155 transfers use “Get TRC1155 Transfer List”.
start + limit maximum is 10000; results beyond this limit are silently truncated.
limit maximum is 50.

GET /api/asset/transfer

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

Parameter	Type	Required	Default	Description
`start`	integer	No	`0`	Starting offset; `start + limit ≤ 10000`
`limit`	integer	No	`10`	Page size, max 50
`name`	string	No	—	Fill `trx` to query TRX transfers
`issueAddress`	string	No	—	TRC10 issuer address
`address`	string	No	—	Address to query
`relatedAddress`	string	No	—	Same as the `address` parameter
`start_timestamp`	integer	No	—	Start time (millisecond timestamp)
`end_timestamp`	integer	No	—	End time, must be >= `start_timestamp` (millisecond timestamp)
`confirm`	string	No	—	Confirmation status: `0` solidified, `1` unsolidified; omit to return all

Top-level

Field	Type	Required	Description	Unit/Precision
`total`	integer	Required	Total matched records, capped at 10000	—
`rangeTotal`	integer	Required	Actual total within the filtered range	—
`Data`	array	Required	Transfer records array; see below (note capital D)	—
`contractMap`	object	Optional	Address → whether it is a contract	—
`contractInfo`	object	Optional	Contract address → label info	—
`normalAddressInfo`	object	Optional	Address → risk info	—

Data[] elements

Field	Type	Required	Description	Unit/Precision
`blockId`	integer	Required	Block height	—
`transactionHash`	string	Required	Transaction hash	—
`timestamp`	integer	Required	Transaction time	Millisecond timestamp
`transferFromAddress`	string	Required	Sender address	—
`transferFromAddressTag`	string	Optional	Sender address label	—
`transferToAddress`	string	Required	Recipient address	—
`transferToAddressTag`	string	Optional	Recipient address label	—
`amount`	integer	Required	Transfer amount (raw value); requires token precision to convert	raw
`tokenName`	string	Required	Token name; `_` for TRX	—
`finalResult`	string	Required	Final execution result	—
`contractRet`	string	Required	Contract execution result	—
`confirmed`	boolean	Required	Whether solidified	—
`cheatStatus`	boolean	Required	Whether a fraudulent transaction	—
`tokenInfo`	object	Optional	Token metadata	—
`fromAddressIsContract`	boolean	Required	Whether the sender is a contract	—
`toAddressIsContract`	boolean	Required	Whether the recipient is a contract	—
`riskTransaction`	boolean	Required	Whether a risky transaction	—

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

Pagination limit: when start + limit exceeds 10000, results are silently truncated without error.
Empty result is not an error: no matching records returns 200 + Data: [], which is a normal response.