查看 EVM 钱包近期交易历史
如何使用这个 Tool
使用下列已部署输入字段。必填字段必须提供;可选筛选用于缩小结果范围。
queryParams.chain (可选): 链筛选,可选 ethereum、polygon、bsc、avalanche、arbitrum、optimism、fantom 或 base;默认 ethereum。
queryParams.limit (可选): 每页结果数,例如 20;默认 20。
queryParams.order (可选): 排序方向;上游游标分页仅正确支持 desc,不支持的值会被拒绝,默认 desc。
queryParams.before (可选): 深度分页游标:返回严格早于该 Unix 秒时间戳的交易;传入上一页最后一项时间戳,若同秒可能有多笔则传入时间戳加 1 并按 tx_hash 去重。
queryParams.offset (可选): 分页偏移量;上游仅可访问最近约 1000 笔交易,较大偏移会返回空页。深度历史优先使用 before 游标。
queryParams.address (必填): 钱包地址,必须是原始 0x 十六进制地址,不能使用 ENS 名称。
queryParams.include (可选): 要附加到每项记录的增强字段;当前支持 labels,为每个交易对手添加 from_label 和 to_label。
queryParams.sort_by (可选): 结果排序字段;上游游标分页仅正确支持 timestamp,默认 timestamp。
返回内容
返回 EVM 钱包近期交易的地址、原生单位价值、类型、时间和可选标签。
返回字段与解读方式
下表按照官方响应合同列出嵌套字段和有用的响应元数据。[] 表示数组中的一项。“父对象内必填”不代表有条件的父对象一定存在。类型允许 null 时可返回空值;可选字段可以省略。请结合各字段的明确条件区分缺失、空集合和数值 0。只有明确说明时才能确认单位与统计窗口。
覆盖范围、单位与时效
来源在分页前的近期历史上限约为 1,000 条。该接口不是完整终身档案,原生 value 也不是美元金额。
按字段说明检查返回的观测时间、缓存状态、水位、分页和错误。请求成功本身不能证明覆盖完整;来源没有说明时效或完整性保证时,应视为未知。保存的 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 客户费用。