# Send Hyperliquid DEX Integration 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": "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": {
    "downloadUrl": "/downloads/hyperliquid-dex",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=hyperliquid-dex",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "hyperliquid-dex",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-04T06:48:41.966Z",
      "expiresAt": "2026-05-11T06:48:41.966Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=hyperliquid-dex",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=hyperliquid-dex",
        "contentDisposition": "attachment; filename=\"hyperliquid-dex-1.1.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "hyperliquid-dex"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "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."
      ]
    }
  },
  "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"
  }
}
```
## Documentation

### Hyperliquid DEX Integration

Query your Hyperliquid perpetuals account for real-time balances, open positions, unrealized PnL, and margin data.

### ClawdBot Integration

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.

Architecture:

User → ClawdBot Gateway → ClawdBot API Server → Hyperliquid Public API
                         (Railway)              (api.hyperliquid.xyz)

The ClawdBot API server handles:

Timeout protection (15s)
Response parsing and formatting
Default wallet address from env vars

### Capabilities

Account Overview: Get total account value, free collateral, and margin usage
Position Tracking: View all open perpetual positions with size, direction, entry price
PnL Monitoring: Real-time unrealized PnL and return on equity per position
Risk Management: Liquidation prices and leverage info for each position
Multi-Wallet: Query any wallet address or use configured trading wallet

### Environment Variables

VariableRequiredDescriptionTRADING_WALLET_ADDRESSNoDefault wallet address (0x format) to query when none provided

### API Endpoint

ClawdBot Internal API:

POST {CLAWDBOT_API_URL}/api/hyperliquid/account

Upstream API (called by ClawdBot):

POST https://api.hyperliquid.xyz/info

### Request (Optional Body)

{
  "walletAddress": "0x..."
}

If no wallet address provided, uses TRADING_WALLET_ADDRESS env var.

### Response

{
  "timestamp": "2026-02-10T03:30:00.000Z",
  "walletAddress": "0x...",
  "account": {
    "accountValue": 10523.45,
    "totalPositionNotional": 25000.00,
    "freeCollateral": 5200.00,
    "totalMarginUsed": 5323.45
  },
  "positions": [
    {
      "coin": "ETH",
      "direction": "long",
      "size": 2.5,
      "entryPrice": 2450.00,
      "positionValue": 6250.00,
      "unrealizedPnl": 125.50,
      "returnOnEquity": 0.024,
      "leverage": { "type": "cross", "value": 5 },
      "liquidationPrice": 1850.00,
      "marginUsed": 1250.00
    }
  ],
  "positionCount": 1
}

### Security Notes

Read-only: This skill only reads account data, no trading/signing capabilities
Public API: Uses Hyperliquid's public info API (no authentication required)
No private keys: Only wallet addresses (public) are used
Timeout protected: 15-second timeout prevents hanging requests

### Check Account Balance

"What's my Hyperliquid balance?"
"Show my HL account value"

### View Positions

"What positions do I have open on Hyperliquid?"
"Am I in profit on my perps?"
"What's my unrealized PnL?"

### Risk Check

"What are my liquidation prices on Hyperliquid?"
"How much margin am I using?"
"What leverage am I running?"

### Related

Hyperliquid Docs
ichimoku - Ichimoku Cloud trading signals
wallet-tracker - Monitor wallet balances across chains
crypto-tracker - Track crypto prices and portfolios
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: Chipagosfinest
- Version: 1.1.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-04T06:48:41.966Z
- Expires at: 2026-05-11T06:48:41.966Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/hyperliquid-dex)
- [Send to Agent page](https://openagent3.xyz/skills/hyperliquid-dex/agent)
- [JSON manifest](https://openagent3.xyz/skills/hyperliquid-dex/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/hyperliquid-dex/agent.md)
- [Download page](https://openagent3.xyz/downloads/hyperliquid-dex)