查看代币合约转账历史与可选实体标签
如何使用这个 Tool
使用下列已部署输入字段。必填字段必须提供;可选筛选用于缩小结果范围。
queryParams.to (可选): 日期范围结束时间,支持 Unix 秒或 YYYY-MM-DD,默认今天。
queryParams.from (可选): 日期范围开始时间,支持 Unix 秒或 YYYY-MM-DD,默认 30 天前。
queryParams.chain (必填): 区块链,可选 ethereum、base、solana、tron、bsc 或 arbitrum。
queryParams.limit (可选): 每页结果数,例如 20;默认 20。
queryParams.offset (可选): 分页偏移量,例如 0;默认 0。
queryParams.address (必填): 代币合约地址:EVM 使用 0x 十六进制,Solana 使用 Base58;这不是 ticker,不能传 USDC 或 BTC。需通过 GET /v1/search/token?q={symbol}&chain={chain} 将 ticker 解析为该端点支持链上的合约地址。
queryParams.include (可选): 要附加到每笔转账的增强字段,当前支持 labels(添加 from_label 和 to_label)。
返回内容
返回代币合约已记录转账的发送/接收地址、金额、时间、交易哈希和可选标签。
返回字段与解读方式
下表按照官方响应合同列出嵌套字段和有用的响应元数据。[] 表示数组中的一项。“父对象内必填”不代表有条件的父对象一定存在。类型允许 null 时可返回空值;可选字段可以省略。请结合各字段的明确条件区分缺失、空集合和数值 0。只有明确说明时才能确认单位与统计窗口。
覆盖范围、单位与时效
地址输入是代币合约,不是钱包。美元补全可能滞后,已记录标签不独立验证地址所有者。
按字段说明检查返回的观测时间、缓存状态、水位、分页和错误。请求成功本身不能证明覆盖完整;来源没有说明时效或完整性保证时,应视为未知。保存的 Example 是历史样本,查看不会刷新数据或执行新调用。
数据来源与引用
此接口的数据由 Surf Data API 提供。响应合同和已部署 Tool 输入于 2026-10-03 按官方 OpenAPI v0.2.102 核对。此日期是合同核对日期,不是数据观测时间。实际覆盖取决于所选接口和请求。
Surf Data API 官方文档
Surf 官方 OpenAPI 合同
通过一个 Toolmu 账号,使用可用工具之间共享的预付费余额。按次付费,无需单独订阅供应商。此 Tool 当前每次执行费用上限为 0.0144 Toolmu 积分。这是上限,不是已结算费用。执行前应获取最新 Tool 契约,核对可用性、最新 maximumCredits、余额和预算。响应中的 credits_used(如有)表示来源 API 积分,不是 Toolmu 客户费用。