# Send Hyperliquid Trading & Analysis 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. Then review README.md for any prerequisites, environment setup, or post-install checks. 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. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "hyperliquid-trading",
    "name": "Hyperliquid Trading & Analysis",
    "source": "tencent",
    "type": "skill",
    "category": "数据分析",
    "sourceUrl": "https://clawhub.ai/anajuliabit/hyperliquid-trading",
    "canonicalUrl": "https://clawhub.ai/anajuliabit/hyperliquid-trading",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/hyperliquid-trading",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=hyperliquid-trading",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "references/api.md",
      "scripts/analyze-coingecko.mjs",
      "scripts/analyze-market.mjs",
      "scripts/check-positions.mjs"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "hyperliquid-trading",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-29T15:36:14.582Z",
      "expiresAt": "2026-05-06T15:36:14.582Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=hyperliquid-trading",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=hyperliquid-trading",
        "contentDisposition": "attachment; filename=\"hyperliquid-trading-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "hyperliquid-trading"
      },
      "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-trading"
    },
    "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-trading",
    "downloadUrl": "https://openagent3.xyz/downloads/hyperliquid-trading",
    "agentUrl": "https://openagent3.xyz/skills/hyperliquid-trading/agent",
    "manifestUrl": "https://openagent3.xyz/skills/hyperliquid-trading/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/hyperliquid-trading/agent.md"
  }
}
```
## Documentation

### Hyperliquid Trading Skill

Full trading and portfolio management for Hyperliquid perpetual futures exchange.

### Prerequisites

Install dependencies once:

cd skills/hyperliquid/scripts && npm install

### Authentication

For read-only operations (balance, positions, prices):

Set HYPERLIQUID_ADDRESS environment variable
No private key needed

For trading operations:

Set HYPERLIQUID_PRIVATE_KEY environment variable
Address derived automatically from private key

Testnet:

Set HYPERLIQUID_TESTNET=1 to use testnet

### Portfolio Monitoring

Check balance:

HYPERLIQUID_ADDRESS=0x... node scripts/hyperliquid.mjs balance

View positions with P&L:

HYPERLIQUID_ADDRESS=0x... node scripts/hyperliquid.mjs positions

Check open orders:

HYPERLIQUID_ADDRESS=0x... node scripts/hyperliquid.mjs orders

View trade history:

HYPERLIQUID_ADDRESS=0x... node scripts/hyperliquid.mjs fills

Get price for a coin:

node scripts/hyperliquid.mjs price BTC

### Trading Operations

All trading commands require HYPERLIQUID_PRIVATE_KEY.

Place limit orders:

# Buy 0.1 BTC at $45,000
HYPERLIQUID_PRIVATE_KEY=0x... node scripts/hyperliquid.mjs buy BTC 0.1 45000

# Sell 1 ETH at $3,000
HYPERLIQUID_PRIVATE_KEY=0x... node scripts/hyperliquid.mjs sell ETH 1 3000

Market orders (with 5% slippage protection):

# Market buy 0.5 BTC
HYPERLIQUID_PRIVATE_KEY=0x... node scripts/hyperliquid.mjs market-buy BTC 0.5

# Market sell 2 ETH
HYPERLIQUID_PRIVATE_KEY=0x... node scripts/hyperliquid.mjs market-sell ETH 2

Cancel orders:

# Cancel specific order
HYPERLIQUID_PRIVATE_KEY=0x... node scripts/hyperliquid.mjs cancel BTC 12345

# Cancel all orders
HYPERLIQUID_PRIVATE_KEY=0x... node scripts/hyperliquid.mjs cancel-all

# Cancel all orders for specific coin
HYPERLIQUID_PRIVATE_KEY=0x... node scripts/hyperliquid.mjs cancel-all BTC

### Output Formatting

All commands output JSON. Parse and format for chat display:

For balance/portfolio:

Show total equity, available balance
List positions with size, entry price, unrealized P&L
Summarize open orders

For trade execution:

Confirm order details before executing
Report order ID and status after execution
Show filled price if immediately executed

### Safety Guidelines

Before executing trades:

Confirm trade parameters with user (coin, size, direction, price)
Show current price and position for context
Calculate estimated cost/proceeds

Position sizing:

Warn if trade is >20% of account equity
Suggest appropriate sizes based on account balance

Price checks:

For limit orders, compare limit price to current market price
Warn if limit price is >5% away from market (likely mistake)

### Error Handling

Common errors:

"Address required" → Set HYPERLIQUID_ADDRESS or HYPERLIQUID_PRIVATE_KEY
"Private key required" → Trading needs HYPERLIQUID_PRIVATE_KEY
"Unknown coin" → Check available coins with meta command
HTTP errors → Check network connection and API status

When errors occur:

Show the error message to user
Suggest fixes (set env vars, check coin names, verify balance)
Don't retry trades automatically

### Workflow Examples

"How's my Hyperliquid portfolio?"

Run balance to get total equity
Run positions to get open positions
Format summary: equity, positions with P&L, total unrealized P&L

"Buy 0.5 BTC on Hyperliquid"

Run price BTC to get current price
Run balance to verify sufficient funds
Confirm with user: "Buy 0.5 BTC at market? Current price: $X. Estimated cost: $Y"
Execute market-buy BTC 0.5
Report order result

"What's the current BTC price on Hyperliquid?"

Run price BTC
Format response: "BTC: $X on Hyperliquid"

"Close my ETH position"

Run positions to get current ETH position size
If long → market-sell, if short → market-buy
Execute with position size
Report result

### Advanced Features

List all available coins:

node scripts/hyperliquid.mjs meta

Query other addresses:

# Check someone else's positions (read-only, public data)
node scripts/hyperliquid.mjs positions 0x1234...

### Notes

All sizes are in base currency (BTC, ETH, etc.)
Prices are in USD
Market orders use limit orders with 5% slippage protection
Hyperliquid uses perpetual futures, not spot trading
Check references/api.md for full API documentation
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: anajuliabit
- Version: 1.0.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-04-29T15:36:14.582Z
- Expires at: 2026-05-06T15:36:14.582Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/hyperliquid-trading)
- [Send to Agent page](https://openagent3.xyz/skills/hyperliquid-trading/agent)
- [JSON manifest](https://openagent3.xyz/skills/hyperliquid-trading/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/hyperliquid-trading/agent.md)
- [Download page](https://openagent3.xyz/downloads/hyperliquid-trading)