perp-cli

Installation
SKILL.md

perp-cli

Multi-DEX perpetual futures CLI + MCP server for Pacifica (Solana), Hyperliquid (HyperEVM), Lighter (Ethereum), and Aster (BNB Chain). v0.13.0+ also supports Hyperliquid Outcome markets (HIP-4) — fully-collateralized binary/range contracts quoted in USDH.

Instructions

When to use this skill

Activate whenever the user wants to do anything against perp-cli, including: scanning funding-rate arbitrage, executing perp-perp or spot+perp legs, running long-running strategy bots, moving USDC between chains/exchanges, checking account/portfolio state, configuring wallets, or troubleshooting any of the above.

Do NOT answer trading questions from memory — always run the actual CLI command and parse its JSON output.

Reference files (load only when needed)

This skill uses progressive disclosure. Read these on demand:

  • references/commands.md — full command tree for every group (market, account, trade, outcome, arb, funds, wallet, risk, history, strategy, background, alerts, settings, backtest)
  • references/agent-operations.md — non-interactive setup flows, idempotency rules, error codes, common mistakes
  • references/strategies.md — funding-arb decision framework + risk-management playbook (read before designing arb strategy)
Installs
28
GitHub Stars
25
First Seen
Mar 11, 2026