laevitas cli

Real-time crypto derivatives data from your terminal. Built for humans and AI agents.

One CLI for the entire Laevitas market data surface — futures, perpetuals, options, spot, vol surfaces, prediction markets, live WebSocket streams, and multi-venue book dashboards. Stable JSON envelope for agents; rich TUI for humans. No SDK to learn.

Install

macOS · Linux

curl -sSL https://cli.laevitas.ch/install.sh | sh

Windows · PowerShell

irm https://cli.laevitas.ch/install.ps1 | iex

Homebrew

brew install laevitas/cli/laevitas

Scoop

scoop bucket add laevitas https://github.com/Laevitas/scoop-bucket && scoop install laevitas

Go

go install github.com/Laevitas/cli@latest

Verify & configure

$ laevitas version # confirm install $ laevitas config init # one-time API key setup $ laevitas doctor # validate auth + API + WebSocket health

What it does

Futures & perps — catalog, OHLCVT, open interest, funding/carry, liquidations
Options — flow, vol surface, IV / Greeks, skew, term structure
Spot — catalog, OHLCVT, ticker, L2 order book across major venues
Predictions — Polymarket probabilities, trades, snapshots
Live streams — WebSocket NDJSON for trades, ticker, book, liquidations
Dashboards — multi-venue book ladder, perp screener, options chain
x402 wallet — pay-per-request in USDC on Base, no API key required
Self-updating — laevitas update pulls the latest release

Quick examples

# Snapshot of every BTC perp across configured venues $ laevitas perps snapshot --currency BTC # BTC funding rate over the last 24 hours, with inline chart $ laevitas perps carry BTC-PERPETUAL -p 24h # Live trades on Binance perps, NDJSON to stdout $ laevitas ws perpetuals trades binance:BTCUSDT # Multi-venue order book ladder (live TUI) $ laevitas dash book perpetuals BTCUSDT # Vol surface across all maturities $ laevitas options vol-surface snapshot --currency BTC

For AI agents

Stable {success, data, meta} JSON envelope on every REST response. NDJSON for WebSocket streams. Machine-readable command manifest for first-run discovery. laevitas doctor reports environment state in JSON for diagnostic round-trips.

# Full command manifest — every path, flag, arg, example $ laevitas commands -o json | jq '.data.commands | length' 100+ # All streaming commands $ laevitas commands -o json | jq '.data.commands[] | select(.streaming) | .path' # Single record from a snapshot, agent-friendly $ laevitas perps snapshot --currency BTC -o json | jq '.data[0]' # Health report including binary path, config source, platform $ laevitas doctor -o json | jq '.data.summary, .data.env'

Upgrade

$ laevitas update # in-place upgrade to the latest release $ laevitas update --check # report current vs. latest, don't upgrade

GitHub CLI commands REST API (Swagger) REST API (Redoc) WebSocket protocol x402 payments API changelog