获取触发交易列表
1. 概述与典型用途
查询全网触发智能合约的交易列表，支持按时间范围过滤，支持分页。
- 典型用途：全网合约交易流水监控、特定时间段的合约调用统计、链上活跃度分析。
- 何时不要用：查询特定合约事件用「获取合约事件信息」；查询特定合约的调用方用「获取合约所有调用方列表」。
2. 接口与鉴权
GET /api/contracts/trigger
Base URL 与鉴权见 公共网络与鉴权说明。
3. 请求
字段
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
start | integer | 否 | 0 | 起始编号；start + limit ≤ 10000 |
limit | integer | 否 | 10 | 每页数量，最大 50 |
start_timestamp | integer | 否 | — | 开始时间，毫秒时间戳 |
end_timestamp | integer | 否 | — | 结束时间，毫秒时间戳 |
4. 响应
字段
顶层
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
total | integer | 必返 | 命中总数（上限 10000） | — |
rangeTotal | integer | 必返 | 时间范围内触发交易总数 | — |
data | array | 必返 | 触发交易列表 | — |
contractMap | object | 可选 | 地址 → 是否为合约的映射 | — |
contractInfo | object | 可选 | 合约地址 → 标签信息 | — |
data[] 元素
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
block | integer | 必返 | 区块高度 | — |
hash | string | 必返 | 交易哈希 | — |
timestamp | integer | 必返 | 交易时间 | 毫秒时间戳 |
ownerAddress | string | 必返 | 交易发起人地址 | — |
contractAddress | string | 必返 | 目标合约地址 | — |
callData | string | 必返 | 调用数据（十六进制） | — |
callValue | integer | 必返 | 调用附带的 TRX 值 | sun |
confirmed | boolean | 必返 | 是否已确认 | — |
contractType | string | 必返 | 合约类型（如 "IntendedLeaveEmpty" 为触发合约类型标识） | — |
result | string | 必返 | 执行结果（如 "IntendedLeaveEmpty" 或 "SUCCESS"） | — |
token | string | 必返 | 涉及的代币（可为空字符串） | — |
ownerAddressTag | string | 可选 | 交易发起方地址标签 | — |
5. 错误
HTTP 状态码见 公共错误说明。本接口要点：
start + limit超过 10000：超出后被静默截断并返回200，不会报错。limit超过 50：被静默限制为 50。- 空结果 ≠ 错误：无命中返回
200+data: []，属于正常响应。
最后更新于: