Get TRX & TRC10 Transfer List

1. Overview & Typical Use

Query TRX and TRC10 token transfer records filtered by address, time, token, and other conditions, with pagination support.

Typical use: querying an address’s TRX and TRC10 token transfer history, token transaction monitoring.
When not to use: for TRC20 / TRC721 transfers use “Get TRC20 & TRC721 Transfer List”; for TRC1155 transfers use “Get TRC1155 Transfer List”.

GET /api/transfer

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

Parameter	Type	Required	Default	Description
`start`	integer	No	`0`	Start offset; `start + limit ≤ 10000`, excess is silently handled
`limit`	integer	No	`10`	Page size, max 50 (excess is silently truncated)
`sort`	string	No	`-timestamp`	Sort order
`count`	boolean	No	`false`	Whether to return the total transfer count
`address`	string	No	—	Address filter
`fromAddress`	string	No	—	Sender address
`toAddress`	string	No	—	Recipient address
`tokens`	string	No	—	Filter by specified tokens
`token`	string	No	—	Single token filter
`block`	integer	No	—	Filter by block number
`start_timestamp`	integer	No	—	Start time, ms timestamp
`end_timestamp`	integer	No	—	End time, ms timestamp
`direction`	string	No	`all`	Transfer direction: `in`, `out`, `all`
`confirm`	string	No	—	Confirmation status: `0` confirmed / `1` unconfirmed / empty all
`filterTokenValue`	integer	No	—	Filter by token amount threshold

Top-level

Field	Type	Required	Description	Unit/Precision
`total`	integer	Required	Total match count (capped at 10000, used for pagination)	—
`rangeTotal`	integer	Required	Total count within the filter range	—
`data`	array	Required	Transfer record array; see below	—
`contractMap`	object	Optional	Address → whether it is a contract mapping	—
`contractInfo`	object	Optional	Contract address → label information mapping (value schema below)	—
`normalAddressInfo`	object	Optional	Non-contract address → risk information mapping; each address value observed to contain only `risk` (boolean), no other sub-fields	—

data[] elements

Field	Type	Required	Description	Unit/Precision
`id`	string	Required	Record ID (typically an empty string)	—
`transactionHash`	string	Required	Transaction hash	—
`block`	integer	Required	Block height	—
`timestamp`	integer	Required	Block time	ms timestamp
`transferFromAddress`	string	Required	Sender address	—
`transferToAddress`	string	Required	Recipient address	—
`amount`	integer	Required	Transfer amount (raw value)	Use `tokenInfo.tokenDecimal` to convert
`tokenName`	string	Required	Token name (`_` means TRX)	—
`confirmed`	boolean	Required	Whether confirmed	—
`data`	string	Required	Raw transaction data (typically empty string)	—
`contractRet`	string	Required	Contract execution result	—
`revert`	boolean	Required	Whether reverted	—
`tokenInfo`	object	Required	Token metadata (value schema below)	—
`cheatStatus`	boolean	Required	Whether this is a fraudulent transaction	—
`riskTransaction`	boolean	Required	Risk transaction flag	—
`transferToTag`	string	Optional	Recipient address tag (present when tagged; key absent when no tag)	—
`transferFromTag`	string	Optional	Sender address tag (present when tagged; key absent 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):

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	—

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

Parameter violations are not reported as errors: limit > 50, start + limit > 10000, etc. are silently truncated/capped and return 200.
Empty result is not an error: no matches returns 200 + data: [], which is a normal response.