non-custodial execution layer · hyperliquid · papertrade
██████╗ ███████╗██╗ ██╗██╗ ██╗███████╗██████╗ █████╗ ████████╗ ██████╗ ██████╗ ██╔══██╗██╔════╝██║ ██║██║ ██║██╔════╝██╔══██╗██╔══██╗╚══██╔══╝██╔═══██╗██╔══██╗ ██║ ██║█████╗ ██║ ██║██║ ██║█████╗ ██████╔╝███████║ ██║ ██║ ██║██████╔╝ ██║ ██║██╔══╝ ██║ ██║╚██╗ ██╔╝██╔══╝ ██╔══██╗██╔══██║ ██║ ██║ ██║██╔══██╗ ██████╔╝███████╗███████╗██║ ╚████╔╝ ███████╗██║ ██║██║ ██║ ██║ ╚██████╔╝██║ ██║ ╚═════╝ ╚══════╝╚══════╝╚═╝ ╚═══╝ ╚══════╝╚═╝ ╚═╝╚═╝ ╚═╝ ╚═╝ ╚═════╝ ╚═╝ ╚═╝
The non-custodial Hyperliquid & Papertrade CLI your trading agent drives.
brew install --cask erickuhn19/tap/deliverator
go install github.com/erickuhn19/deliverator@latest
git clone https://github.com/erickuhn19/deliverator && cd deliverator && go build -o deliverator .
Go 1.25+ · macOS/Linux · no backend · no telemetry
what_it_is
A safe harness between your agent & the chain
Deliverator owns the hard, dangerous parts once — EIP-712 signing, nonce management, precision rounding, builder attach, risk caps, rate-limit pacing — and exposes them as a disciplined, machine-parseable CLI. Your agent decides what to trade; Deliverator makes sure the how is correct, bounded, and auditable.
Non-custodial by construction: it signs with an agent key that physically cannot withdraw. The worst a confused or compromised agent can do is place a bad trade — never move your funds.
supported_venues
Where it trades
Perps and spot: market, limit, IOC, post-only, trigger, TP/SL brackets, batch, grid, chase, TWAP, copy-trading. Outcome markets are listed and quoted by the separate outcome-mm binary. Signed by an agent key that cannot withdraw; risk caps in config.toml.
Isolated perps on HyperEVM with real USDC. BTC and ETH only, opens fill at the Hyperliquid mid, high leverage up to the venue maximum. Minimums: 10 USDC margin, $10,000 notional, $10 deposit. Losses mint PAPER.
deliverator papertrade open --coin BTC --side long --margin 10 --leverage 1000
Stake, unstake, and claim USDC rewards. Signed by your master wallet via DELIVERATOR_MASTER_KEY, read per command and never stored. The venue's minimum is 1000 PAPER per stake.
deliverator papertrade stake --amount 1000 --yes
Papertrade setup: fund the address from papertrade deposit-address with USDC on HyperCore, run papertrade deposit register, then sign papertrade session register once with your master key so the agent key can trade. Deliverator never moves funds, and Papertrade builder codes are not live yet. Deliverator's default risk.max_leverage is 10, so raise it to use high leverage.
strategies
What your agent can run
Composable strategies, each bounded by the same risk caps and idempotent retry protocol. Click in for the playbook.
A self-running trade cycle — your agent is the brain, Deliverator the bounded hands.
deliverator snapshot --json
cat ./loop →
Mirror any public trader onto your own account — with your key and your guardrails.
deliverator copy 0xLEADER --execute
cat ./copy →
Trade Hyperliquid HIP-4 outcome (prediction) markets — positions priced 0 to 1.
deliverator buy "ELECTION-YES" --notional 200 --limit 0.62
cat ./outcome →
A ladder of limit orders across a price range — placed as one signed action.
deliverator grid ETH buy --from 3400 --to 3000 --levels 8
cat ./grid →
Entry plus a linked OCO take-profit / stop-loss, in one grouped action.
deliverator buy SOL --notional 250 --tp 180 --sl 140
cat ./brackets →
Slice a large order over time to cut market impact.
deliverator twap BTC buy 2 --minutes 30
cat ./twap →
Harvest perp funding by holding the paid side — hedged and risk-gated.
deliverator ctx ETH --json
cat ./carry →
get_started
Four steps to live
From zero to an agent trading your Hyperliquid account.
-
01
Create your Hyperliquid account
Sign up with the Deliverator referral — 4% off trading fees.
Sign up for Hyperliquid -
02
Create an Agent API key
In Hyperliquid: More → API → generate a wallet, then Authorize. (Or let
open the API page →deliverator onboardwalk you through it.) The agent key trades but cannot withdraw. -
03
Sign the builder code
One signature in your own wallet authorizes Deliverator's tiny builder fee. No gas, no funds move — capped and revocable.
sign the builder code → - 04
agent_first
Built for an LLM, not a human
One JSON object per command. Branch on the exit code, never on prose. Hard risk caps live in core, before signing — a hallucination can't exceed them. The agent contract is the product.
Deterministic
One schema-v1 JSON envelope per command; NDJSON for streams; prices & sizes always strings.
Branchable
A documented exit code per outcome — 0 ok, 20 risk, 41 rate, 42 timeout, 50 reject…
Idempotent
Every write carries a client order id. The #1 way naive agents double-fill — closed.
Self-correcting
Errors are actionable text with concrete numbers, not stack traces.
Bounded
Hard risk caps + a dead-man's switch, halt, and panic. The agent key can't withdraw.
Self-describing
markets · schema · tools · version — capability discovered at runtime.