hyperliquid

Original：🇺🇸 English

Translated

5 scripts

Trade and monitor Hyperliquid perpetual futures. Check balances, view positions with P&L, place/cancel orders, execute market trades. Use when the user asks about Hyperliquid trading, portfolio status, crypto positions, or wants to execute trades on Hyperliquid.

1installs

Sourcesundial-org/awesome-openclaw-skills

Added on2026-02-18

NPX Install

npx skill4agent add sundial-org/awesome-openclaw-skills hyperliquid

SKILL.md Content

View Translation Comparison →

Hyperliquid Trading Skill

Full trading and portfolio management for Hyperliquid perpetual futures exchange.

Prerequisites

Install dependencies once:

bash

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

Core Operations

Portfolio Monitoring

Check balance:

bash

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

View positions with P&L:

bash

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

Check open orders:

bash

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

View trade history:

bash

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

Get price for a coin:

bash

node scripts/hyperliquid.mjs price BTC

Trading Operations

All trading commands require

HYPERLIQUID_PRIVATE_KEY

Place limit orders:

bash

# 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):

bash

# 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:

bash

# 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:

bash

node scripts/hyperliquid.mjs meta

Query other addresses:

bash

# 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

Hyperliquid Trading Skill

Full trading and portfolio management for Hyperliquid perpetual futures exchange.

Prerequisites

Install dependencies once:

bash

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

Core Operations

Portfolio Monitoring

Check balance:

bash

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

View positions with P&L:

bash

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

Check open orders:

bash

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

View trade history:

bash

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

Get price for a coin:

bash

node scripts/hyperliquid.mjs price BTC

Trading Operations

All trading commands require

HYPERLIQUID_PRIVATE_KEY

Place limit orders:

bash

# 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):

bash

# 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:

bash

# 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:

bash

node scripts/hyperliquid.mjs meta

Query other addresses:

bash

# 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

hyperliquid

NPX Install

Tags

SKILL.md Content

Hyperliquid Trading Skill

Prerequisites

Authentication

Core Operations

Portfolio Monitoring

Trading Operations

Output Formatting

Safety Guidelines

Error Handling

Workflow Examples

Advanced Features

Notes

hyperliquid

NPX Install

Tags

SKILL.md Content

Hyperliquid Trading Skill

Prerequisites

Authentication

Core Operations

Portfolio Monitoring

Trading Operations

Output Formatting

Safety Guidelines

Error Handling

Workflow Examples

Advanced Features

Notes