# Send HL Privateer to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - Download the package from Yavira. - Extract it into a folder your agent can access. - Paste one of the prompts below and point your agent at the extracted folder. ## Suggested prompts ### New install ```text I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete. ``` ### Upgrade existing ```text I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "hl-privateer-fund", "name": "HL Privateer", "source": "tencent", "type": "skill", "category": "AI 智能", "sourceUrl": "https://clawhub.ai/ADWilkinson/hl-privateer-fund", "canonicalUrl": "https://clawhub.ai/ADWilkinson/hl-privateer-fund", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/hl-privateer-fund", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=hl-privateer-fund", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "llms.txt", "api.md", "agents.json", "hl-privateer.md", "SKILL.md", "x402.md" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-30T16:55:25.780Z", "expiresAt": "2026-05-07T16:55:25.780Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network", "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"", "redirectLocation": null, "bodySnippet": null }, "scope": "source", "summary": "Source download looks usable.", "detail": "Yavira can redirect you to the upstream package for this source.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/hl-privateer-fund" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/hl-privateer-fund", "downloadUrl": "https://openagent3.xyz/downloads/hl-privateer-fund", "agentUrl": "https://openagent3.xyz/skills/hl-privateer-fund/agent", "manifestUrl": "https://openagent3.xyz/skills/hl-privateer-fund/agent.json", "briefUrl": "https://openagent3.xyz/skills/hl-privateer-fund/agent.md" } } ``` ## Documentation ### HL Privateer -- Agent Skill 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. ### Skill Files This skill package contains the following files, all served at https://hlprivateer.xyz/skills/: FilePurposehl-privateer.mdThis file. Primary skill definition with full instructions.llms.txtAgent-oriented quick start and endpoint catalog.api.mdComplete REST + WebSocket API reference.x402.mdx402 payment quickstart with example flows.agents.jsonMachine-readable OpenAgents v1 discovery document. ### Quick Start Hit any agent endpoint: GET https://api.hlprivateer.xyz/v1/agent/stream/snapshot Receive 402 Payment Required with PAYMENT-REQUIRED header containing payment instructions Decode the header (Base64 JSON) to get price, network, payTo address, and facilitator URL Create and sign an x402 payment payload for the specified amount (USDC on Base) Retry the same request with the PAYMENT-SIGNATURE header containing the signed payment (Base64 JSON) Receive data in the 200 response plus PAYMENT-RESPONSE settlement header ### Base URLs REST API: https://api.hlprivateer.xyz WebSocket: wss://ws.hlprivateer.xyz Web UI: https://hlprivateer.xyz ### x402 Payment Details Network: Base (eip155:8453) Asset: USDC (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) Facilitator: https://facilitator.payai.network Protocol: x402 v2 (exact scheme) See x402.md in this directory for the full payment flow with curl examples. ### Paid Endpoints (x402) All endpoints are GET requests against https://api.hlprivateer.xyz. Pay per call via x402. ### $0.01/call EndpointWhat You Get/v1/agent/stream/snapshotMode, PnL%, health, open positions, recent ops tape/v1/agent/positionsFull position array -- symbols, sides, sizes, entries, PnL/v1/agent/ordersOpen orders on the book/v1/agent/analysis?latest=trueLatest AI strategist analysis with thesis and signals/v1/agent/analysisAnalysis history (paginated, filterable by correlationId) ### $0.02/call EndpointWhat You Get/v1/agent/insights?scope=marketRisk config, signal timeline, account snapshot/v1/agent/insights?scope=aiFull dashboard: floor state, risk, analysis, copy summary ### $0.03/call EndpointWhat You Get/v1/agent/copy/trade?kind=signalsAudit trail of proposals, analysis, risk decisions, basket events/v1/agent/copy/trade?kind=positionsPosition data formatted for copy-trading ### Free Endpoints (no payment required) EndpointWhat You Get/v1/public/pnlCurrent PnL% and runtime mode/v1/public/floor-snapshotMode, PnL%, health, account value, positions, ops tape/v1/public/floor-tapeRecent ops log lines from all agent roles/healthzService health check ### Example: Check Current PnL (free) curl https://api.hlprivateer.xyz/v1/public/pnl { "pnlPct": 1.92, "mode": "READY", "updatedAt": "2026-02-13T16:20:00Z" } ### Copy Trading Read positions and signals to mirror trades on your own account. Poll /v1/agent/positions for current positions ($0.01) Poll /v1/agent/copy/trade?kind=signals for entry/exit signals ($0.03) Poll /v1/agent/copy/trade?kind=positions for copy-formatted position data ($0.03) ### Signal Integration Consume analysis and risk signals to inform your own strategy. Read /v1/agent/analysis?latest=true for the latest strategist thesis ($0.01) Read /v1/agent/insights?scope=ai for full AI floor summary ($0.02) Subscribe to WebSocket at wss://ws.hlprivateer.xyz for real-time floor tape ### Monitoring / Dashboard Build a monitoring view or alerting system. Free: Poll /v1/public/floor-snapshot for mode, PnL, positions Paid: Read /v1/agent/stream/snapshot for richer health and ops data ($0.01) Paid: Read /v1/agent/insights?scope=market for risk config and signal timeline ($0.02) ### Portfolio Composition Research Understand how the desk constructs and manages its basket. Read /v1/agent/analysis for historical analysis entries ($0.01) Read /v1/agent/insights?scope=ai for the full AI dashboard ($0.02) Read /v1/agent/copy/trade?kind=signals for the full proposal audit trail ($0.03) ### WebSocket Protocol Connect to wss://ws.hlprivateer.xyz for real-time events. ### Subscribe to channels { "type": "sub.add", "channel": "public.tape" } ### Receive events { "type": "event", "channel": "public.tape", "payload": { "eventType": "FLOOR_TAPE", "role": "strategist", "line": "LONG HYPE -- momentum breakout, funding neutral" } } ### Client message types TypePurposesub.addSubscribe to a channelsub.removeUnsubscribe from a channelcmd.execExecute a command (requires auth)pingKeepalive ### Server message types TypePurposesub.ackSubscription confirmedeventChannel event payloadcmd.resultCommand execution resulterrorError responsepongKeepalive response ### How The Desk Works HL Privateer runs autonomous agents on a single Hyperliquid account: Strategist: scans 50+ perp markets, generates long/short proposals with thesis and sizing Research: regime hypotheses, macro context, funding analysis, social sentiment Risk: explains risk posture (advisory only -- hard-gated by deterministic risk engine) Execution: suggests tactics, annotates slippage expectations Ops: monitors feeds, service health, circuit breakers (3s heartbeat) Market Data: detects stale feeds, regime shifts, funding divergences Scribe: produces audit narratives for each proposal cycle 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. ### Runtime Modes ModeMeaningINITStarting up, loading keys and configWARMUPCollecting initial market data windowREADYFlat, watching for opportunitiesIN_TRADEActive long/short positionsREBALANCEAdjusting position weights for parityHALTOperator-initiated stopSAFE_MODEAutomatic safety stop (dependency or data failure) ### Error Responses All errors follow a standard envelope: { "error": { "code": "RISK_DENY", "message": "Proposal denied by max drawdown rule", "requestId": "req_01J..." } } Common error codes: CodeMeaningPAYMENT_REQUIREDx402 payment needed (HTTP 402)UNAUTHORIZEDMissing or invalid authenticationFORBIDDENInsufficient tier or capabilityRISK_DENYRisk engine denied the actionRATE_LIMITEDToo many requestsINTERNAL_ERRORServer error ### Further Reading Full API reference: https://hlprivateer.xyz/skills/api.md x402 payment guide: https://hlprivateer.xyz/skills/x402.md Machine-readable discovery: https://hlprivateer.xyz/skills/agents.json Agent-oriented quick start: https://hlprivateer.xyz/skills/llms.txt Root agent index: https://hlprivateer.xyz/AGENT.md Root LLM map: https://hlprivateer.xyz/llms.txt ## Trust - Source: tencent - Verification: Indexed source record - Publisher: ADWilkinson - Version: 1.0.1 ## Source health - Status: healthy - Source download looks usable. - Yavira can redirect you to the upstream package for this source. - Health scope: source - Reason: direct_download_ok - Checked at: 2026-04-30T16:55:25.780Z - Expires at: 2026-05-07T16:55:25.780Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/hl-privateer-fund) - [Send to Agent page](https://openagent3.xyz/skills/hl-privateer-fund/agent) - [JSON manifest](https://openagent3.xyz/skills/hl-privateer-fund/agent.json) - [Markdown brief](https://openagent3.xyz/skills/hl-privateer-fund/agent.md) - [Download page](https://openagent3.xyz/downloads/hl-privateer-fund)