hyperliquid

Executes Hyperliquid perp and spot trades, transfers, and account queries via the tribes-cli command group.

1|Updated Jun 17, 2026
One-click install
npx skills add https://github.com/tribes-protocol/trading-harness --skill hyperliquid-tribes-protocol
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: hyperliquid
Source: https://github.com/tribes-protocol/trading-harness/tree/main/skills/hyperliquid
Command: npx skills add https://github.com/tribes-protocol/trading-harness --skill hyperliquid-tribes-protocol

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Trading on Hyperliquid requires juggling dex discovery, base-unit sizing, bracket/TWAP/scale order mechanics, and strict wallet-signing rules; this Skill encodes all of those rules so an agent can discover markets, read account state, and execute orders on Hyperliquid without mis-sized orders, wrong dexes, or mismatched wallet IDs. ## Core Features & Use Cases - Market discovery and account state: List perp dexes and tradable perp/spot assets across all dexes, and query balances, positions, open orders, and fills for an EVM address. - Live execution: Place perp and Hyperliquid-spot orders with atomic TP/SL brackets, ladder entries via scale orders, time-sliced TWAP execution, cancellations, leverage and isolated-margin adjustments. - Fund movement: Deposit Arbitrum USDC through the Hyperliquid bridge, withdraw to EVM addresses, and transfer USDC or spot tokens between spot/perp wallets, dexes, and other users. - Use Case: A user asks to long $500 of a stock perp with a take-profit and stop-loss. The Skill resolves the hosting dex via list-assets --all-dexes, converts USD to base units using referencePx and szDecimals, and submits one trade-perp with --tp-px/--sl-px as an atomic OCO bracket. ## Quick Start Ask the agent to check your Hyperliquid positions and then place a bracketed perp order, for example: "Show my open Hyperliquid positions, then long $500 of BTC with a 5% take-profit and 3% stop-loss."

Frequently Asked Questions about hyperliquid

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I place a perp order on Hyperliquid with a take-profit and stop-loss?▼

Use trade-perp with --tp-px and --sl-px to attach an atomic OCO bracket to the entry in one command. The exits are reduce-only and sized to the entry, so one fill cancels the other with no unprotected window.

How do I trade stock or commodity perps on Hyperliquid?▼

Securities and commodities trade as perps on named Hyperliquid dexes. Run list-assets --all-dexes to find the exact hosting dex and coin (check the xyz dex first), then pass that dex to trade-perp --dex <name>; never hardcode a dex name.

How do I deposit USDC into Hyperliquid from Arbitrum?▼

Run the deposit command with --amount in decimal USDC (minimum 5) and your EVM wallet as --from; it bridges Arbitrum native USDC to Hyperliquid. If funds are on another chain or token, swap or bridge them to Arbitrum USDC first via the spot-trading skill.

Why was my TWAP or scale order rejected before signing?▼

Every TWAP sub-order and every scale leg must be at least $10 notional, and the CLI rejects undersized orders before signing. Increase --amount, or lower --duration-minutes for TWAP or --orders for scale, then retry.

Can this skill handle on-chain DEX swaps or cross-chain bridges?▼

No. The spot commands here only cover Hyperliquid's own spot exchange. On-chain DEX swaps, cross-chain bridges, wallet IDs and balances, and PnL history are handled by the spot-trading, zipbox-wallet, and wallet-analyst skills respectively.

Why do signed Hyperliquid commands fail with wallet or auth errors?▼

Signed commands require --from and --wallet-id from the same wallet: the evmWalletId must match the evmWalletAddress passed as --from. For auth errors, run tribes-cli login once, retry the command, and stop if it fails again.