查看 Hyperliquid 账户未平仓市场持仓。返回未平仓持仓、保证金背景、清算字段和 Hyperliquid 永续账户报告总额。 通过一个 Toolmu 账号，使用可用工具之间共享的预付费余额。按次付费，无需单独订阅供应商。此 Tool 当前每次执行费用上限为 0.0288 Toolmu 积分。这是上限，不是已结算费用。执行前应获取最新 Tool 契约，核对可用性、最新 maximumCredits、余额和预算。响应中的 credits_used（如有）表示来源 API 积分，不是 Toolmu 客户费用。
按确认的实际用量结算，未使用的预留额度会恢复到可用余额。
Surf
查看 Hyperliquid 账户未平仓市场持仓。返回未平仓持仓、保证金背景、清算字段和 Hyperliquid 永续账户报告总额。 通过一个 Toolmu 账号，使用可用工具之间共享的预付费余额。按次付费，无需单独订阅供应商。此 Tool 当前每次执行费用上限为 0.0288 Toolmu 积分。这是上限，不是已结算费用。执行前应获取最新 Tool 契约，核对可用性、最新 maximumCredits、余额和预算。响应中的 credits_used（如有）表示来源 API 积分，不是 Toolmu 客户费用。
返回未平仓持仓、保证金背景、清算字段和 Hyperliquid 永续账户报告总额。 永续账户价值不是所有链的资产总值。清算价格为空不能证明持仓没有清算风险。
查看[公开的 Hyperliquid 账户主页链接]中，这个账户当前持有哪些交易。
开始前检查当前输入要求、可用状态和最高预留费用。
| 字段 / 路径 | 类型 | 是否必填 | 含义 |
|---|---|---|---|
queryParamsqueryParams | object | 必填 |
|
dexqueryParams.dex | string | 选填 | 市场范围：省略或填写 main_dex 时使用原生市场；也可选择构建者市场 xyz、flx、vntl、hyna、km、abcd、cash、para、mkts。
|
addressqueryParams.address | string | 必填 | 钱包地址：以 0x 开头的 EVM 地址，或 ENS 名称（如 vitalik.eth）。不支持 Solana 地址。
|
{
"type": "object",
"required": [
"queryParams"
],
"properties": {
"queryParams": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"address"
],
"~standard": {
"vendor": "zod",
"version": 1,
"jsonSchema": {}
},
"properties": {
"dex": {
"enum": [
"main_dex",
"xyz",
"flx",
"vntl",
"hyna",
"km",
"abcd",
"cash",
"para",
"mkts"
],
"type": "string",
"description": "市场范围：省略或填写 main_dex 时使用原生市场；也可选择构建者市场 xyz、flx、vntl、hyna、km、abcd、cash、para、mkts。"
},
"address": {
"type": "string",
"minLength": 1,
"description": "钱包地址：以 0x 开头的 EVM 地址，或 ENS 名称（如 vitalik.eth）。不支持 Solana 地址。"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}暂未配置返回字段说明。
查看 Hyperliquid 账户未平仓市场持仓
使用下列已部署输入字段。必填字段必须提供；可选筛选用于缩小结果范围。
queryParams.dex (可选): 市场范围：省略或填写 main_dex 时使用原生市场；也可选择构建者市场 xyz、flx、vntl、hyna、km、abcd、cash、para、mkts。
queryParams.address (必填): 钱包地址：以 0x 开头的 EVM 地址，或 ENS 名称（如 vitalik.eth）。不支持 Solana 地址。
返回未平仓持仓、保证金背景、清算字段和 Hyperliquid 永续账户报告总额。
下表按照官方响应合同列出嵌套字段和有用的响应元数据。[] 表示数组中的一项。“父对象内必填”不代表有条件的父对象一定存在。类型允许 null 时可返回空值；可选字段可以省略。请结合各字段的明确条件区分缺失、空集合和数值 0。只有明确说明时才能确认单位与统计窗口。
字段、类型与是否必填 | 含义与返回条件 |
|---|---|
data.account_value number; 父对象内必填; format: double | 永续清算账户权益，单位为 USD，来自跨保证金汇总。它不是完整投资组合；包括现货、Vault 和质押的总值应查询 /hyperliquid/account 的 total_value_usd。 |
data.address string; 父对象内必填 | 钱包地址。 |
data.cross_maintenance_margin_used number; 父对象内必填; format: double | 维持保证金，单位为 USD。 |
data.margin_ratio number; 父对象内必填; format: double | 维持保证金占账户权益的比例，范围为 0–1。来源指出接近 1.0 时账户接近清算；某持仓 liquidation_price 为 null 时，可用作账户层面的清算接近程度信号。 |
data.positions array | null; 父对象内必填 | 未平仓持仓，按持仓价值从大到小排序。 |
data.positions.[].cum_funding object; 父对象内必填 | 支付或收到的资金费用，单位为 USD。 |
data.positions.[].cum_funding.all_time number; 父对象内必填; format: double | 账户开立以来的资金费用，单位为 USD。 |
data.positions.[].cum_funding.since_change number; 父对象内必填; format: double | 该持仓最近一次变化以来的资金费用，单位为 USD。 |
data.positions.[].cum_funding.since_open number; 父对象内必填; format: double | 该持仓建立以来的资金费用，单位为 USD。 |
data.positions.[].distance_to_liquidation number; 父对象内可选; format: double | 标记价格移动到清算价所需的相对比例，始终为正，例如 0.05 表示 5%。它不是绝对价格或 USD 距离；没有清算价时省略。 |
data.positions.[].entry_price number; 父对象内必填; format: double | 平均入场价格，单位为 USD。 |
data.positions.[].leverage_type string; 父对象内必填 | 保证金模式，cross 或 isolated。 |
data.positions.[].leverage_value integer; 父对象内必填; format: int64 | 使用的杠杆。 |
data.positions.[].liquidation_price number; 父对象内可选; format: double | 清算价格，单位为 USD。上游 Hyperliquid 未提供时省略，常见于受现货抵押支持的跨保证金持仓；可参考账户层面的 margin_ratio。 |
data.positions.[].margin_used number; 父对象内必填; format: double | 该持仓占用的保证金，单位为 USD。 |
data.positions.[].mark_price number; 父对象内必填; format: double | 当前标记价格，单位为 USD，等于 position_value 除以 size 的绝对值。 |
data.positions.[].max_leverage integer; 父对象内必填; format: int64 | 该市场允许的最大杠杆。 |
data.positions.[].position_value number; 父对象内必填; format: double | 当前价值，单位为 USD。 |
data.positions.[].return_on_equity number; 父对象内必填; format: double | 权益回报率；0.45 表示 45%。 |
data.positions.[].side string; 父对象内必填 | 持仓方向，long 或 short。 |
data.positions.[].size number; 父对象内必填; format: double | 持仓数量；正值表示多头，负值表示空头。 |
data.positions.[].symbol string; 父对象内必填 | 市场 ID，例如 BTC、kPEPE 或 xyz:GOLD。 |
data.positions.[].unrealized_pnl number; 父对象内必填; format: double | 未实现损益，单位为 USD。 |
data.timestamp integer; 父对象内必填; format: int64 | 采集时间，单位为 Unix 秒。 |
data.total_margin_used number; 父对象内必填; format: double | 当前已使用保证金，单位为 USD。 |
data.total_notional_pos number; 父对象内必填; format: double | 全部持仓的总规模，单位为 USD。 |
data.total_raw_usd number; 父对象内必填; format: double | 原始 USD 余额。 |
data.withdrawable number; 父对象内必填; format: double | 可提取金额，单位为 USD。 |
meta.cached boolean; 父对象内必填 | 该响应是否来自缓存。 |
meta.credits_used integer; 父对象内必填; format: int64 | 来源 API 为该请求扣除的积分；此字段属于来源 API，不等同于 Toolmu 客户积分上限。 |
meta.empty_reason string; 父对象内可选 | 数据数组为空时的原因提示，仅在适用时提供。 |
永续账户价值不是所有链的资产总值。清算价格为空不能证明持仓没有清算风险。
按字段说明检查返回的观测时间、缓存状态、水位、分页和错误。请求成功本身不能证明覆盖完整；来源没有说明时效或完整性保证时，应视为未知。保存的 Example 是历史样本，查看不会刷新数据或执行新调用。
此接口的数据由 Surf Data API 提供。响应合同和已部署 Tool 输入于 2026-10-03 按官方 OpenAPI v0.2.102 核对。此日期是合同核对日期，不是数据观测时间。实际覆盖取决于所选接口和请求。
通过一个 Toolmu 账号，使用可用工具之间共享的预付费余额。按次付费，无需单独订阅供应商。此 Tool 当前每次执行费用上限为 0.0288 Toolmu 积分。这是上限，不是已结算费用。执行前应获取最新 Tool 契约，核对可用性、最新 maximumCredits、余额和预算。响应中的 credits_used（如有）表示来源 API 积分，不是 Toolmu 客户费用。
查询[vitalik.eth]在 Hyperliquid 当前持有哪些交易。
查看[公开的 Hyperliquid 账户主页链接]中，这个账户当前持有哪些交易。
告诉我[公开的 Hyperliquid 账户主页链接]中的账户目前是否还持有未结束的交易。
queryParams.dex (可选): 市场范围：省略或填写 main_dex 时使用原生市场；也可选择构建者市场 xyz、flx、vntl、hyna、km、abcd、cash、para、mkts。 queryParams.address (必填): 钱包地址：以 0x 开头的 EVM 地址，或 ENS 名称（如 vitalik.eth）。不支持 Solana 地址。
返回未平仓持仓、保证金背景、清算字段和 Hyperliquid 永续账户报告总额。
永续账户价值不是所有链的资产总值。清算价格为空不能证明持仓没有清算风险。
通过一个 Toolmu 账号，使用可用工具之间共享的预付费余额。按次付费，无需单独订阅供应商。此 Tool 当前每次执行费用上限为 0.0288 Toolmu 积分。这是上限，不是已结算费用。执行前应获取最新 Tool 契约，核对可用性、最新 maximumCredits、余额和预算。响应中的 credits_used（如有）表示来源 API 积分，不是 Toolmu 客户费用。
请让智能体查看 Hyperliquid 账户未平仓市场持仓，并提供上方必填输入。已有 Toolmu 连接时直接复用；尚未连接时按此页的配置说明完成连接。付费执行前，智能体应读取最新 Tool 契约，核对可用性、积分上限、余额、预算和你的授权，再执行 Tool 并解释返回字段及限制。
按字段说明检查返回的观测时间、缓存状态、水位、分页和错误。请求成功本身不能证明覆盖完整；来源没有说明时效或完整性保证时，应视为未知。保存的 Example 是历史样本，查看不会刷新数据或执行新调用。