获取大额交易
1. 概述与典型用途
返回指定账户按代币、类型和金额筛选的大额交易列表，支持按转账类型（转入、转出、兑换、流动性操作等）过滤。
- 典型用途：大额交易监控、DeFi 操作追踪、资金异动预警。
- 何时不要用：查资金流向分布用「获取账户转入转出资金分布」；查全链稳定币大额交易用「获取稳定币大额交易」。
2. 接口与鉴权
GET /api/deep/account/token/bigAmount
Base URL 与鉴权见 公共网络与鉴权说明。
本接口强制需要 API Key：无 Key 调用返回 401。
3. 请求
字段
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
address | string | 是 | — | 查询的账户地址 |
relatedToken | string | 是 | — | 关联代币地址（Base58） |
types | string | 是 | — | 转账类型（逗号分隔）：0 全部、1 转入、2 转出、3 兑换、4 添加流动性、5 移除流动性、6 存款、7 借款、8 还款、9 提款 |
txUsd | string | 否 | — | USD 金额范围，逗号分隔，如 1,10 |
txAmount | string | 否 | — | 代币数量范围，逗号分隔，如 100,10000 |
relatedAddress | string | 否 | — | 按关联地址筛选 |
startTime | integer | 否 | — | 开始时间（秒级时间戳），最大区间 6 个月 |
endTime | integer | 否 | — | 结束时间（秒级时间戳），最大区间 6 个月 |
limit | integer | 否 | 100 | 返回数量，最大 100 |
sortBy | string | 否 | time | 排序字段：time、amount、usd |
asc | boolean | 否 | false | 是否升序 |
4. 响应
字段
顶层
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
total | integer | 必返 | 命中总数 | — |
code | integer | 必返 | 状态码，0 表示成功 | — |
data | array | 必返 | 交易列表 | — |
contractMap | object | 可选 | 地址 → 是否合约（boolean）的映射 | — |
contractInfo | object | 可选 | 涉及合约地址 → 标签信息映射；value schema 见下 | — |
chartRefreshTime | integer | 可选 | 图表数据刷新时间戳；基于 Greason v5 代码扫描（待补 reproducing sample） | 秒时间戳 |
contractInfo[<addr>] 对象 schema（8 字段）：
| 字段 | 类型 | 是否必返 | 说明 |
|---|---|---|---|
tag1 | string | 必返 | 主标签（项目名 / 合约名 / 交易所名） |
tag1Url | string | 必返 | 主标签链接 URL（可为空字符串） |
name | string | 必返 | 合约 / 项目正式名称 |
isToken | boolean | 必返 | 是否代币合约（true / false） |
vip | boolean | 必返 | 是否 VIP 实体（true / false） |
risk | boolean | string | 必返 | 风险标签；多数 endpoint 返回 boolean，部分返回字符串风险类型（blacklist / fraud 等） |
publicTagDesc | string | 必返 | 公开标签描述；多数账户为空字符串 |
publicTag | string | 可选 | 公开标签（如 "USDT Token" / "Binance"）；仅知名实体或部分接口返回 |
data[] 元素
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
amount | number | 必返 | 交易数量 | 代币单位 |
amountUsd | number | 必返 | 交易金额 | USD |
contractAddress | string | 必返 | 代币合约地址 | — |
dateTime | integer | 必返 | 交易时间 | 毫秒时间戳 |
fromAddress | string | 必返 | 发送方地址 | — |
fromAddressTag | string | 可选 | 发送方标签 | — |
toAddress | string | 必返 | 接收方地址 | — |
toAddressTag | string | 可选 | 接收方标签 | — |
hash | string | 必返 | 交易哈希 | — |
transferType | string | 必返 | 转账类型编码 | — |
externalContractAddress | string | 可选 | 外部合约地址（DeFi 操作时） | — |
5. 错误
HTTP 状态码见 公共错误说明。本接口要点：
- 需要 API Key：未携带返回
401。 - 必填参数缺失：
address、relatedToken、types缺失时返回空数据，不报错。 - 时间范围超过 6 个月：被静默截断。
- 空结果不等于错误：无命中返回
200+data: []，属于正常响应。
最后更新于: