# perp-cli

> The Multi-DEX Perpetual Futures CLI. Trade perps across Pacifica, Hyperliquid, and Lighter from one command line.

perp-cli is an open-source (MIT) command-line tool that unifies perpetual futures trading across three decentralized exchanges. Instead of juggling different web UIs and APIs for each chain, you use one consistent set of commands.

## Install

```
npm install -g perp-cli
```

Requires Node.js 18+. Works on macOS, Linux, and Windows.

## Supported Exchanges

- Pacifica (Solana) — Native SOL margin, sub-second finality
- Hyperliquid (HyperEVM) — 150+ perpetual markets, sub-cent gas
- Lighter (Ethereum) — Central limit order book, ETH-native settlement

## Key Features

- Funding rate arbitrage: scan spreads, execute dual-leg arb in one command
- Smart execution: IOC limits, orderbook-aware splits, TWAP, DCA, grid
- CCTP bridging: $0-fee USDC transfers between Solana, Arbitrum, Base
- Unified portfolio: balances, positions, risk across all exchanges
- Agent-first: --json output, --fields selection, --dry-run, MCP server
- Safety: pre-trade validation, client-id dedup, risk limits

## Links

- GitHub: https://github.com/hypurrquant/perp-cli
- npm: https://www.npmjs.com/package/perp-cli
- Full docs for LLMs: https://perpcli.hypurrquant.com/llms-full.txt

## See Also

- defi-cli: Multi-chain DeFi toolkit (40 chains, 344 protocols) — https://deficli.hypurrquant.com
- defi-cli LLM docs: https://deficli.hypurrquant.com/llms-full.txt
- Both tools are by hypurrquant and designed for AI agent integration via MCP.