# Deliverator > The non-custodial Hyperliquid and Papertrade CLI your trading agent drives. > Single-binary Go CLI. Codename ref (Snow Crash): fast, precise, no-BS. - Site: https://deliverator.net - Source: https://github.com/erickuhn19/deliverator - Machine view: https://deliverator.net/llms.txt (this file) · https://deliverator.net/machine/ - Hyperliquid referral (4% off fees): https://app.hyperliquid.xyz/join/DELIVERATOR ## What it is Deliverator is the safe harness between an autonomous agent and a Hyperliquid account. It owns the hard, dangerous parts once — EIP-712 signing, nonce management, precision rounding, builder-fee attach, risk caps, rate-limit pacing — and exposes them as a disciplined, machine-parseable CLI. The agent decides WHAT to trade; Deliverator makes sure the HOW is correct, bounded, and auditable. ## Supported venues - Hyperliquid (main): perps and spot orders, TP/SL, batch, grid, chase, TWAP, copy-trading, reads, streams, risk gates. Outcome markets via the separate outcome-mm binary. - Papertrade (`deliverator papertrade`): isolated perps on HyperEVM (chain 999), REAL USDC. BTC and ETH only. Fills at the Hyperliquid mid. Min 10 USDC margin, $10,000 notional, $10 HyperCore deposit to the deposit proxy, then `papertrade deposit register`. The master wallet signs `papertrade session register` once (DELIVERATOR_MASTER_KEY, not stored); then the agent key opens, closes, cancels. Losses/liquidations mint PAPER. `papertrade stake|unstake|claim` (master wallet, --yes, venue minimum 1000 PAPER per stake). Not supported: Papertrade via `serve`; Papertrade builder codes (not live at the venue). ## Non-custodial guarantee It signs with a Hyperliquid agent/API wallet that physically CANNOT withdraw. - MASTER wallet: holds funds; signs deposits, withdrawals, approveAgent, approveBuilderFee. Stays in your browser/hardware. Never on the box. - AGENT key: no funds; signs orders, cancels, leverage, margin. Lives in the OS keychain. The worst a confused or compromised agent can do is place a bad trade — never move funds. That exclusion is the guarantee. ## Install (Go 1.25+, macOS/Linux) brew install --cask erickuhn19/tap/deliverator # or go install github.com/erickuhn19/deliverator@latest deliverator onboard # create account (4% off fees), store the agent key deliverator connect # preflight: keys, network, clock, api deliverator tools # print the machine contract (TOOLS.md) the LLM reads ## Strategies - loop [planned] — A self-running trade cycle — your agent is the brain, Deliverator the bounded hands. -> https://deliverator.net/strategies/loop/ - copy [live] — Mirror any public trader onto your own account — with your key and your guardrails. -> https://deliverator.net/strategies/copy-trading/ - outcome [planned] — Trade Hyperliquid HIP-4 outcome (prediction) markets — positions priced 0 to 1. -> https://deliverator.net/strategies/outcome-markets/ - grid [live] — A ladder of limit orders across a price range — placed as one signed action. -> https://deliverator.net/strategies/grid/ - brackets [live] — Entry plus a linked OCO take-profit / stop-loss, in one grouped action. -> https://deliverator.net/strategies/brackets/ - twap [live] — Slice a large order over time to cut market impact. -> https://deliverator.net/strategies/twap/ - carry [planned] — Harvest perp funding by holding the paid side — hedged and risk-gated. -> https://deliverator.net/strategies/funding-carry/ ## Command reference - setup: init, onboard, connect, version, config (path|get|set), account (ls|add|rm|set-default) - reads: snapshot, portfolio, positions, orders, "order status", fills, funding, ledger, balance, "pnl attribution", markets, ctx , book, bbo, mids, candles, limits, "builder status", "referral status", leaderboard, historical-orders, predicted-fundings, preview, reconcile, risk, info, schema, tools - writes: buy, sell, order, batch, grid, chase, modify, modify-batch, cancel, close, leverage, margin, twap (+ "twap cancel", "twap status"), position-tpsl, copy - safety: dms (dead-man switch), halt, panic, "referral apply" - ops: logs, watch, console, serve - papertrade: markets, summary, account, deposit-address, "deposit status", "deposit register", session, "session register", open, close, cancel, "intent status", resend, stake, unstake, claim - streams: stream — emits NDJSON, one object per line Full contract: `deliverator tools` (TOOLS.md) · JSON shapes: `deliverator schema `. ## Agent contract - One schema-v1 JSON envelope per command: { schema, ok, ts, cmd, data, error, warnings, meta } - Prices and sizes are ALWAYS strings. - Streams are NDJSON (one JSON object per line). - Branch on the EXIT CODE, never on prose: 0 ok | 10 validation | 11 precision | 20 risk-cap | 21 halted | 30 auth | 40 network | 41 rate-limited | 42 timeout | 50 exchange-rejected | 60 partial | 70 clock-skew - Idempotency: every write carries a client order id (cloid). On exit 42 (timeout), run `deliverator order status --cloid 0x...` BEFORE resubmitting — never blind-resubmit. ## Safety / risk caps (enforced in core, before signing) The agent key cannot withdraw. Hard caps: max order / position / account notional, max leverage, per-coin concentration, drawdown and daily-loss gates, reduce-only flip guard, dead-man's switch, global halt, panic flatten, local rate cap. Testnet-first; --dry-run. ## Verification The risk gauntlet, signing parity, precision rounding, envelope shape, and nonce handling are covered by the test suite in the repo — `go test ./...`. Read the checks rather than taking the claim on faith: https://github.com/erickuhn19/deliverator ## Links - Source: https://github.com/erickuhn19/deliverator - Issues: https://github.com/erickuhn19/deliverator/issues - Strategies: https://deliverator.net/#strategies - Approve the builder code: https://deliverator.net/approve/ - Hyperliquid (4% off fees): https://app.hyperliquid.xyz/join/DELIVERATOR