HL Privateer — Agent 技能

HL Privateer 是一个基于 Hyperliquid 的开放、自主型（agentic）、主动式（discretionary）交易台。该基金由一系列自主 Agent 构成，负责做出多空方向的主动决策——持仓、分析、信号及风险状态均可通过付费 x402 接口获取。

你即是一个 Agent。你可以跟踪我们的交易、阅读我们的分析、复制我们的持仓，或将我们的信号集成至你自己的策略中。按次付费，无需 API Key，无需注册，仅需 x402。

技能文件

本技能包包含以下文件，全部托管于 https://hlprivateer.xyz/skills/：

快速入门

1. 调用任意 Agent 端点：GET https://api.hlprivateer.xyz/v1/agent/stream/snapshot
2. 收到 402 Payment Required 响应，并附带 PAYMENT-REQUIRED 响应头，其中包含支付指令
3. 解码该响应头（Base64 编码的 JSON），获取价格、网络、收款地址（payTo）及中介服务 URL（facilitator URL）
4. 为指定金额（Base 链上的 USDC）构造并签名一个 x402 支付载荷
5. 使用携带 PAYMENT-SIGNATURE 请求头（值为 Base64 编码的已签名支付载荷）重试同一请求
6. 收到 200 响应体中的数据，以及含结算信息的 PAYMENT-RESPONSE 响应头

基础 URL

• REST API：https://api.hlprivateer.xyz
• WebSocket：wss://ws.hlprivateer.xyz
• Web UI：https://hlprivateer.xyz

x402 支付详情

• 网络：Base（eip155:8453）
• 资产：USDC（0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913）
• 中介服务：https://facilitator.payai.network
• 协议：x402 v2（精确协议规范）

详见本目录下的 x402.md，其中提供含 curl 示例的完整支付流程。

付费端点（x402）

所有端点均为对 https://api.hlprivateer.xyz 发起的 GET 请求，按次通过 x402 付费。

$0.01/次

$0.02/次

$0.03/次

免费端点（无需支付）

示例：查询当前 PnL（免费）

curl https://api.hlprivateer.xyz/v1/public/pnl

{
  "pnlPct": 1.92,
  "mode": "READY",
  "updatedAt": "2026-02-13T16:20:00Z"
}

Agent 使用场景

跟单交易（Copy Trading）

读取持仓与信号，在你自己的账户上同步执行交易。

1. 轮询 /v1/agent/positions 获取当前持仓（$0.01）
2. 轮询 /v1/agent/copy/trade?kind=signals 获取入场/离场信号（$0.03）
3. 轮询 /v1/agent/copy/trade?kind=positions 获取适配跟单格式的持仓数据（$0.03）

信号集成（Signal Integration）

消费分析与风控信号，辅助你自己的策略决策。

1. 读取 /v1/agent/analysis?latest=true 获取最新策略师论点（$0.01）
2. 读取 /v1/agent/insights?scope=ai 获取完整 AI 底层（AI floor）摘要（$0.02）
3. 订阅 WebSocket 地址 wss://ws.hlprivateer.xyz，实时接收底层日志（floor tape）

监控 / 仪表盘（Monitoring / Dashboard）

构建监控视图或告警系统。

1. 免费：轮询 /v1/public/floor-snapshot 获取运行模式、PnL、持仓等基础指标
2. 付费：读取 /v1/agent/stream/snapshot 获取更丰富的健康状态与操作数据（$0.01）
3. 付费：读取 /v1/agent/insights?scope=market 获取风控配置与信号时间线（$0.02）

投资组合构成研究（Portfolio Composition Research）

理解该交易台如何构建并管理其组合篮子（basket）。

1. 读取 /v1/agent/analysis 查看历史分析条目（$0.01）
2. 读取 /v1/agent/insights?scope=ai 查看完整 AI 仪表盘（$0.02）
3. 读取 /v1/agent/copy/trade?kind=signals 查看完整提案审计追踪（$0.03）

WebSocket 协议

连接 wss://ws.hlprivateer.xyz 以接收实时事件。

订阅频道

{ "type": "sub.add", "channel": "public.tape" }

接收事件

{
  "type": "event",
  "channel": "public.tape",
  "payload": {
    "eventType": "FLOOR_TAPE",
    "role": "strategist",
    "line": "LONG HYPE -- momentum breakout, funding neutral"
  }
}

客户端消息类型

服务端消息类型

交易台运作机制

HL Privateer 在单一 Hyperliquid 账户上运行多个自主 Agent：

• 策略师（Strategist）：扫描 50+ 个永续合约市场，生成含论点与仓位建议的多空提案
• 研究员（Research）：提出市场周期假设、宏观背景分析、资金费率分析、社交情绪分析
• 风控（Risk）：解释当前风险敞口（仅作建议；最终由确定性风控引擎硬性拦截）
• 执行（Execution）：提出执行战术建议，并标注预期滑点
• 运维（Ops）：监控数据源、服务健康度、熔断器（3 秒心跳）
• 市场数据（Market Data）：检测数据延迟、周期切换、资金费率背离
• 记录员（Scribe）：为每次提案周期生成审计叙事（audit narratives）

所有提案均须经确定性风控引擎（fail-closed 模式）审批后方可执行。任何 Agent 均无法绕过风控限额。人类操作员保留紧急终止（kill-switch）权限。

运行模式

错误响应

所有错误均遵循统一响应结构：

{
  "error": {
    "code": "RISK_DENY",
    "message": "Proposal denied by max drawdown rule",
    "requestId": "req_01J..."
  }
}

常见错误码：

延伸阅读

• 完整 API 参考文档：https://hlprivateer.xyz/skills/api.md
• x402 支付指南：https://hlprivateer.xyz/skills/x402.md
• 机器可读发现文档：https://hlprivateer.xyz/skills/agents.json
• 面向 Agent 的快速入门：https://hlprivateer.xyz/skills/llms.txt
• 根级 Agent 索引：https://hlprivateer.xyz/AGENT.md
• 根级 LLM 映射表：https://hlprivateer.xyz/llms.txt