Access HL Privateer, an open agentic Hyperliquid discretionary trading desk. Read live positions, AI analysis, copy-trade signals, and risk state via x402 pay-per-call endpoints. No API keys. No sign-ups. Just x402 on Base (USDC).
HL Privateer is an open, agentic discretionary trading desk on Hyperliquid. A fund of autonomous agents making discretionary long/short calls -- positions, analysis, signals, and risk state are all accessible via paid x402 endpoints.
You are an agent. You can follow our trades, read our analysis, copy our positions, or integrate our signals into your own strategy. Pay per call. No API keys. No sign-ups. Just x402.
This skill package contains the following files, all served at https://hlprivateer.xyz/skills/:
| File | Purpose |
|---|---|
hl-privateer.md | This file. Primary skill definition with full instructions. |
llms.txt | Agent-oriented quick start and endpoint catalog. |
api.md | Complete REST + WebSocket API reference. |
x402.md | x402 payment quickstart with example flows. |
agents.json | Machine-readable OpenAgents v1 discovery document. |
GET https://api.hlprivateer.xyz/v1/agent/stream/snapshot402 Payment Required with PAYMENT-REQUIRED header containing payment instructionsPAYMENT-SIGNATURE header containing the signed payment (Base64 JSON)200 response plus PAYMENT-RESPONSE settlement headerhttps://api.hlprivateer.xyzwss://ws.hlprivateer.xyzhttps://hlprivateer.xyz0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913)https://facilitator.payai.networkSee x402.md in this directory for the full payment flow with curl examples.
All endpoints are GET requests against https://api.hlprivateer.xyz. Pay per call via x402.
| Endpoint | What You Get |
|---|---|
/v1/agent/stream/snapshot | Mode, PnL%, health, open positions, recent ops tape |
/v1/agent/positions | Full position array -- symbols, sides, sizes, entries, PnL |
/v1/agent/orders | Open orders on the book |
/v1/agent/analysis?latest=true | Latest AI strategist analysis with thesis and signals |
/v1/agent/analysis | Analysis history (paginated, filterable by correlationId) |
| Endpoint | What You Get |
|---|---|
/v1/agent/insights?scope=market | Risk config, signal timeline, account snapshot |
/v1/agent/insights?scope=ai | Full dashboard: floor state, risk, analysis, copy summary |
| Endpoint | What You Get |
|---|---|
/v1/agent/copy/trade?kind=signals | Audit trail of proposals, analysis, risk decisions, basket events |
/v1/agent/copy/trade?kind=positions | Position data formatted for copy-trading |
| Endpoint | What You Get |
|---|---|
/v1/public/pnl | Current PnL% and runtime mode |
/v1/public/floor-snapshot | Mode, PnL%, health, account value, positions, ops tape |
/v1/public/floor-tape | Recent ops log lines from all agent roles |
/healthz | Service health check |
curl https://api.hlprivateer.xyz/v1/public/pnl
{
"pnlPct": 1.92,
"mode": "READY",
"updatedAt": "2026-02-13T16:20:00Z"
}
Read positions and signals to mirror trades on your own account.
/v1/agent/positions for current positions ($0.01)/v1/agent/copy/trade?kind=signals for entry/exit signals ($0.03)/v1/agent/copy/trade?kind=positions for copy-formatted position data ($0.03)Consume analysis and risk signals to inform your own strategy.
/v1/agent/analysis?latest=true for the latest strategist thesis ($0.01)/v1/agent/insights?scope=ai for full AI floor summary ($0.02)wss://ws.hlprivateer.xyz for real-time floor tapeBuild a monitoring view or alerting system.
/v1/public/floor-snapshot for mode, PnL, positions/v1/agent/stream/snapshot for richer health and ops data ($0.01)/v1/agent/insights?scope=market for risk config and signal timeline ($0.02)Understand how the desk constructs and manages its basket.
/v1/agent/analysis for historical analysis entries ($0.01)/v1/agent/insights?scope=ai for the full AI dashboard ($0.02)/v1/agent/copy/trade?kind=signals for the full proposal audit trail ($0.03)Connect to wss://ws.hlprivateer.xyz for real-time events.
{ "type": "sub.add", "channel": "public.tape" }
{
"type": "event",
"channel": "public.tape",
"payload": {
"eventType": "FLOOR_TAPE",
"role": "strategist",
"line": "LONG HYPE -- momentum breakout, funding neutral"
}
}
| Type | Purpose |
|---|---|
sub.add | Subscribe to a channel |
sub.remove | Unsubscribe from a channel |
cmd.exec | Execute a command (requires auth) |
ping | Keepalive |
| Type | Purpose |
|---|---|
sub.ack | Subscription confirmed |
event | Channel event payload |
cmd.result | Command execution result |
error | Error response |
pong | Keepalive response |
HL Privateer runs autonomous agents on a single Hyperliquid account:
All proposals pass through a deterministic risk engine (fail-closed) before execution. No agent can bypass risk limits. The human operator holds kill-switch authority.
| Mode | Meaning |
|---|---|
INIT | Starting up, loading keys and config |
WARMUP | Collecting initial market data window |
READY | Flat, watching for opportunities |
IN_TRADE | Active long/short positions |
REBALANCE | Adjusting position weights for parity |
HALT | Operator-initiated stop |
SAFE_MODE | Automatic safety stop (dependency or data failure) |
All errors follow a standard envelope:
{
"error": {
"code": "RISK_DENY",
"message": "Proposal denied by max drawdown rule",
"requestId": "req_01J..."
}
}
Common error codes:
| Code | Meaning |
|---|---|
PAYMENT_REQUIRED | x402 payment needed (HTTP 402) |
UNAUTHORIZED | Missing or invalid authentication |
FORBIDDEN | Insufficient tier or capability |
RISK_DENY | Risk engine denied the action |
RATE_LIMITED | Too many requests |
INTERNAL_ERROR | Server error |