Hl Portfolio X402

HL Portfolio API

分析 Hyperliquid 账户：持仓、盈亏、成交记录、未成交订单、资金费率。获取任意钱包的完整清算所状态。这是 Agent 进行 Hyperliquid 交易分析所需的投资组合层。通过 x402 按次付费（Base L2 上的 USDC）——无需 API 密钥、无需注册，也没有速率限制。

这是 klymax402 市场的一部分——面向 AI Agent 的 100 个 x402 小额支付 API，只需一个钱包和 Base 上的 USDC。

快速开始——MCP

添加到 MCP 客户端配置中（Claude Desktop、Cursor、ElizaOS 等）：

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

快速开始——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 → 签名 → 重试流程。

工具

工具	方法	路径	价格	描述
hyperliquid_get_account_state	POST	/api/account	$0.008	获取 Hyperliquid 钱包的完整清算所状态：持仓、保证金、盈亏、杠杆、强平价格。
hyperliquid_get_trade_fills	POST	/api/fills	$0.008	获取 Hyperliquid 钱包的近期成交记录：币种、方向、规模、价格、手续费、closedPnl、时间戳。
hyperliquid_get_open_orders	POST	/api/orders	$0.005	获取 Hyperliquid 钱包的未成交订单：币种、方向、规模、价格、订单类型、仅减仓标志。
hyperliquid_get_user_funding	POST	/api/funding	$0.005	获取 Hyperliquid 钱包收到或支付的资金费用：币种、金额、费率、时间戳。

hyperliquid_get_account_state

当你需要获取 Hyperliquid 永续合约账户的完整投资组合状态时使用。返回任意钱包地址的完整清算所状态，包括账户级指标和各持仓详情。

参数

名称	类型	必填	描述
address	string	是	要查询账户状态的 Hyperliquid 钱包地址（0x...）

响应示例：

{ 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）、资金费用（使用 hyperliquid_get_user_funding）、金库表现（使用 hyperliquid_get_vault_details）、巨鲸追踪（使用 hyperliquid_detect_whale_trades）。

hyperliquid_get_trade_fills

当你需要获取 Hyperliquid 永续合约账户的近期交易执行记录（成交记录）时使用。返回最近的交易及完整执行详情，包括已平仓头寸的已实现盈亏。

参数

名称	类型	必填	描述
address	string	是	要查询成交记录的 Hyperliquid 钱包地址（0x...）
limit	number	否	要返回的最大成交记录数（默认值：20，最大值：100）

响应示例：

{ 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 永续合约账户的所有待处理/未成交订单时使用。返回订单簿上每笔挂单的完整订单参数。

参数

名称	类型	必填	描述
address	string	是	要查询未成交订单的 Hyperliquid 钱包地址（0x...）

响应示例：

{ 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 永续合约账户的资金费支付历史时使用。返回收到或支付的所有资金费率款项，可用于计算资金费收入／支出，以及评估套利交易的盈利能力。

参数

名称	类型	必填	描述
address	string	是	要检索资金费历史的 Hyperliquid 钱包地址（0x...）
startTime	number	否	起始时间的 Unix 时间戳（毫秒）（可选，默认值：最近 7 天）

响应示例：

{ 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）。

Agent 提示词示例

• “检索 Hyperliquid 永续合约账户的完整投资组合状态”
• “检索 Hyperliquid 永续合约账户近期的交易执行记录（成交）”
• “查看 Hyperliquid 永续合约账户的所有待处理／未平仓订单”

付款

• 协议：x402 —— 原生支持 HTTP 的按次付费，无需注册，无需 API 密钥
• 网络：Base L2（eip155:8453）
• 资产：USDC
• Facilitator：Coinbase CDP（主要），PayAI（备用）
• 也可通过 ATXP 访问（由 OAuth 封装的 x402，受 RFC 9728 保护的资源元数据）

属于 klymax402

面向 AI Agent 的 100 个 x402 微支付 API —— 一个钱包、Base 上的 USDC、无需注册。

• 目录：https://klymax402.com/llms.txt
• 完整 API 参考：https://klymax402.com/llms-full.txt
• 实时统计：https://klymax402.com/stats

许可证

MIT