Get Trigger Transaction List

1. Overview & Typical Use

Returns the list of transactions that trigger smart contracts across the entire network, supporting time range filtering and pagination.

Typical use: network-wide contract transaction flow monitoring, contract call statistics for a specific time range, on-chain activity analysis.
When not to use: to query events for a specific contract use “Get Contract Events”; to query callers of a specific contract use “Get All Contract Callers”.

GET /api/contracts/trigger

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
`start_timestamp`	integer	No	—	Start time, millisecond timestamp
`end_timestamp`	integer	No	—	End time, millisecond timestamp

Top-level

Field	Type	Required	Description	Unit/Precision
`total`	integer	Required	Total hits (capped at 10000)	—
`rangeTotal`	integer	Required	Total trigger transactions in the time range	—
`data`	array	Required	Trigger transaction list	—
`contractMap`	object	Optional	Address → whether it is a contract	—
`contractInfo`	object	Optional	Contract address → label info	—

data[] element

Field	Type	Required	Description	Unit/Precision
`block`	integer	Required	Block height	—
`hash`	string	Required	Transaction hash	—
`timestamp`	integer	Required	Transaction time	millisecond timestamp
`ownerAddress`	string	Required	Transaction initiator address	—
`contractAddress`	string	Required	Target contract address	—
`callData`	string	Required	Call data (hexadecimal)	—
`callValue`	integer	Required	TRX value attached to the call	sun
`confirmed`	boolean	Required	Whether confirmed	—
`contractType`	string	Required	Contract type (e.g. `"IntendedLeaveEmpty"` is the trigger contract type identifier)	—
`result`	string	Required	Execution result (e.g. `"IntendedLeaveEmpty"` or `"SUCCESS"`)	—
`token`	string	Required	Token involved (may be empty)	—
`ownerAddressTag`	string	Optional	Initiator address label	—

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

start + limit exceeds 10000: silently truncated and returns 200; no error is raised.
limit exceeds 50: silently capped at 50.
Empty result is not an error: returns 200 + data: [] when no matches are found.