获取合约事件信息
1. 概述与典型用途
批量查询合约的事件日志与触发交易，支持按交易哈希、区块号、事件名称过滤，支持字段裁剪。
- 典型用途：监控合约事件、查看合约最近触发交易、按哈希批量查询合约执行日志。
- 何时不要用：只查合约基本信息用「获取合约详细信息」；查合约调用统计用「获取合约调用统计数据」。
2. 接口与鉴权
POST /api/contracts/smart-contract-triggers-batch
Base URL 与鉴权见 公共网络与鉴权说明。
3. 请求
字段
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
contractAddress | string | 否 | — | 合约地址 |
hashList | array | 否 | — | 交易哈希列表 |
term | string | 否 | — | 查询关键词——支持区块号和事件名称 |
fields | string | 否 | — | 以逗号分隔的字段名列表，指定 list[] 中返回的字段 |
4. 响应
字段
顶层
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
event_list | array | 必返 | 事件日志列表 | — |
list | array | 必返 | 触发交易列表 | — |
event_list[] 元素
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
block_number | integer | 必返 | 区块高度 | — |
block_timestamp | integer | 必返 | 区块时间 | 毫秒时间戳 ms |
caller_contract_address | string | 必返 | 调用者合约地址 | — |
contract_address | string | 必返 | 目标合约地址 | — |
event_index | integer | 必返 | 事件在交易中的索引位置 | — |
event_name | string | 必返 | 事件名称 | — |
event | string | 必返 | 完整事件签名 | — |
result | object | 必返 | 事件参数键值对（含数字索引键和命名键） | — |
result_type | object | 必返 | 事件参数类型映射 | — |
result_with_topic | object | 必返 | 带 topic 的结构化事件参数（含 index 数组、topic 哈希、dataInArr 数组） | — |
transaction_id | string | 必返 | 交易哈希 | — |
list[] 元素
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
owner_address | string | 必返 | 交易发起人地址 | — |
block | integer | 必返 | 区块高度 | — |
hash | string | 必返 | 交易哈希 | — |
date_created | integer | 必返 | 创建时间 | 毫秒时间戳 ms |
contract_address | string | 必返 | 合约地址 | — |
token_id | integer | 必返 | 代币 ID（通常为 0） | — |
token_value | integer | 必返 | 代币转账数量（通常为 0） | — |
call_value | integer | 必返 | TRX 调用金额（sun） | sun |
data | string | 必返 | 原始调用数据（hex 编码） | — |
parameter | string | 必返 | 解码后的参数（JSON 字符串） | — |
method | string | 必返 | 调用方法签名 | — |
day | string | 必返 | 交易日期 | YYYY-MM-DD |
confirmed | boolean | 必返 | 是否已确认 | — |
5. 错误
HTTP 状态码见 公共错误说明。本接口要点：
- 必须使用 POST 方法：使用 GET 请求将返回错误。
- 空结果 ≠ 错误：无匹配事件时返回
200+ 空数组，属于正常响应。
最后更新于: