按选定指标排序代币转账发送方或接收方。返回排序转账对手方的转账次数、代币/美元金额、首末时间和可用标签。 通过一个 Toolmu 账号，使用可用工具之间共享的预付费余额。按次付费，无需单独订阅供应商。此 Tool 当前每次执行费用上限为 0.0144 Toolmu 积分。这是上限，不是已结算费用。执行前应获取最新 Tool 契约，核对可用性、最新 maximumCredits、余额和预算。响应中的 credits_used（如有）表示来源 API 积分，不是 Toolmu 客户费用。
按确认的实际用量结算，未使用的预留额度会恢复到可用余额。
Surf
按选定指标排序代币转账发送方或接收方。返回排序转账对手方的转账次数、代币/美元金额、首末时间和可用标签。 通过一个 Toolmu 账号，使用可用工具之间共享的预付费余额。按次付费，无需单独订阅供应商。此 Tool 当前每次执行费用上限为 0.0144 Toolmu 积分。这是上限，不是已结算费用。执行前应获取最新 Tool 契约，核对可用性、最新 maximumCredits、余额和预算。响应中的 credits_used（如有）表示来源 API 积分，不是 Toolmu 客户费用。
返回排序转账对手方的转账次数、代币/美元金额、首末时间和可用标签。 发送方和接收方排名描述所选方向与指标，不识别独立个人，也不证明当前余额。
查看[币种常见名称或公开详情页链接]在[时间范围]内转账最频繁的钱包。如果我没说要看发送方还是接收方，或有多个匹配结果，请先问我选哪一个。列出转账次数；美元金额可能延迟，钱包记录也无法确认真实身份。
开始前检查当前输入要求、可用状态和最高预留费用。
| 字段 / 路径 | 类型 | 是否必填 | 含义 |
|---|---|---|---|
queryParamsqueryParams | object | 必填 |
|
chainqueryParams.chain | string | 必填 | 代币合约部署所在的区块链，例如 ethereum。
|
limitqueryParams.limit | integer | 选填 | 每页结果数，默认 20。
|
metricqueryParams.metric | string | 选填 | 排名依据：count 表示转账次数，amount 表示按小数位调整后的代币总量，amount_usd 表示美元总额（美元数据约滞后 3 天，近期窗口不可靠）；默认 count。
|
offsetqueryParams.offset | integer | 选填 | 分页偏移量，默认 0。
|
addressqueryParams.address | string | 必填 | 代币合约地址（EVM 使用 0x 十六进制；Tron 使用 T 开头的 Base58 或 0x 十六进制）。这不是 ticker；请先通过 GET /v1/search/token?q={symbol}&chain={chain} 解析符号，并使用该端点支持的链上地址。
|
includequeryParams.include | string | 选填 | 逗号分隔的增强选项；labels 会为每个交易对手附加实体标签。
|
directionqueryParams.direction | string | 必填 | 排名方向：to 表示主要接收方，from 表示主要发送方。
|
time_rangequeryParams.time_range | string | 选填 | 回溯时间窗口，最多 90 天，默认 7d。
|
exclude_labelsqueryParams.exclude_labels | string | 选填 | 要排除的实体类别，逗号分隔，例如 cex、router、amm、bridge；基础设施占比较高时，结果可能少于 limit。
|
{
"type": "object",
"required": [
"queryParams"
],
"properties": {
"queryParams": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"address",
"chain",
"direction"
],
"~standard": {
"vendor": "zod",
"version": 1,
"jsonSchema": {}
},
"properties": {
"chain": {
"enum": [
"ethereum",
"base",
"bsc",
"arbitrum",
"tron"
],
"type": "string",
"description": "代币合约部署所在的区块链，例如 ethereum。"
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1,
"description": "每页结果数，默认 20。"
},
"metric": {
"enum": [
"count",
"amount",
"amount_usd"
],
"type": "string",
"default": "count",
"description": "排名依据：count 表示转账次数，amount 表示按小数位调整后的代币总量，amount_usd 表示美元总额（美元数据约滞后 3 天，近期窗口不可靠）；默认 count。"
},
"offset": {
"type": "integer",
"default": 0,
"maximum": 9007199254740991,
"minimum": 0,
"description": "分页偏移量，默认 0。"
},
"address": {
"type": "string",
"minLength": 1,
"description": "代币合约地址（EVM 使用 0x 十六进制；Tron 使用 T 开头的 Base58 或 0x 十六进制）。这不是 ticker；请先通过 GET /v1/search/token?q={symbol}&chain={chain} 解析符号，并使用该端点支持的链上地址。"
},
"include": {
"type": "string",
"minLength": 1,
"description": "逗号分隔的增强选项；labels 会为每个交易对手附加实体标签。"
},
"direction": {
"enum": [
"to",
"from"
],
"type": "string",
"description": "排名方向：to 表示主要接收方，from 表示主要发送方。"
},
"time_range": {
"enum": [
"1d",
"7d",
"30d",
"90d"
],
"type": "string",
"default": "7d",
"description": "回溯时间窗口，最多 90 天，默认 7d。"
},
"exclude_labels": {
"type": "string",
"minLength": 1,
"description": "要排除的实体类别，逗号分隔，例如 cex、router、amm、bridge；基础设施占比较高时，结果可能少于 limit。"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}暂未配置返回字段说明。
按选定指标排序代币转账发送方或接收方
使用下列已部署输入字段。必填字段必须提供；可选筛选用于缩小结果范围。
queryParams.chain (必填): 代币合约部署所在的区块链，例如 ethereum。
queryParams.limit (可选): 每页结果数，默认 20。
queryParams.metric (可选): 排名依据：count 表示转账次数，amount 表示按小数位调整后的代币总量，amount_usd 表示美元总额（美元数据约滞后 3 天，近期窗口不可靠）；默认 count。
queryParams.offset (可选): 分页偏移量，默认 0。
queryParams.address (必填): 代币合约地址（EVM 使用 0x 十六进制；Tron 使用 T 开头的 Base58 或 0x 十六进制）。这不是 ticker；请先通过 GET /v1/search/token?q={symbol}&chain={chain} 解析符号，并使用该端点支持的链上地址。
queryParams.include (可选): 逗号分隔的增强选项；labels 会为每个交易对手附加实体标签。
queryParams.direction (必填): 排名方向：to 表示主要接收方，from 表示主要发送方。
queryParams.time_range (可选): 回溯时间窗口，最多 90 天，默认 7d。
queryParams.exclude_labels (可选): 要排除的实体类别，逗号分隔，例如 cex、router、amm、bridge；基础设施占比较高时，结果可能少于 limit。
返回排序转账对手方的转账次数、代币/美元金额、首末时间和可用标签。
下表按照官方响应合同列出嵌套字段和有用的响应元数据。[] 表示数组中的一项。“父对象内必填”不代表有条件的父对象一定存在。类型允许 null 时可返回空值；可选字段可以省略。请结合各字段的明确条件区分缺失、空集合和数值 0。只有明确说明时才能确认单位与统计窗口。
字段、类型与是否必填 | 含义与返回条件 |
|---|---|
data.[].amount string; 父对象内必填 | 累计转移代币数量，已按精度调整。 |
data.[].amount_usd number; 父对象内可选; format: double | USD 总值；窗口内没有任何转移获得 USD 定价时省略。 |
data.[].counterparty_address string; 父对象内必填 | 交易对手地址；direction=to 时为接收者，direction=from 时为发送者。 |
data.[].first_transfer_at integer; 父对象内必填; format: int64 | 窗口内观察到的第一笔转移时间，单位为 Unix 秒。 |
data.[].label object; 父对象内可选 | 该交易对手的实体标签；仅 include=labels 时提供。 |
data.[].label.address string; 父对象内必填 | 钱包地址。 |
data.[].label.entity_name string; 父对象内可选 | 关联实体的名称，例如 Binance 或 Aave。 |
data.[].label.entity_type string; 父对象内可选 | 实体类型，例如 exchange、fund 或 whale。 |
data.[].label.labels array | null; 父对象内必填 | 该地址的标签列表。 |
data.[].label.labels.[].confidence number; 父对象内可选; format: double | 置信分数，范围为 0.0–1.0。 |
data.[].label.labels.[].label string; 父对象内必填 | 该地址的可读标签，例如 Binance Hot Wallet。 |
data.[].last_transfer_at integer; 父对象内必填; format: int64 | 窗口内观察到的最后一笔转移时间，单位为 Unix 秒。 |
data.[].transfer_count integer; 父对象内必填; format: int64 | 窗口内转移次数。 |
meta.cached boolean; 父对象内必填 | 该响应是否来自缓存。 |
meta.credits_used integer; 父对象内必填; format: int64 | 来源 API 为该请求扣除的积分；此字段属于来源 API，不等同于 Toolmu 客户积分上限。 |
meta.empty_reason string; 父对象内可选 | 数据数组为空时的原因提示，仅在适用时提供。 |
meta.has_more boolean; 父对象内可选 | 是否可能还有未返回的数据。offset 分页接口可增加 offset 继续查询；没有 offset/cursor 的时间序列接口返回 true 时，表示时间范围触及上游上限，应缩小 from/to。无法确认是否已取完时省略。 |
meta.limit integer; 父对象内必填; format: int64 | 本次响应最多返回的项目数。 |
meta.offset integer; 父对象内必填; format: int64 | 已跳过的项目数，即分页偏移量。 |
meta.total integer; 父对象内可选; format: int64 | 分页前的匹配项目总数；总数未知时省略。 |
meta.watermark integer; 父对象内可选; format: int64 | 本次计算采用的数据仓库水位时间，单位为 Unix 秒。仓库接口中，水位以前的数据来自仓库，更新的数据来自实时尾部；其他接口省略。 |
发送方和接收方排名描述所选方向与指标，不识别独立个人，也不证明当前余额。
按字段说明检查返回的观测时间、缓存状态、水位、分页和错误。请求成功本身不能证明覆盖完整；来源没有说明时效或完整性保证时，应视为未知。保存的 Example 是历史样本，查看不会刷新数据或执行新调用。
此接口的数据由 Surf Data API 提供。响应合同和已部署 Tool 输入于 2026-10-03 按官方 OpenAPI v0.2.102 核对。此日期是合同核对日期，不是数据观测时间。实际覆盖取决于所选接口和请求。
通过一个 Toolmu 账号，使用可用工具之间共享的预付费余额。按次付费，无需单独订阅供应商。此 Tool 当前每次执行费用上限为 0.0144 Toolmu 积分。这是上限，不是已结算费用。执行前应获取最新 Tool 契约，核对可用性、最新 maximumCredits、余额和预算。响应中的 credits_used（如有）表示来源 API 积分，不是 Toolmu 客户费用。
根据[币种公开详情页链接]确认币种，再列出它过去[30天]转账最频繁的接收方。
查看[币种常见名称或公开详情页链接]在[时间范围]内转账最频繁的钱包。如果我没说要看发送方还是接收方，或有多个匹配结果，请先问我选哪一个。列出转账次数；美元金额可能延迟，钱包记录也无法确认真实身份。
统计[Tether USD（泰达币）]过去[30天]收到代币总量最多的钱包；美元金额缺失或延迟时请说明。
queryParams.chain (必填): 代币合约部署所在的区块链，例如 ethereum。 queryParams.limit (可选): 每页结果数，默认 20。 queryParams.metric (可选): 排名依据：count 表示转账次数，amount 表示按小数位调整后的代币总量，amount_usd 表示美元总额（美元数据约滞后 3 天，近期窗口不可靠）；默认 count。 queryParams.offset (可选): 分页偏移量，默认 0。 queryParams.address (必填): 代币合约地址（EVM 使用 0x 十六进制；Tron 使用 T 开头的 Base58 或 0x 十六进制）。这不是 ticker；请先通过 GET /v1/search/token?q={symbol}&chain={chain} 解析符号，并使用该端点支持的链上地址。 queryParams.include (可选): 逗号分隔的增强选项；labels 会为每个交易对手附加实体标签。 queryParams.direction (必填): 排名方向：to 表示主要接收方，from 表示主要发送方。 queryParams.time_range (可选): 回溯时间窗口，最多 90 天，默认 7d。 queryParams.exclude_labels (可选): 要排除的实体类别，逗号分隔，例如 cex、router、amm、bridge；基础设施占比较高时，结果可能少于 limit。
返回排序转账对手方的转账次数、代币/美元金额、首末时间和可用标签。
发送方和接收方排名描述所选方向与指标，不识别独立个人，也不证明当前余额。
通过一个 Toolmu 账号，使用可用工具之间共享的预付费余额。按次付费，无需单独订阅供应商。此 Tool 当前每次执行费用上限为 0.0144 Toolmu 积分。这是上限，不是已结算费用。执行前应获取最新 Tool 契约，核对可用性、最新 maximumCredits、余额和预算。响应中的 credits_used（如有）表示来源 API 积分，不是 Toolmu 客户费用。
请让智能体按选定指标排序代币转账发送方或接收方，并提供上方必填输入。已有 Toolmu 连接时直接复用；尚未连接时按此页的配置说明完成连接。付费执行前，智能体应读取最新 Tool 契约，核对可用性、积分上限、余额、预算和你的授权，再执行 Tool 并解释返回字段及限制。
按字段说明检查返回的观测时间、缓存状态、水位、分页和错误。请求成功本身不能证明覆盖完整；来源没有说明时效或完整性保证时，应视为未知。保存的 Example 是历史样本，查看不会刷新数据或执行新调用。