Get TRC1155 Transfer List

1. Overview & Typical Use

Queries TRC1155 token transfer records by contract, address, time, and other conditions, with pagination support.

Typical use: TRC1155 multi-token standard transfer monitoring, NFT transaction history queries.
When not to use: for TRC20/TRC721 transfers use “Get TRC20 & TRC721 Transfer List”; for TRX/TRC10 transfers use “Get TRX & TRC10 Transfer List”.

GET /api/token_trc1155/transfers

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

Parameter	Type	Required	Default	Description
`start`	integer	No	`0`	Start index (offset); `start + limit ≤ 10000`, violations silently handled
`limit`	integer	No	`10`	Items per page, max 50 (excess silently truncated)
`relatedAddress`	string	No	—	Account address; when specified, returns TRC1155 transfers for that address
`contract_address`	string	No	—	Contract address
`start_timestamp`	integer	No	—	Start time, ms timestamp
`end_timestamp`	integer	No	—	End time, ms timestamp
`block`	integer	No	—	Filter by block number
`direction`	string	No	`all`	Transfer direction: `in` (incoming), `out` (outgoing), `all` (both)
`confirm`	string	No	—	Confirmation status: `0` confirmed / `1` unconfirmed / empty all; can combine with comma e.g. `0,1`
`filterTokenValue`	integer	No	—	Filter by token amount threshold

Top-level

Field	Type	Required	Description	Unit/Precision
`total`	integer	Required	Number of hits (cap 10000, for pagination)	—
`rangeTotal`	integer	Required	Total count within the filtered range	—
`token_transfers`	array	Required	Transfer record array; see below	—
`contractMap`	object	Optional	Address → whether the address is a contract	—
`contractInfo`	object	Optional	Contract address → label information mapping (value schema below)	—

token_transfers[] elements

Field	Type	Required	Description	Unit/Precision
`transaction_id`	string	Required	Transaction hash	—
`block_ts`	integer	Required	Block time	ms timestamp
`block`	integer	Required	Block height	—
`from_address`	string	Required	Sender address (Base58, starts with T)	—
`to_address`	string	Required	Receiver address (Base58, starts with T)	—
`contract_address`	string	Required	Token contract address	—
`quant`	string	Required	Transfer quantity (raw string)	—
`approval_amount`	string	Required	Approval amount (string; `"0"` for non-Approval events)	—
`event_type`	string	Required	Event type: `Transfer` or `Approval`	—
`contract_type`	string	Required	Token type: `trc1155`	—
`token_id`	string	Required	TRC1155 token ID	—
`confirmed`	boolean	Required	Whether confirmed	—
`contractRet`	string	Required	Contract execution result	—
`finalResult`	string	Required	Final result	—
`tokenInfo`	object	Required	Token metadata (value schema below)	—
`from_address_tag`	object	Required	Sender address tag info; sub-fields see the `from_address_tag` object table below	—
`fromAddressIsContract`	boolean	Required	Whether the sender is a contract address	—
`to_address_tag`	object	Required	Receiver address tag info; sub-fields see the `to_address_tag` object table below	—
`toAddressIsContract`	boolean	Required	Whether the receiver is a contract address	—
`trigger_info`	object	Always	Contract call method and parameters; key always present, `null` when not a contract trigger; sub-fields see the `trigger_info` object table below	—
`revert`	boolean	Required	Whether reverted	—

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	—

from_address_tag object

Field	Type	Required	Description
`from_address_tag`	string	Required	Sender public tag text (empty string when no tag)
`from_address_tag_logo`	string	Required	Sender tag logo URL (empty string when no logo)

to_address_tag object

Field	Type	Required	Description
`to_address_tag`	string	Required	Receiver public tag text (empty string when no tag)
`to_address_tag_logo`	string	Required	Receiver tag logo URL (empty string when no logo)

trigger_info object (when not null)

Field	Type	Required	Description	Unit/Precision
`method`	string	Required	Method signature (e.g. `safeTransferFrom(address _from,address _to,uint256 _id,uint256 _value,bytes _data)`)	—
`methodName`	string	Required	Method name (e.g. `safeTransferFrom`)	—
`parameter`	object	Required	Parameter object; keys are parameter names (e.g. `_from`, `_to`, `_ids`, `_values`, `_data`), values are strings (depending on parameter type)	—
`data`	string	Required	Raw call data	hex
`contract_address`	string	Required	Called contract address	—
`call_value`	integer	Required	TRX amount sent with the call	sun

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

Invalid parameters do not cause errors: limit > 50, start + limit > 10000, etc. are silently truncated/capped and return 200 — do not rely on errors to detect parameter issues.
Empty result is not an error: no matches returns 200 + token_transfers: [] — this is a normal response.