获取稳定币关键事件

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	否	—	开始时间，精确到秒
`endTime`	integer	否	—	结束时间，精确到秒
`startAmount`	number	否	`-1`	最小金额过滤。`-1` 表示不限
`endAmount`	number	否	`-1`	最大金额过滤。`-1` 表示不限
`USDT`	string	否	—	USDT 关键事件，多个事件以逗号分隔
`USDCOLD`	string	否	—	USDC（旧版）关键事件，多个事件以逗号分隔
`USDD`	string	否	—	USDD 关键事件，多个事件以逗号分隔
`TUSD`	string	否	—	TUSD 关键事件，多个事件以逗号分隔

4. 响应

字段

顶层

字段	类型	是否必返	说明	单位/精度
`total`	integer	必返	事件总数	—
`code`	integer	必返	状态码，`0` 表示成功	—
`data`	array	必返	事件列表	—
`refreshTimeInfo`	object	必返	数据刷新信息，含 `type`（字符串）和 `lastUpdateTime`（秒时间戳）	—
`addressTag`	object	可选	操作方地址标签映射（地址 → 标签信息）；基于 Greason v5 代码扫描，实测在特定场景下返回（待补 reproducing sample）	—
`chartRefreshTime`	integer	可选	图表数据刷新时间戳；基于 Greason v5 代码扫描（待补 reproducing sample）	秒时间戳

data[] 元素

字段	类型	是否必返	说明	单位/精度
`tokenName`	string	必返	代币名称	—
`tokenAddress`	string	必返	代币合约地址	—
`eventName`	string	必返	事件名称（如 `AddedBlackList`、`Issue`、`Redeem`）	—
`count`	string	必返	事件涉及数量；无数量的事件（如黑名单变更）返回空字符串 `""`	—
`operatorAddress`	string	必返	操作方地址	—
`time`	string	必返	事件时间	毫秒时间戳（字符串形式）
`hash`	string	必返	交易哈希	—

5. 错误

HTTP 状态码见公共错误说明。本接口要点：

需要 API Key：未携带返回 401。
start + limit 超过 10000：超出 ES 限制，返回错误。

最后更新于: 2026年3月16日

获取稳定币发行量变化获取稳定币总流通量