获取黑名单交易列表
1. 概述与典型用途
返回地址被添加至或从稳定币黑名单中移除的交易记录。
- 典型用途：追踪稳定币黑名单变动，合规监控。
- 何时不要用：查询账户安全信息请用「检查账户安全」。
2. 接口与鉴权
GET /api/stableCoin/blackList
Base URL 与鉴权见 公共网络与鉴权说明。
3. 请求
字段
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
tokenAddress | string | 否 | — | 按稳定币合约地址筛选 |
blackAddress | string | 否 | — | 按黑名单地址筛选 |
sort | integer | 否 | 1 | 1：按数量，2：按时间 |
direction | integer | 否 | 1 | 1：升序，2：降序 |
start | integer | 否 | 0 | 起始索引 |
limit | integer | 否 | 20 | 返回数量，范围 [20, 100]；传入小于 20 的值将报错 |
4. 响应
字段
顶层
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
total | integer | 必返 | 黑名单记录总数 | — |
data | array | 必返 | 黑名单交易列表 | — |
data[] 元素
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
blackAddress | string | 必返 | 被列入黑名单的地址 | — |
tokenName | string | 必返 | 代币名称 | — |
num | string | 必返 | 被冻结的数量 | — |
time | integer | 必返 | 事件时间 | 秒时间戳 |
transHash | string | 必返 | 交易哈希 | — |
contractAddress | string | 必返 | 代币合约地址 | — |
5. 错误
HTTP 状态码见 公共错误说明。本接口要点：
limit超出[20, 100]范围：返回{"message": "limit must be in range [20, 100]"}。- 通用错误处理规则适用。
最后更新于: