HL Portfolio API

分析 Hyperliquid 账户：持仓、盈亏、成交、挂单和资金费率。获取任意钱包地址的完整清算状态。智能体在 Hyperliquid 交易情报分析中所需的投资组合层。通过 x402 按次付费（Base L2 上的 USDC）——无需 API 密钥、无需注册、无速率限制。

隶属于 klymax2 市场——100 个面向 AI 智能体的 x402 微支付 API，一个钱包，全部基于 Base 网络上的 USDC。

快速入门 -- MCP

将以下内容添加到 MCP 客户端配置（Claude Desktop、Cursor、ElizaOS 等）中：

{
  "mcpServers": {
    "hl-portfolio": {
      "url": "https://hl-portfolio.api.klymax402.com/mcp"
    }
  }
}

Related MCP server: polskidegen-hl-tracker

快速入门 -- HTTP (x402)

curl -X POST "https://hl-portfolio.api.klymax402.com/api/account" \
  -H "Content-Type: application/json" \
  -d '{"address":"0x0000000000000000000000000000000000dEaD"}'
# -> 402 Payment Required, with an x402 payment challenge in the response body

任何支持 x402 的客户端（@x402/fetch、x402-agent-tools、ATXP）都会自动处理 402: Payment Required 挑、签名、重试的完整循环。

工具

hyperliquid_get_account_state

当需要获取某个 Hyperliquid 永续合约账户的完整投资组合状态时，请使用该工具。它返回任意钱包地址的完整清算状态，其中包含账户级别的汇总指标和每个持仓的明细。

参数

示例响应：

{ accountValue: "125430.50", totalNtlPos: "89200.00", withdrawable: "36230.50", positions: [{ coin: "BTC", size: "1.5", entryPrice: "67500.00", unrealizedPnl: "2340.00", leverage: 5, liquidationPrice: "54200.00", marginType: "cross" }] }

适用场景：分析交易者的风险敞口、检查保证金健康状况，或评估在 Hyperliquid 上的资产配置。对跟单评估和风险监控不可或缺。

不适用场景：需要交易历史（使用 hyperliquid_get_trade_fills）、查看未成交委托（使用 hyperliquid_get_open_orders）、资金费率支付（使用 hypeliquid_get_user_funding）、Vault 表现（使用 hyper liquid_get_vault_details）、巨鲸追踪（使用 hyperliquid_detect_whale_trades）。

hyperliquid_get_trade_fills

当需要获取某个 Hyperliquid 永续合约账户的最新成交记录（fills）时请使用该工具。它返回最近的交易，并包含完整执行细节，包括已平仓的已实现盈亏。

参数

示例响应：

{ fills: [{ coin: "ETH", side: "buy", size: "10.0", price: "3450.50", fee: "0.69", closedPnl: "0.00", timestamp: 1712000000000 }], count: 20 }

不适用场景：当前持仓（请使用 hyperliquid_get_account_state）、未成交/待成交订单（请使用 hyperliquid_get_open_orders）、资金费率支付（请使用 hyperliquid_get_user_funding）。

hyperliquid_get_open_orders

当需要查看某个 Hyperliquid 永续合约账户中的所有未成交/待成交订单时，请使用该工具。它返回委托账本上每一笔 resting 挂单及完整订单参数。

参数

示例响应：

{ orders: [{ coin: "BTC", side: "buy", limitPx: "65000.00", sz: "0.5", orderType: "limit", reduceOnly: false, oid: 123456 }], count: 3 }

不适用场景：已成交交易（请使用 hyperliquid_get_trade_fills）、当前持仓（请使用 hyperliquid_get_account_state）。

hyperliquid_get_user_funding

当需要获取某个 Hyperliquid 永续合约账户的资金费率历史记录时，请使用该工具。它返回所有收到或支付的资金缴费记录，便于计算资金费率收入/支出，以及在评估持有成本交易的盈利能力时使用。

参数

示例响应：

{ funding: [{ coin: "BTC", fundingRate: "0.0001", payment: "-1.35", timestamp: 1712000000000, positionSize: "1.5" }], totalReceived: "45.20", totalPaid: "-12.30", netFunding: "32.90" }

不适用场景：当前持仓（请使用 hyperliquid_get_account_state）、资金费率套利机会（请使用 funding_arb_find_opportunities）、交易执行历史（请使用 hyperliquid_get_trade_fills）。

智能示例提示词

• "获取某个 Hyperliquid 永续合约账户的完整账户状态"

• "获取某个 Hyperliquid 永续合约账户的最新成交记录（fills）"

• "查看某个 Hyperliquid 永续合约账户的所有未成交/待成交委托"

支付

• 协议：x402 —— HTTP 原生按次付费，无需注册、无需 API Key

• 网络：Base L2（eip155:8453）

• 资产：USDC

• 协调服务：Coinbase CDP（主要）、PayAI（备用）

• 也可通过 ATXP（OAuth 封装的 x402； RFC9728 指定的受保护资源元数据）访问

属于 klymax402

100 个面向 AI 智能体的 x402 微支付 API——一个钱包，USDC 结算于 Base，零注册。

• 分类：https://klymax402.com/llms.txt

• 完整 API 参考：https://klymax402.com/llms-full.txt

• 实时指标：https://klymax402.com/stats

许可证

MIT