通过合约地址获取事件

get

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

按合约地址列出该合约发出的全部事件——可按 event_name、时间区间、区块高度过滤。

相关资源

通过交易 ID 获取事件 —— 按交易查询事件
通过区块高度获取事件 —— 按区块查询
获取最新区块的事件 —— 查询最新区块中的事件
基于区块扫描的充值监听机制 —— Event 与交易 receipt 的关系

Path Params

address

string

required

^(?:T[1-9A-HJ-NP-Za-km-z]{33}|(?:0x)?41[0-9A-Fa-f]{40})(?![\s\S])

合约地址。（格式：Base58 或 Hex）。示例：TG3XXyExBkPp9nzdajDZsozEu4BkaSJozs

Query Params

event_name

string

按事件名称筛选。省略时不按事件名称过滤。

block_number

string

要查询的具体区块高度。
示例：61840405 可填具体区块高度或 latest。

only_unconfirmed

boolean

设为 true 仅返回未确认事件；设为 false（或省略）则返回全部事件。不能与 only_confirmed 同时使用。

only_confirmed

boolean

设为 true 仅返回已确认事件；设为 false（或省略）则返回已确认和未确认的事件。不能与 only_unconfirmed 同时使用。

min_timestamp

int64

筛选的最小区块时间戳。（单位：毫秒，默认值：0）

max_timestamp

int64

筛选的最大区块时间戳。（单位：毫秒，默认值：当前时间）

order_by

string

排序方式：block_timestamp,asc 或 block_timestamp,desc（默认）。

fingerprint

string

用于分页的 fingerprint，从上一次响应的 meta.fingerprint 字段获取。注意：使用 fingerprint 时，其他所有参数须保持不变。

limit

int32

每页返回的最大事件数量。（默认值：20，最大值：200）

Responses

403

请求被拒绝。请检查 API Key、安全设置及是否触发临时封锁，不要立即高频重试。参见速率限制。

Language

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

相关资源

200200

400400

429请求触发限流。降低请求频率，采用带随机抖动的指数退避。错误消息可能变化，请结合 HTTP 状态码判断。参见速率限制。