获取关联账户交易数据
1. 概述与典型用途
返回与指定地址有交易记录的关联账户，以及转入/转出金额和次数。
- 典型用途：分析账户之间的资金往来关系，追踪大额转账对手方。
- 何时不要用：查询单笔交易详情请用交易查询接口；查询账户余额请用账户接口。
2. 接口与鉴权
GET /api/deep/account/relatedAccount
Base URL 与鉴权见 公共网络与鉴权说明。
本接口强制需要 API Key：无 Key 调用返回 401。
3. 请求
字段
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
address | string | 是 | — | 查询地址 |
txNum | string | 否 | — | 交易次数范围，以逗号分隔，例如 1,10 表示 1 到 10 次 |
txAmount | string | 否 | — | 交易金额范围，以逗号分隔，例如 100,10000 |
direction | integer | 否 | 0 | 转账类型。0：全部，1：转入，2：转出 |
relatedAddress | string | 否 | — | 按关联地址筛选 |
relatedToken | string | 否 | — | 按关联代币筛选 |
startTime | integer | 否 | — | 开始时间，精确到秒。最大区间 90 天 |
endTime | integer | 否 | 当前时间 | 结束时间，精确到秒 |
sortBy | string | 否 | amountIn | 排序字段：amountIn、amountOut、timesIn、timesOut |
limit | integer | 否 | 100 | 返回数量，最大 100 |
4. 响应
字段
顶层
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
total | integer | 必返 | 关联账户总数 | — |
code | integer | 必返 | 状态码，0 表示成功 | — |
data | array | 必返 | 关联账户列表 | — |
contractMap | object | 必返 | 地址是否为合约的映射，键为地址，值为 boolean | — |
contractInfo | object | 必返 | 合约信息映射；无合约时为空对象 {} | — |
data[] 元素
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
inAmountUsd | number | 必返 | 转入总金额（USD） | 美元 |
outAmountUsd | number | 必返 | 转出总金额（USD） | 美元 |
address | string | 必返 | 关联账户地址 | — |
addressTag | string | 必返 | 关联账户标签 | — |
outNum | integer | 必返 | 转出次数 | — |
inNum | integer | 必返 | 转入次数 | — |
5. 错误
HTTP 状态码见 公共错误说明。本接口要点：
- 需要 API Key：未携带返回
401。 - 空结果不等于错误：无命中返回
code: 0+data: []，属于正常响应。
最后更新于: