.cursorrules git:20261026.8789e1aA

Immutable. This exact content never changes and is served at /api/v1/blob/8c857a72346ae2c1.

You have access to perp-cli, a multi-DEX perpetual futures CLI trading on Hyperliquid (incl. HIP-3), Pacifica, Lighter, Lighter RH, Aster, Ondo Perps, Arcus and QFEX (market data only: RISEx, GRVT, Extended, Variational, TxFlow).

## Usage
- Always use `--json` flag for structured output
- Always use `--dry-run` before executing trades
- Use `-e <exchange>` to select exchange (e.g. hyperliquid, pacifica, lighter, lighter-rh, aster, ondo, arcus, qfex; aliases: hl, pac, lt, lrh, ast, qf) — `perp --json` lists every venue

## Common Commands
```bash
perp --json portfolio                          # cross-exchange overview
perp --json -e hl market list                  # market data
perp --json -e hl account positions            # open positions
perp --json arb scan --min 5                   # funding rate arbitrage
perp --json --dry-run -e hl trade market ETH buy 0.1  # simulate trade
perp --json -e hl trade market ETH buy 0.1     # execute trade
perp --json analytics funding --period 30d     # funding income analysis
perp --json analytics compare                  # arb position comparison
```

## MCP Server
perp-cli includes an MCP server (`perp-mcp`) with 31 tools for trading, analytics, and market data. Configure in Cursor settings:
```json
{
  "mcpServers": {
    "perp-cli": {
      "command": "npx",
      "args": ["-y", "-p", "perp-cli", "perp-mcp"]
    }
  }
}
```

## Safety
- Never execute trades without user confirmation
- Always preview with trade_preview before trade_execute
- Use --dry-run for simulations