获取稳定币关键事件
1. 概述与典型用途
返回 TRON 稳定币的关键智能合约事件(如铸造、销毁、添加黑名单等)。
- 典型用途:监控稳定币关键事件,如增发、销毁、黑名单变动。
- 何时不要用:查询普通交易请用交易列表接口。
2. 接口与鉴权
GET /api/deep/stableCoin/totalSupply/keyEvents
Base URL 与鉴权见 公共网络与鉴权说明。
本接口强制需要 API Key:无 Key 调用返回 401。
3. 请求
字段
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
start | integer | 是 | — | 起始索引。start + limit 不得超过 10000 |
limit | integer | 否 | 100 | 返回数量,最大 100 |
sort | integer | 是 | — | 排序方式:1:按事件美元金额,2:按事件时间 |
operatorAddress | string | 否 | — | 按操作方地址筛选 |
direction | integer | 是 | — | 1:升序,2:降序 |
startTime | integer | 否 | — | 开始时间,包含边界,Unix 秒时间戳 |
endTime | integer | 否 | — | 结束时间,包含边界,Unix 秒时间戳 |
startAmount | number | 否 | — | 事件美元金额下限(USD),包含边界,非负小数;不传表示不设下限 |
endAmount | number | 否 | — | 事件美元金额上限(USD),包含边界,非负小数;不传表示不设上限 |
USDT | string | 否 | — | USDT 事件名,多个以逗号分隔,如 Issue,Redeem,AddedBlackList |
USDCOLD | string | 否 | — | USDC(旧版)事件名,多个以逗号分隔,如 Mint,Burn |
USDD | string | 否 | — | USDD 事件名,多个以逗号分隔,如 Deposit,Withdrawal |
TUSD | string | 否 | — | TUSD 事件名,多个以逗号分隔,如 Mint,Burn |
任一代币筛选项非空时,仅返回指定的代币与事件组合;同一代币的多个事件及不同代币之间均取并集。全部代币筛选项未传或为空时,使用这四种代币的默认事件集合。
4. 响应
字段
顶层(成功响应)
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
total | integer | 必返 | 匹配的事件总数 | — |
code | integer | 必返 | 状态码,0 表示成功,1 表示错误 | — |
data | array | 必返 | 事件列表;无匹配事件时为 [] | — |
refreshTimeInfo | object | 必返 | 数据刷新信息 | — |
data[] 元素
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
tokenName | string | 必返 | 代币符号,如 USDT | — |
tokenAddress | string | 必返 | 代币合约地址 | — |
eventName | string | 必返 | 事件名称(如 AddedBlackList、Issue、Redeem) | — |
count | string | 必返 | 已换算精度的代币数量;无数量的事件(如 AddedBlackList)返回空字符串 "" | 代币数量 |
operatorAddress | string | 必返 | 操作方地址 | — |
time | string | 必返 | 事件时间 | Unix 毫秒时间戳(字符串形式) |
hash | string | 必返 | 交易哈希 | — |
addressTag | string | 可选 | 操作方地址标签;无标签时省略 | — |
refreshTimeInfo 对象
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
type | string | 必返 | 数据刷新类型,如 realtime | — |
lastUpdateTime | integer | 必返 | 最近更新时间 | Unix 秒时间戳 |
5. 错误
HTTP 状态码见 公共错误说明。本接口要点:
- 需要 API Key:未携带返回
401。 - 参数无效(如
sort=time、sort=3或startAmount=-1)时,返回 HTTP200,响应包含code: 1和错误说明msg。start + limit不得超过 10000。