内容
# HL 投资组合 API
[](https://hl-portfolio.api.klymax402.com/mcp)
[](https://x402.org)
[](LICENSE)
分析 Hyperliquid 账户：仓位、盈亏、成交记录、未成交订单、资金费用。获取任何钱包的完整结算中心状态，这是 Hyperliquid 交易智能所需的投资组合层代理。通过 [x402](https://x402.org)（Base L2 上的 USDC）进行按次付费调用 —— 无需 API 密钥，无需注册，无需速率限制墙。
[klymax402](https://klymax402.com) 市场的一部分 —— 100 个 x402 微支付 API 用于 AI 代理，一个钱包，Base 上的 USDC。
## 快速开始 -- MCP
将以下内容添加到您的 MCP 客户端配置（Claude Desktop、Cursor、ElizaOS 等）：
```json
{
"mcpServers": {
"hl-portfolio": {
"url": "https://hl-portfolio.api.klymax402.com/mcp"
}
}
}
```
## 快速开始 -- HTTP (x402)
```bash
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`](https://www.npmjs.com/package/@x402/fetch)、[`x402-agent-tools`](https://www.npmjs.com/package/x402-agent-tools)、ATXP）都可以自动处理 402 -> 签名 -> 重试循环。
## 工具
| 工具 | 方法 | 路径 | 价格 | 描述 |
|---|---|---|---|---|
| `hyperliquid_get_account_state` | POST | `/api/account` | $0.003 | 获取 Hyperliquid 钱包的完整结算中心状态：仓位、保证金、盈亏、杠杆、爆仓价格。 |
| `hyperliquid_get_trade_fills` | POST | `/api/fills` | $0.003 | 获取 Hyperliquid 钱包的近期成交记录：币种、方向、数量、价格、手续费、已结算盈亏、时间戳。 |
| `hyperliquid_get_open_orders` | POST | `/api/orders` | $0.002 | 获取 Hyperliquid 钱包的未成交订单：币种、方向、数量、价格、订单类型、只减仓标志。 |
| `hyperliquid_get_user_funding` | POST | `/api/funding` | $0.002 | 获取 Hyperliquid 钱包的资金费用支付记录：币种、金额、利率、时间戳。 |
### `hyperliquid_get_account_state`
用于获取 Hyperliquid 永续合约账户的完整投资组合状态。返回任何钱包地址的完整结算中心状态，包括账户级指标和每仓位详细信息。
**参数**
| 名称 | 类型 | 必需 | 描述 |
|---|---|---|---|
| `address` | string | 是 | Hyperliquid 钱包地址（0x...）用于获取账户状态 |
示例响应：
```json
{ 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`）， vault 性能（使用 `hyperliquid_get_vault_details`），鲸鱼跟踪（使用 `hyperliquid_detect_whale_trades`）。
### `hyperliquid_get_trade_fills`
用于获取 Hyperliquid 永续合约账户的近期成交记录（fills）。返回最近的交易记录，包含完整的成交细节，包括已结算仓位的实际盈亏。
**参数**
| 名称 | 类型 | 必需 | 描述 |
|---|---|---|---|
| `address` | string | 是 | Hyperliquid 钱包地址（0x...）用于获取成交记录 |
| `limit` | number | 否 | 返回的最大成交记录数量（默认：20，最大：100） |
示例响应：
```json
{ 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...）用于获取未成交订单 |
示例响应：
```json
{ 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 | 否 | 开始时间戳（毫秒）可选，默认为最近 7 天 |
示例响应：
```json
{ 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](https://x402.org) -- 原生 HTTP 按次付费，无需注册，无需 API 密钥
- 网络：Base L2 (`eip155:8453`)
- 资产：USDC
- 促进者：Coinbase CDP（主要），PayAI（备用）
- 也可通过 [ATXP](https://atxp.ai) 访问（OAuth 封装的 x402，RFC 9728 受保护资源元数据）
## klymax402 的一部分
100 个 x402 微支付 API 用于 AI 代理 -- 一个钱包，Base 上的 USDC，无需注册。
- 目录：https://klymax402.com/llms.txt
- 完整 API 参考：https://klymax402.com/llms-full.txt
- 实时统计：https://klymax402.com/stats
## 许可证
MIT
