Hyperliquid Get Order History
Get recent trade fills and resting orders for a Hyperliquid account. Returns fill history (size, price, PnL, fees) and resting orders for the requested DEX (defaults to crypto perps; pass `dex` for HIP-3 venues). Ideal for: trade journal tracking, fill alerts, order monitoring, and portfolio analytics.
目录操作 Hyperliquid 钱包
获取 Hyperliquid 账户的最近交易成交和挂单。返回成交历史（规模、价格、PnL、费用）和所请求 DEX 的挂单（默认为加密永续合约；传入 dex 以用于 HIP-3 场所）。适用于：交易日志跟踪、成交警报、订单监控和投资组合分析。
快速概览
| 字段 | 值 |
|---|---|
| 动作 ID | hyperliquid-get-order-history |
| 类别 | Hyperliquid |
| 连接器 | wallet |
| 需要 Gas | 否 |
| 资金移动 | 未声明 |
| 标签 | hyperliquid, perps, order, history, trade, trading |
输入架构
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
startTime | number | 否 | 以毫秒为单位的 Unix 时间戳。提供时，通过 userFillsByTime 查询成交（支持 endTime）。省略以获取最新的 userFills 响应（Hyperliquid 将其限制在约 2000 条）。 |
endTime | number | 否 | 以毫秒为单位的 Unix 时间戳。成交的上限，仅在设置 startTime 时应用。如果省略 startTime，则忽略。 |
limit | number | 否 | 排序后（最新优先）返回的最大成交数量。默认为 500，硬上限 2000。openOrders 不会被截断。 |
dex | string | 否 | TradFi 市场的 HIP-3 DEX 名称。省略以使用标准加密永续。xyz = trade.xyz（股票、指数、商品），flx = flx.finance，vntl = vntl.exchange |
结果架构
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
errors | object | 否 | 当两个上游调用之一（fills、openOrders）失败时设置。成功一方仍返回数据；失败一方为空数组。两者均失败则抛出硬错误。 |
fills | array | 是 | 按时间排序的最近交易成交（最新优先），受 limit 限制 |
openOrders | array | 是 | 请求的 DEX 当前挂单，按时间戳排序（最新优先） |
示例
json{ "type": "hyperliquid-get-order-history", "payload": { "startTime": 1, "endTime": 1, "limit": 1, "dex": "xyz" }, "children": [], "connector": { "type": "wallet", "id": "conn_wallet" }}
bashcurl -X POST "https://api.b3os.org/v1/actions/hyperliquid-get-order-history/test" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "inputs": { "startTime": 1, "endTime": 1, "limit": 1, "dex": "xyz" }}'
负载字段可以使用工作流表达式，例如 {{$trigger.body.amount}}、{{$nodes.fetch.result.price}} 和 {{$props.asset}}，当值应来自触发器、先前节点或可重用工作流属性时。