查看 Hyperliquid 账户逐笔成交记录
如何使用这个 Tool
使用下列已部署输入字段。必填字段必须提供;可选筛选用于缩小结果范围。
queryParams.to (可选): 窗口结束时间(Unix 秒或日期),包含该时间点;默认当前时间。order=desc 时可用最近收到的最早时间向前翻页,order=asc 时用于限定遍历范围。
queryParams.from (可选): 窗口开始时间(Unix 秒或日期)。默认 order=desc 时从该时间向后返回,最多约 2000 条;order=asc 时从该时间开始完整遍历历史,需跟随 meta.next_cursor 翻页。
queryParams.limit (可选): 每页数量,范围 1–100,默认 20。
queryParams.order (可选): 排序方向:desc(默认)按最新到最旧;asc 按最旧到最新并支持完整历史遍历。
queryParams.to_ms (可选): 用于毫秒级 desc 分页的窗口结束时间(Unix 毫秒);传入上一页最早成交的 time_ms。单独使用时边界不包含该时间点,需配合 to_fill_id 避免同一毫秒的记录被跳过。
queryParams.cursor (可选): 上一次响应 meta.next_cursor 返回的不透明续页令牌。使用时仅传 symbol 和 limit,不能同时传 from、to、to_ms 或 to_fill_id。
queryParams.symbol (可选): 精确筛选一个市场,例如 xyz:GOLD。筛选在客户端执行,分页时可能返回少于 limit 条或空页,但 meta.next_cursor 仍会推进。
queryParams.address (必填): 钱包地址,可为 0x EVM 地址或 ENS 名称,例如 vitalik.eth;不支持 Solana 地址。
queryParams.to_fill_id (可选): to_ms 的游标平局字段:将上一页最早成交的 fill_id 与 time_ms 一起传入,以便从该时间和 ID 之后继续,避免同一毫秒的成交记录丢失;需要先提供 to_ms,仅支持 desc。
返回内容
返回逐笔成交的价格、数量、方向、手续费、标识和可用平仓损益背景。
返回字段与解读方式
下表按照官方响应合同列出嵌套字段和有用的响应元数据。[] 表示数组中的一项。“父对象内必填”不代表有条件的父对象一定存在。类型允许 null 时可返回空值;可选字段可以省略。请结合各字段的明确条件区分缺失、空集合和数值 0。只有明确说明时才能确认单位与统计窗口。
覆盖范围、单位与时效
逐笔成交不同于重建的交易片段。资金费用不会分摊到每笔成交;秒和毫秒时间字段应按文档编码分别保留。
按字段说明检查返回的观测时间、缓存状态、水位、分页和错误。请求成功本身不能证明覆盖完整;来源没有说明时效或完整性保证时,应视为未知。保存的 Example 是历史样本,查看不会刷新数据或执行新调用。
数据来源与引用
此接口的数据由 Surf Data API 提供。响应合同和已部署 Tool 输入于 2026-10-03 按官方 OpenAPI v0.2.102 核对。此日期是合同核对日期,不是数据观测时间。实际覆盖取决于所选接口和请求。
Surf Data API 官方文档
Surf 官方 OpenAPI 合同
通过一个 Toolmu 账号,使用可用工具之间共享的预付费余额。按次付费,无需单独订阅供应商。此 Tool 当前每次执行费用上限为 0.0288 Toolmu 积分。这是上限,不是已结算费用。执行前应获取最新 Tool 契约,核对可用性、最新 maximumCredits、余额和预算。响应中的 credits_used(如有)表示来源 API 积分,不是 Toolmu 客户费用。