Get events by contract address

get

https://api.shasta.trongrid.io/v1/contracts/{address}/events

Recipes

👂

Listen to Contract Events

Open Recipe

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Returns

Field	Type	Description
data[i].block_number	Integer	The block number
data[i].block_timestamp	Long	The block timestamp. (Unit: millisecond)
data[i].caller_contract_address	String	Same as data.[0].contract_address for backward compatibility.
data[i].contract_address	String	The address of the contract that emitted the event.
data[i].event_index	String	The event's index within the transaction's event log.
data[i].event_name	String	The event name
data[i].event	String	The event signature used to parse indexed and non-indexed parameters. (e.g., `Transfer(address,address,uint256)`)
data[i].transaction_id	String	Transaction hash.
data[i].result	map<string, string>	The event's parameters, including both indexed and non-indexed parameters.
data[i].result_type	map<string, string>	The type of parameter
data[i]._unconfirmed	Boolean	Whether the transaction is unconfirmed. `true` means unconfirmed.
success	Boolean	Whether the request was successful.
meta.page_size	Integer	The number of items returned on the current page.
meta.at	Long	The response timestamp. (Unit: millisecond)

Path Params

address

string

required

Contract address in base58 or hex format.
Example: TG3XXyExBkPp9nzdajDZsozEu4BkaSJozs

Query Params

event_name

string

Defaults to Transfer

The event name to filter by.
Example: Transfer

block_number

int64

The specific block number to query.
Example: 61840405

only_unconfirmed

boolean

Set to true to return only confirmed events; set to false to return both confirmed and unconfirmed events. Cannot be used simultaneously with only_confirmed.

only_confirmed

boolean

Set to true to return only confirmed events; set to false to return both confirmed and unconfirmed events. Cannot be used simultaneously with only_unconfirmed.

min_timestamp

date-time

The minimum block timestamp to filter by. (Unit: milliseconds, Default: 0)

max_timestamp

date-time

The maximum block timestamp to filter by. (Unit: milliseconds, Default: current time)

order_by

string

Specifies the sort order. block_timestamp,asc | block_timestamp,desc (default).

fingerprint

string

The fingerprint for pagination, obtained from the meta.fingerprint field of a previous response. Note: When using fingerprint, all other parameters must remain the same.

limit

int32

The maximum number of events to return per page. (Default: 20, Max:200)

Responses

200200

400400