Vulcan

Agent and human-friendly CLI for trading perpetual futures on Phoenix.

⚠️ Experimental software: live commands can execute irreversible financial transactions on Solana Mainnet. You are responsible for wallet security, agent permissions, and all trading outcomes.

What Vulcan Provides

• Account, margin, position, and order management for Phoenix perps.
• Local paper trading with live market prices and no wallet required.
• A local MCP server so agents can use Vulcan tools directly.
• First-class strategy runners for TWAP, grid trading, and TA.
• Bundled Agent Skills for Cursor, Claude Code, Codex, and Agentskills/OpenClaw-style clients.

Example Agent Prompts

“Give me a full portfolio snapshot: cross + isolated margin health, open positions with unrealized PnL %, resting orders, and any funding exposure I should know about.”

“Scan the top 5 markets on Phoenix by 24h volume — give me funding rate, mark price, and a one-line take on each.”

“Open a $200 long on SOL then attach a TP at +5% and SL at -3%.”

"I need to long $5,000 of SOL. Run a TWAP over 20 minutes in 10 slices.

“Watch BTC on 15m and alert me when EMA(9) crosses EMA(21), paper only”

“Build a TA strategy that goes long when RSI(14) crosses above 30 on the 5m and exits when it crosses 70. Paper mode first, $500 per entry”

Install

Install the latest release on macOS/Linux:

curl -fsSL https://github.com/Ellipsis-Labs/vulcan-cli/releases/latest/download/install.sh | sh

The installer verifies the release archive against vulcan-checksums-sha256.txt and installs to ~/.local/bin/vulcan by default. Make sure ~/.local/bin is on your PATH.

Install a specific version:

curl -fsSL https://github.com/Ellipsis-Labs/vulcan-cli/releases/download/v0.5.3/install.sh | sh

Build from source:

cargo install --path vulcan

Verify:

vulcan version

Check for newer releases:

vulcan update check

This is read-only — vulcan never modifies its own binary. When an update is available it prints a method-appropriate hint: re-run the install one-liner above for default or custom ~/.local/bin-style installs, or use your package manager for Homebrew/Nix/distro installs. Agents that load vulcan://agent/health see the same information under cli_update.

Quick Start

# Guided setup for config, wallet, registration, deposit, and agent options
vulcan setup

# Check installation, config, wallet, RPC/API, registration, and paper readiness
vulcan status -o json

# Read market data
vulcan market list -o json
vulcan market ticker SOL -o json

# Begin paper trading
vulcan paper init --balance 10000 -o json
vulcan paper buy SOL --notional-usdc 100 --type market -o json
vulcan paper status -o json

Agent Setup