获取账户转入转出资金分布
1. 概述与典型用途
返回指定账户资金流入和流出的汇总分析,包括每个关联地址的转入/转出金额(美元)及次数。
- 典型用途:资金流向分析、关联账户追踪、入金出金渠道统计。
- 何时不要用:查单笔交易详情用「通过交易哈希获取交易详情」;查大额交易用「获取大额交易」。
2. 接口与鉴权
GET /api/deep/account/transferAmount
Base URL 与鉴权见 公共网络与鉴权说明。
本接口强制需要 API Key:无 Key 调用返回 401。
3. 请求
字段
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
address | string | 是 | — | 查询的账户地址 |
direction | integer | 否 | 0 | 转账类型:0 全部、1 转入、2 转出 |
relatedToken | string | 否 | — | 按关联代币筛选(Base58 地址,或 0 表示 TRX,TRC10 ID) |
sortBy | string | 否 | amountIn | 排序字段:amountIn、amountOut、timesIn、timesOut |
limit | integer | 否 | 100 | 返回数量 |
4. 响应
字段
顶层
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
code | integer | 必返 | 状态码,0 表示成功 | — |
transfer_in | object | 必返 | 转入汇总 | — |
transfer_out | object | 必返 | 转出汇总 | — |
transfer_in / transfer_out 对象
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
total | integer | 必返 | 关联地址总数 | — |
amountTotal | number | 必返 | 金额总计 | USD |
data | array | 必返 | 关联地址列表 | — |
contractMap | object | 可选 | 地址 → 是否合约 | — |
contractInfo | object | 可选 | 合约标签信息 | — |
data[] 元素
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
address | string | 必返 | 关联地址 | — |
addressTag | string | 可选 | 地址标签 | — |
amountInUsd | number | 必返 | 金额 | USD |
5. 错误
HTTP 状态码见 公共错误说明。本接口要点:
- 需要 API Key:未携带返回
401。 address未传:返回空数据,不报错。- 空结果不等于错误:无命中返回
200+ 空data,属于正常响应。
最后更新于: