--- name: perpl description: Trade on Perpl DEX - view markets, manage positions, execute trades model: haiku allowed-tools: Bash(npm run dev:*) argument-hint: [args...] --- # Perpl Trading Skill Execute PerplBot CLI commands directly. ## Usage Pass CLI arguments directly after `\/perpl`: ``` \/perpl [subcommand] [options] ``` ## Execution If `$ARGUMENTS` is `help`, display the command list below instead of running CLI. Otherwise, run the following command with $ARGUMENTS passed through: ```bash npm run dev -- $ARGUMENTS ``` ## Available Commands (display this for `\/perpl help`) ``` manage markets - Show prices and funding rates manage status - Show account balance and positions manage deposit --amount N - Deposit USD collateral manage withdraw --amount N - Withdraw USD collateral trade open --perp --side --size N --price N --leverage N trade close --perp --side --size N --price N trade cancel --perp --order-id trade cancel-all --perp show book --perp - Show order book show trades --perp - Show recent trades show liquidation --perp - Liquidation price simulator show liquidation --perp --fork - Fork-verified liquidation (Anvil) debug - Replay & decode transaction (Anvil) simulate strategy --strategy grid --perp --levels 5 --spacing 100 --size 0.001 --leverage 2 simulate strategy --strategy mm --perp --size 0.001 --spread 0.1 --leverage 2 Options: --ioc (market order), --post-only (maker only), --dry-run (simulate) Markets: btc, eth, sol, mon, zec Natural Language: Use \/perpl-type for plain English commands Examples: \/perpl-type show me my account \/perpl-type long 0.01 btc at 78000 5x \/perpl-type cancel all eth orders ``` ## Command Details ### manage - `manage markets` - Show prices and funding rates - `manage status` - Show account balance and positions - `manage deposit --amount ` - Deposit USD collateral - `manage withdraw --amount ` - Withdraw USD collateral ### trade - `trade open --perp --side --size --price --leverage ` - Open position - `trade close --perp --side --size --price ` - Close position - `trade cancel --perp --order-id ` - Cancel order - `trade cancel-all --perp ` - Cancel all orders ### show - `show book --perp ` - Show order book for a market - `show trades --perp ` - Show recent trades for a market - `show liquidation --perp ` - Liquidation price simulator (pure math) - `show liquidation --perp --fork` - Fork-verified liquidation (requires Anvil) - `show liquidation --perp --range ` - Custom sweep range (default 30%) ### debug (requires Anvil) - `debug ` - Replay transaction on fork, decode events, explain what happened - `debug --json` - Output raw JSON result ### simulate (requires Anvil) - `simulate strategy --strategy grid --perp --levels N --spacing N --size N --leverage N` - `simulate strategy --strategy mm --perp --size N --spread N --leverage N` - `simulate strategy --strategy grid --perp --spacing N --size N --json` ### Options - `--ioc` - Immediate-or-cancel (market order) - `--post-only` - Maker only - `--dry-run` - Simulate trade on Anvil fork (no real transaction) ## Markets - btc, eth, sol, mon, zec ## Examples ``` \/perpl manage status \/perpl manage markets \/perpl trade open --perp btc --side long --size 0.001 --price 75000 --leverage 2 \/perpl trade close --perp btc --side long --size 0.001 --price 80000 \/perpl trade cancel-all --perp btc \/perpl show book --perp btc \/perpl show trades --perp eth --limit 10 \/perpl show liquidation --perp btc \/perpl show liquidation --perp btc --fork --range 50 \/perpl debug 0x1234...abcd \/perpl simulate strategy --strategy grid --perp btc --levels 5 --spacing 100 --size 0.001 --leverage 2 ```