Skip to Content
API深度分析获取稳定币关键事件

获取稳定币关键事件

1. 概述与典型用途

返回 TRON 稳定币的关键智能合约事件(如铸造、销毁、添加黑名单等)。

  • 典型用途:监控稳定币关键事件,如增发、销毁、黑名单变动。
  • 何时不要用:查询普通交易请用交易列表接口。

2. 接口与鉴权

GET /api/deep/stableCoin/totalSupply/keyEvents

Base URL 与鉴权见 公共网络与鉴权说明。

本接口强制需要 API Key:无 Key 调用返回 401。

3. 请求

参数类型必填默认说明
startinteger是—起始索引。start + limit 不得超过 10000
limitinteger否100返回数量,最大 100
sortinteger是—排序方式:1:按事件美元金额,2:按事件时间
operatorAddressstring否—按操作方地址筛选
directioninteger是—1:升序,2:降序
startTimeinteger否—开始时间,包含边界,Unix 秒时间戳
endTimeinteger否—结束时间,包含边界,Unix 秒时间戳
startAmountnumber否—事件美元金额下限(USD),包含边界,非负小数;不传表示不设下限
endAmountnumber否—事件美元金额上限(USD),包含边界,非负小数;不传表示不设上限
USDTstring否—USDT 事件名,多个以逗号分隔,如 Issue,Redeem,AddedBlackList
USDCOLDstring否—USDC(旧版)事件名,多个以逗号分隔,如 Mint,Burn
USDDstring否—USDD 事件名,多个以逗号分隔,如 Deposit,Withdrawal
TUSDstring否—TUSD 事件名,多个以逗号分隔,如 Mint,Burn

任一代币筛选项非空时,仅返回指定的代币与事件组合;同一代币的多个事件及不同代币之间均取并集。全部代币筛选项未传或为空时,使用这四种代币的默认事件集合。

4. 响应

顶层(成功响应)

字段类型是否必返说明单位/精度
totalinteger必返匹配的事件总数—
codeinteger必返状态码,0 表示成功,1 表示错误—
dataarray必返事件列表;无匹配事件时为 []—
refreshTimeInfoobject必返数据刷新信息—

data[] 元素

字段类型是否必返说明单位/精度
tokenNamestring必返代币符号,如 USDT—
tokenAddressstring必返代币合约地址—
eventNamestring必返事件名称(如 AddedBlackList、Issue、Redeem)—
countstring必返已换算精度的代币数量;无数量的事件(如 AddedBlackList)返回空字符串 ""代币数量
operatorAddressstring必返操作方地址—
timestring必返事件时间Unix 毫秒时间戳(字符串形式)
hashstring必返交易哈希—
addressTagstring可选操作方地址标签;无标签时省略—

refreshTimeInfo 对象

字段类型是否必返说明单位/精度
typestring必返数据刷新类型,如 realtime—
lastUpdateTimeinteger必返最近更新时间Unix 秒时间戳

5. 错误

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

  • 需要 API Key:未携带返回 401。
  • 参数无效(如 sort=time、sort=3 或 startAmount=-1)时,返回 HTTP 200,响应包含 code: 1 和错误说明 msg。start + limit 不得超过 10000。