Skip to main content

By Zach

Perps CLI

An open source Rust CLI for perpetual futures trading across 11 venues, with one interface for market data, execution, risk controls, and automation.

  • perps
  • cli
  • perpetual-dex
  • hyperliquid
  • risk-management
  • defi
  • trading
  • automation
  • rust

Perps v0.3.0 is an open source Rust CLI for perpetual futures trading across 11 venues.

It brings market data, execution, risk controls, and automation into one interface.

Perpetual trading infrastructure is still fragmented. Every venue has its own API, authentication model, and operational quirks. Teams that work across venues keep rebuilding the same integration layer.

Perps makes that layer consistent.

This release adds prebuilt binaries for macOS, Linux, and Windows, along with an HTTP gateway and terminal UI — a shared command surface across DEX and CEX venues, with structured JSON output and support for automated workflows.

# macOS / Linux
curl --proto '=https' --tlsv1.2 -LsSf \
  https://github.com/raintree-technology/perps/releases/latest/download/perps-installer.sh | sh
 
# Windows
powershell -ExecutionPolicy ByPass -c \
  "irm https://github.com/raintree-technology/perps/releases/latest/download/perps-installer.ps1 | iex"
 
perps --help
perps connector ls
perps ops doctor
 
perps universe list
perps market ticker BTC --connector hyperliquid
perps funding scan --asset BTC
 
perps account balances
perps account positions --connector decibel
 
perps order submit hyperliquid BTC-PERP long --type limit 0.01 --limit-price 50000 --dry-run

Every command returns structured JSON with typed response envelopes, normalized exit codes, and shared flags for request IDs, strategy IDs, and risk limits — so scripts, bots, and agents can parse output without scraping. An HTTP gateway extends the same interface to service-based integrations.

perps gateway serve --host 127.0.0.1 --port 4020

One misconfigured order across venues with no guardrails is an expensive mistake. Perps enforces environment-based credentials, dry-run order previews, and pre-trade controls for leverage, drawdown, position size, and notional limits. Optional SQLite persistence adds local state and journaling.

The command surface covers the full trading lifecycle — from market data and funding scans through execution (including TWAP and batch orders) to portfolio views, margin health, simulation, and journaling.

Perps v0.3.0 supports:

  • Hyperliquid
  • Decibel
  • Aevo
  • Orderly
  • Paradex
  • dYdX V4
  • Vertex
  • GMX V2
  • Binance USDM
  • Bybit
  • OKX

Perps is built for manual workflows, scripted checks, and agent-driven trading systems.

Start with dry runs. Add strict risk controls. Build on one interface instead of eleven.

FAQ

What is Perps CLI?
Perps is a Rust-based command-line platform for perpetual trading workflows, including market data, funding analysis, orders, account state, risk checks, gateway automation, and a terminal UI.
Which exchanges are supported natively?
Version 0.3.0 supports 11 venues: Hyperliquid, Decibel, Aevo, Orderly, Paradex, dYdX V4, Vertex, GMX V2, Binance USDM, Bybit, and OKX.
Is Perps CLI safe to use with real credentials?
Credentials load from environment variables, the project documents no telemetry, and order workflows support dry runs plus configurable pre-trade risk limits.
Can I automate Perps in bots and CI?
Yes. Commands support machine-readable JSON output, typed exit codes, a shared contract envelope, and an HTTP gateway for bot and agent workflows.