{
  "schemaVersion": "1.0",
  "item": {
    "slug": "hyperliquid-dex",
    "name": "Hyperliquid DEX Integration",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/Chipagosfinest/hyperliquid-dex",
    "canonicalUrl": "https://clawhub.ai/Chipagosfinest/hyperliquid-dex",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/hyperliquid-dex",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=hyperliquid-dex",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.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/hyperliquid-dex"
    },
    "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/hyperliquid-dex",
    "agentPageUrl": "https://openagent3.xyz/skills/hyperliquid-dex/agent",
    "manifestUrl": "https://openagent3.xyz/skills/hyperliquid-dex/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/hyperliquid-dex/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": "Hyperliquid DEX Integration",
        "body": "Query your Hyperliquid perpetuals account for real-time balances, open positions, unrealized PnL, and margin data."
      },
      {
        "title": "ClawdBot Integration",
        "body": "This skill is designed for ClawdBot - it calls ClawdBot's internal API server which proxies requests to the official Hyperliquid API at https://api.hyperliquid.xyz.\n\nArchitecture:\n\nUser → ClawdBot Gateway → ClawdBot API Server → Hyperliquid Public API\n                         (Railway)              (api.hyperliquid.xyz)\n\nThe ClawdBot API server handles:\n\nTimeout protection (15s)\nResponse parsing and formatting\nDefault wallet address from env vars"
      },
      {
        "title": "Capabilities",
        "body": "Account Overview: Get total account value, free collateral, and margin usage\nPosition Tracking: View all open perpetual positions with size, direction, entry price\nPnL Monitoring: Real-time unrealized PnL and return on equity per position\nRisk Management: Liquidation prices and leverage info for each position\nMulti-Wallet: Query any wallet address or use configured trading wallet"
      },
      {
        "title": "Environment Variables",
        "body": "VariableRequiredDescriptionTRADING_WALLET_ADDRESSNoDefault wallet address (0x format) to query when none provided"
      },
      {
        "title": "API Endpoint",
        "body": "ClawdBot Internal API:\n\nPOST {CLAWDBOT_API_URL}/api/hyperliquid/account\n\nUpstream API (called by ClawdBot):\n\nPOST https://api.hyperliquid.xyz/info"
      },
      {
        "title": "Request (Optional Body)",
        "body": "{\n  \"walletAddress\": \"0x...\"\n}\n\nIf no wallet address provided, uses TRADING_WALLET_ADDRESS env var."
      },
      {
        "title": "Response",
        "body": "{\n  \"timestamp\": \"2026-02-10T03:30:00.000Z\",\n  \"walletAddress\": \"0x...\",\n  \"account\": {\n    \"accountValue\": 10523.45,\n    \"totalPositionNotional\": 25000.00,\n    \"freeCollateral\": 5200.00,\n    \"totalMarginUsed\": 5323.45\n  },\n  \"positions\": [\n    {\n      \"coin\": \"ETH\",\n      \"direction\": \"long\",\n      \"size\": 2.5,\n      \"entryPrice\": 2450.00,\n      \"positionValue\": 6250.00,\n      \"unrealizedPnl\": 125.50,\n      \"returnOnEquity\": 0.024,\n      \"leverage\": { \"type\": \"cross\", \"value\": 5 },\n      \"liquidationPrice\": 1850.00,\n      \"marginUsed\": 1250.00\n    }\n  ],\n  \"positionCount\": 1\n}"
      },
      {
        "title": "Security Notes",
        "body": "Read-only: This skill only reads account data, no trading/signing capabilities\nPublic API: Uses Hyperliquid's public info API (no authentication required)\nNo private keys: Only wallet addresses (public) are used\nTimeout protected: 15-second timeout prevents hanging requests"
      },
      {
        "title": "Check Account Balance",
        "body": "\"What's my Hyperliquid balance?\"\n\"Show my HL account value\""
      },
      {
        "title": "View Positions",
        "body": "\"What positions do I have open on Hyperliquid?\"\n\"Am I in profit on my perps?\"\n\"What's my unrealized PnL?\""
      },
      {
        "title": "Risk Check",
        "body": "\"What are my liquidation prices on Hyperliquid?\"\n\"How much margin am I using?\"\n\"What leverage am I running?\""
      },
      {
        "title": "Related",
        "body": "Hyperliquid Docs\nichimoku - Ichimoku Cloud trading signals\nwallet-tracker - Monitor wallet balances across chains\ncrypto-tracker - Track crypto prices and portfolios"
      }
    ],
    "body": "Hyperliquid DEX Integration\n\nQuery your Hyperliquid perpetuals account for real-time balances, open positions, unrealized PnL, and margin data.\n\nClawdBot Integration\n\nThis skill is designed for ClawdBot - it calls ClawdBot's internal API server which proxies requests to the official Hyperliquid API at https://api.hyperliquid.xyz.\n\nArchitecture:\n\nUser → ClawdBot Gateway → ClawdBot API Server → Hyperliquid Public API\n                         (Railway)              (api.hyperliquid.xyz)\n\n\nThe ClawdBot API server handles:\n\nTimeout protection (15s)\nResponse parsing and formatting\nDefault wallet address from env vars\nCapabilities\nAccount Overview: Get total account value, free collateral, and margin usage\nPosition Tracking: View all open perpetual positions with size, direction, entry price\nPnL Monitoring: Real-time unrealized PnL and return on equity per position\nRisk Management: Liquidation prices and leverage info for each position\nMulti-Wallet: Query any wallet address or use configured trading wallet\nEnvironment Variables\nVariable\tRequired\tDescription\nTRADING_WALLET_ADDRESS\tNo\tDefault wallet address (0x format) to query when none provided\nAPI Endpoint\n\nClawdBot Internal API:\n\nPOST {CLAWDBOT_API_URL}/api/hyperliquid/account\n\n\nUpstream API (called by ClawdBot):\n\nPOST https://api.hyperliquid.xyz/info\n\nRequest (Optional Body)\n{\n  \"walletAddress\": \"0x...\"\n}\n\n\nIf no wallet address provided, uses TRADING_WALLET_ADDRESS env var.\n\nResponse\n{\n  \"timestamp\": \"2026-02-10T03:30:00.000Z\",\n  \"walletAddress\": \"0x...\",\n  \"account\": {\n    \"accountValue\": 10523.45,\n    \"totalPositionNotional\": 25000.00,\n    \"freeCollateral\": 5200.00,\n    \"totalMarginUsed\": 5323.45\n  },\n  \"positions\": [\n    {\n      \"coin\": \"ETH\",\n      \"direction\": \"long\",\n      \"size\": 2.5,\n      \"entryPrice\": 2450.00,\n      \"positionValue\": 6250.00,\n      \"unrealizedPnl\": 125.50,\n      \"returnOnEquity\": 0.024,\n      \"leverage\": { \"type\": \"cross\", \"value\": 5 },\n      \"liquidationPrice\": 1850.00,\n      \"marginUsed\": 1250.00\n    }\n  ],\n  \"positionCount\": 1\n}\n\nSecurity Notes\nRead-only: This skill only reads account data, no trading/signing capabilities\nPublic API: Uses Hyperliquid's public info API (no authentication required)\nNo private keys: Only wallet addresses (public) are used\nTimeout protected: 15-second timeout prevents hanging requests\nExample Usage\nCheck Account Balance\n\"What's my Hyperliquid balance?\"\n\"Show my HL account value\"\n\nView Positions\n\"What positions do I have open on Hyperliquid?\"\n\"Am I in profit on my perps?\"\n\"What's my unrealized PnL?\"\n\nRisk Check\n\"What are my liquidation prices on Hyperliquid?\"\n\"How much margin am I using?\"\n\"What leverage am I running?\"\n\nRelated\nHyperliquid Docs\nichimoku - Ichimoku Cloud trading signals\nwallet-tracker - Monitor wallet balances across chains\ncrypto-tracker - Track crypto prices and portfolios"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/Chipagosfinest/hyperliquid-dex",
    "publisherUrl": "https://clawhub.ai/Chipagosfinest/hyperliquid-dex",
    "owner": "Chipagosfinest",
    "version": "1.1.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/hyperliquid-dex",
    "downloadUrl": "https://openagent3.xyz/downloads/hyperliquid-dex",
    "agentUrl": "https://openagent3.xyz/skills/hyperliquid-dex/agent",
    "manifestUrl": "https://openagent3.xyz/skills/hyperliquid-dex/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/hyperliquid-dex/agent.md"
  }
}