{
  "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": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/hl-privateer-fund",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=hl-privateer-fund",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "llms.txt",
      "api.md",
      "agents.json",
      "hl-privateer.md",
      "SKILL.md",
      "x402.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "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."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "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."
        },
        {
          "label": "Upgrade existing",
          "body": "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."
        }
      ]
    },
    "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."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/hl-privateer-fund",
    "agentPageUrl": "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"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "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."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "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."
      },
      {
        "label": "Upgrade existing",
        "body": "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."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "HL Privateer -- Agent Skill",
        "body": "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.\n\nYou 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."
      },
      {
        "title": "Skill Files",
        "body": "This skill package contains the following files, all served at https://hlprivateer.xyz/skills/:\n\nFilePurposehl-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."
      },
      {
        "title": "Quick Start",
        "body": "Hit any agent endpoint: GET https://api.hlprivateer.xyz/v1/agent/stream/snapshot\nReceive 402 Payment Required with PAYMENT-REQUIRED header containing payment instructions\nDecode the header (Base64 JSON) to get price, network, payTo address, and facilitator URL\nCreate and sign an x402 payment payload for the specified amount (USDC on Base)\nRetry the same request with the PAYMENT-SIGNATURE header containing the signed payment (Base64 JSON)\nReceive data in the 200 response plus PAYMENT-RESPONSE settlement header"
      },
      {
        "title": "Base URLs",
        "body": "REST API: https://api.hlprivateer.xyz\nWebSocket: wss://ws.hlprivateer.xyz\nWeb UI: https://hlprivateer.xyz"
      },
      {
        "title": "x402 Payment Details",
        "body": "Network: Base (eip155:8453)\nAsset: USDC (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913)\nFacilitator: https://facilitator.payai.network\nProtocol: x402 v2 (exact scheme)\n\nSee x402.md in this directory for the full payment flow with curl examples."
      },
      {
        "title": "Paid Endpoints (x402)",
        "body": "All endpoints are GET requests against https://api.hlprivateer.xyz. Pay per call via x402."
      },
      {
        "title": "$0.01/call",
        "body": "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)"
      },
      {
        "title": "$0.02/call",
        "body": "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"
      },
      {
        "title": "$0.03/call",
        "body": "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"
      },
      {
        "title": "Free Endpoints (no payment required)",
        "body": "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"
      },
      {
        "title": "Example: Check Current PnL (free)",
        "body": "curl https://api.hlprivateer.xyz/v1/public/pnl\n\n{\n  \"pnlPct\": 1.92,\n  \"mode\": \"READY\",\n  \"updatedAt\": \"2026-02-13T16:20:00Z\"\n}"
      },
      {
        "title": "Copy Trading",
        "body": "Read positions and signals to mirror trades on your own account.\n\nPoll /v1/agent/positions for current positions ($0.01)\nPoll /v1/agent/copy/trade?kind=signals for entry/exit signals ($0.03)\nPoll /v1/agent/copy/trade?kind=positions for copy-formatted position data ($0.03)"
      },
      {
        "title": "Signal Integration",
        "body": "Consume analysis and risk signals to inform your own strategy.\n\nRead /v1/agent/analysis?latest=true for the latest strategist thesis ($0.01)\nRead /v1/agent/insights?scope=ai for full AI floor summary ($0.02)\nSubscribe to WebSocket at wss://ws.hlprivateer.xyz for real-time floor tape"
      },
      {
        "title": "Monitoring / Dashboard",
        "body": "Build a monitoring view or alerting system.\n\nFree: Poll /v1/public/floor-snapshot for mode, PnL, positions\nPaid: Read /v1/agent/stream/snapshot for richer health and ops data ($0.01)\nPaid: Read /v1/agent/insights?scope=market for risk config and signal timeline ($0.02)"
      },
      {
        "title": "Portfolio Composition Research",
        "body": "Understand how the desk constructs and manages its basket.\n\nRead /v1/agent/analysis for historical analysis entries ($0.01)\nRead /v1/agent/insights?scope=ai for the full AI dashboard ($0.02)\nRead /v1/agent/copy/trade?kind=signals for the full proposal audit trail ($0.03)"
      },
      {
        "title": "WebSocket Protocol",
        "body": "Connect to wss://ws.hlprivateer.xyz for real-time events."
      },
      {
        "title": "Subscribe to channels",
        "body": "{ \"type\": \"sub.add\", \"channel\": \"public.tape\" }"
      },
      {
        "title": "Receive events",
        "body": "{\n  \"type\": \"event\",\n  \"channel\": \"public.tape\",\n  \"payload\": {\n    \"eventType\": \"FLOOR_TAPE\",\n    \"role\": \"strategist\",\n    \"line\": \"LONG HYPE -- momentum breakout, funding neutral\"\n  }\n}"
      },
      {
        "title": "Client message types",
        "body": "TypePurposesub.addSubscribe to a channelsub.removeUnsubscribe from a channelcmd.execExecute a command (requires auth)pingKeepalive"
      },
      {
        "title": "Server message types",
        "body": "TypePurposesub.ackSubscription confirmedeventChannel event payloadcmd.resultCommand execution resulterrorError responsepongKeepalive response"
      },
      {
        "title": "How The Desk Works",
        "body": "HL Privateer runs autonomous agents on a single Hyperliquid account:\n\nStrategist: scans 50+ perp markets, generates long/short proposals with thesis and sizing\nResearch: regime hypotheses, macro context, funding analysis, social sentiment\nRisk: explains risk posture (advisory only -- hard-gated by deterministic risk engine)\nExecution: suggests tactics, annotates slippage expectations\nOps: monitors feeds, service health, circuit breakers (3s heartbeat)\nMarket Data: detects stale feeds, regime shifts, funding divergences\nScribe: produces audit narratives for each proposal cycle\n\nAll proposals pass through a deterministic risk engine (fail-closed) before execution. No agent can bypass risk limits. The human operator holds kill-switch authority."
      },
      {
        "title": "Runtime Modes",
        "body": "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)"
      },
      {
        "title": "Error Responses",
        "body": "All errors follow a standard envelope:\n\n{\n  \"error\": {\n    \"code\": \"RISK_DENY\",\n    \"message\": \"Proposal denied by max drawdown rule\",\n    \"requestId\": \"req_01J...\"\n  }\n}\n\nCommon error codes:\n\nCodeMeaningPAYMENT_REQUIREDx402 payment needed (HTTP 402)UNAUTHORIZEDMissing or invalid authenticationFORBIDDENInsufficient tier or capabilityRISK_DENYRisk engine denied the actionRATE_LIMITEDToo many requestsINTERNAL_ERRORServer error"
      },
      {
        "title": "Further Reading",
        "body": "Full API reference: https://hlprivateer.xyz/skills/api.md\nx402 payment guide: https://hlprivateer.xyz/skills/x402.md\nMachine-readable discovery: https://hlprivateer.xyz/skills/agents.json\nAgent-oriented quick start: https://hlprivateer.xyz/skills/llms.txt\nRoot agent index: https://hlprivateer.xyz/AGENT.md\nRoot LLM map: https://hlprivateer.xyz/llms.txt"
      }
    ],
    "body": "HL Privateer -- Agent Skill\n\nHL 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.\n\nYou 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.\n\nSkill Files\n\nThis skill package contains the following files, all served at https://hlprivateer.xyz/skills/:\n\nFile\tPurpose\nhl-privateer.md\tThis file. Primary skill definition with full instructions.\nllms.txt\tAgent-oriented quick start and endpoint catalog.\napi.md\tComplete REST + WebSocket API reference.\nx402.md\tx402 payment quickstart with example flows.\nagents.json\tMachine-readable OpenAgents v1 discovery document.\nQuick Start\nHit any agent endpoint: GET https://api.hlprivateer.xyz/v1/agent/stream/snapshot\nReceive 402 Payment Required with PAYMENT-REQUIRED header containing payment instructions\nDecode the header (Base64 JSON) to get price, network, payTo address, and facilitator URL\nCreate and sign an x402 payment payload for the specified amount (USDC on Base)\nRetry the same request with the PAYMENT-SIGNATURE header containing the signed payment (Base64 JSON)\nReceive data in the 200 response plus PAYMENT-RESPONSE settlement header\nBase URLs\nREST API: https://api.hlprivateer.xyz\nWebSocket: wss://ws.hlprivateer.xyz\nWeb UI: https://hlprivateer.xyz\nx402 Payment Details\nNetwork: Base (eip155:8453)\nAsset: USDC (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913)\nFacilitator: https://facilitator.payai.network\nProtocol: x402 v2 (exact scheme)\n\nSee x402.md in this directory for the full payment flow with curl examples.\n\nPaid Endpoints (x402)\n\nAll endpoints are GET requests against https://api.hlprivateer.xyz. Pay per call via x402.\n\n$0.01/call\nEndpoint\tWhat You Get\n/v1/agent/stream/snapshot\tMode, PnL%, health, open positions, recent ops tape\n/v1/agent/positions\tFull position array -- symbols, sides, sizes, entries, PnL\n/v1/agent/orders\tOpen orders on the book\n/v1/agent/analysis?latest=true\tLatest AI strategist analysis with thesis and signals\n/v1/agent/analysis\tAnalysis history (paginated, filterable by correlationId)\n$0.02/call\nEndpoint\tWhat You Get\n/v1/agent/insights?scope=market\tRisk config, signal timeline, account snapshot\n/v1/agent/insights?scope=ai\tFull dashboard: floor state, risk, analysis, copy summary\n$0.03/call\nEndpoint\tWhat You Get\n/v1/agent/copy/trade?kind=signals\tAudit trail of proposals, analysis, risk decisions, basket events\n/v1/agent/copy/trade?kind=positions\tPosition data formatted for copy-trading\nFree Endpoints (no payment required)\nEndpoint\tWhat You Get\n/v1/public/pnl\tCurrent PnL% and runtime mode\n/v1/public/floor-snapshot\tMode, PnL%, health, account value, positions, ops tape\n/v1/public/floor-tape\tRecent ops log lines from all agent roles\n/healthz\tService health check\nExample: Check Current PnL (free)\ncurl https://api.hlprivateer.xyz/v1/public/pnl\n\n{\n  \"pnlPct\": 1.92,\n  \"mode\": \"READY\",\n  \"updatedAt\": \"2026-02-13T16:20:00Z\"\n}\n\nAgent Use Cases\nCopy Trading\n\nRead positions and signals to mirror trades on your own account.\n\nPoll /v1/agent/positions for current positions ($0.01)\nPoll /v1/agent/copy/trade?kind=signals for entry/exit signals ($0.03)\nPoll /v1/agent/copy/trade?kind=positions for copy-formatted position data ($0.03)\nSignal Integration\n\nConsume analysis and risk signals to inform your own strategy.\n\nRead /v1/agent/analysis?latest=true for the latest strategist thesis ($0.01)\nRead /v1/agent/insights?scope=ai for full AI floor summary ($0.02)\nSubscribe to WebSocket at wss://ws.hlprivateer.xyz for real-time floor tape\nMonitoring / Dashboard\n\nBuild a monitoring view or alerting system.\n\nFree: Poll /v1/public/floor-snapshot for mode, PnL, positions\nPaid: Read /v1/agent/stream/snapshot for richer health and ops data ($0.01)\nPaid: Read /v1/agent/insights?scope=market for risk config and signal timeline ($0.02)\nPortfolio Composition Research\n\nUnderstand how the desk constructs and manages its basket.\n\nRead /v1/agent/analysis for historical analysis entries ($0.01)\nRead /v1/agent/insights?scope=ai for the full AI dashboard ($0.02)\nRead /v1/agent/copy/trade?kind=signals for the full proposal audit trail ($0.03)\nWebSocket Protocol\n\nConnect to wss://ws.hlprivateer.xyz for real-time events.\n\nSubscribe to channels\n{ \"type\": \"sub.add\", \"channel\": \"public.tape\" }\n\nReceive events\n{\n  \"type\": \"event\",\n  \"channel\": \"public.tape\",\n  \"payload\": {\n    \"eventType\": \"FLOOR_TAPE\",\n    \"role\": \"strategist\",\n    \"line\": \"LONG HYPE -- momentum breakout, funding neutral\"\n  }\n}\n\nClient message types\nType\tPurpose\nsub.add\tSubscribe to a channel\nsub.remove\tUnsubscribe from a channel\ncmd.exec\tExecute a command (requires auth)\nping\tKeepalive\nServer message types\nType\tPurpose\nsub.ack\tSubscription confirmed\nevent\tChannel event payload\ncmd.result\tCommand execution result\nerror\tError response\npong\tKeepalive response\nHow The Desk Works\n\nHL Privateer runs autonomous agents on a single Hyperliquid account:\n\nStrategist: scans 50+ perp markets, generates long/short proposals with thesis and sizing\nResearch: regime hypotheses, macro context, funding analysis, social sentiment\nRisk: explains risk posture (advisory only -- hard-gated by deterministic risk engine)\nExecution: suggests tactics, annotates slippage expectations\nOps: monitors feeds, service health, circuit breakers (3s heartbeat)\nMarket Data: detects stale feeds, regime shifts, funding divergences\nScribe: produces audit narratives for each proposal cycle\n\nAll proposals pass through a deterministic risk engine (fail-closed) before execution. No agent can bypass risk limits. The human operator holds kill-switch authority.\n\nRuntime Modes\nMode\tMeaning\nINIT\tStarting up, loading keys and config\nWARMUP\tCollecting initial market data window\nREADY\tFlat, watching for opportunities\nIN_TRADE\tActive long/short positions\nREBALANCE\tAdjusting position weights for parity\nHALT\tOperator-initiated stop\nSAFE_MODE\tAutomatic safety stop (dependency or data failure)\nError Responses\n\nAll errors follow a standard envelope:\n\n{\n  \"error\": {\n    \"code\": \"RISK_DENY\",\n    \"message\": \"Proposal denied by max drawdown rule\",\n    \"requestId\": \"req_01J...\"\n  }\n}\n\n\nCommon error codes:\n\nCode\tMeaning\nPAYMENT_REQUIRED\tx402 payment needed (HTTP 402)\nUNAUTHORIZED\tMissing or invalid authentication\nFORBIDDEN\tInsufficient tier or capability\nRISK_DENY\tRisk engine denied the action\nRATE_LIMITED\tToo many requests\nINTERNAL_ERROR\tServer error\nFurther Reading\nFull API reference: https://hlprivateer.xyz/skills/api.md\nx402 payment guide: https://hlprivateer.xyz/skills/x402.md\nMachine-readable discovery: https://hlprivateer.xyz/skills/agents.json\nAgent-oriented quick start: https://hlprivateer.xyz/skills/llms.txt\nRoot agent index: https://hlprivateer.xyz/AGENT.md\nRoot LLM map: https://hlprivateer.xyz/llms.txt"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/ADWilkinson/hl-privateer-fund",
    "publisherUrl": "https://clawhub.ai/ADWilkinson/hl-privateer-fund",
    "owner": "ADWilkinson",
    "version": "1.0.1",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "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"
  }
}