Perp Cli

What is Perp Cli?

Perp Cli is a multi-DEX perpetual futures CLI for Pacifica (Solana), Hyperliquid (HyperEVM), and Lighter (Ethereum). It provides trading, arbitrage scanning, portfolio management, bots, and an MCP server for AI agent integration.

How to use Perp Cli?

Install globally with npm install -g perp-cli, set exchange keys using perp wallet set, then run commands such as perp --json portfolio. For MCP server use npx -y perp-cli perp-mcp in your MCP client config.

Key features of Perp Cli

• Trade, bridge, and arbitrage across three DEXes
• Funding rate arbitrage scan with one-command dual-leg execution
• Unified portfolio view across all exchanges
• Bots: TWAP, grid, DCA, trailing-stop with background job management
• Agent‑first CLI with structured JSON output and runtime schema introspection
• Pre‑trade validation, response sanitization, and client‑id deduplication
• MCP server with 18 tools – market data without API keys

Use cases of Perp Cli

• Scan and execute funding rate arbitrage opportunities across exchanges
• Manage cross‑exchange portfolio and risk exposure from one CLI
• Deploy automated trading bots (TWAP, grid, DCA) with background daemons
• Integrate perpetual futures commands into AI agents via MCP protocol
• Bridge USDC across chains and manage deposits/withdrawals

FAQ from Perp Cli

What exchanges does Perp Cli support?

Pacifica (Solana), Hyperliquid (HyperEVM), and Lighter (Ethereum).

Do I need API keys to use Perp Cli?

No API keys are required for market data commands. Keys are only needed to trade or access account data.

How do I set up Perp Cli for trading?

Run perp wallet set hl <EVM_KEY> for Hyperliquid, perp wallet set pac <SOLANA_KEY> for Pacifica, and perp wallet set lt <EVM_KEY> for Lighter. The same EVM key works for Hyperliquid and Lighter.

What is the MCP server included with Perp Cli?

It's a full MCP server (18 tools, 3 resources, 2 prompts) that allows Claude Desktop, Cursor, and other MCP clients to run Perp Cli commands. Read‑only tools require no keys.

How can I get structured JSON output from Perp Cli?

Use the --json flag on any command to get a JSON envelope with ok, data, and meta fields. Use --fields to filter specific fields and --ndjson for streaming lists.