bullpen hyperliquid pair setup¶
Last updated: July 13, 2026
Provision/read the Pear agent wallet and approve required Hyperliquid agent/builder permissions
Usage¶
Live Help¶
Provision/read the Pear agent wallet and approve required Hyperliquid agent/builder permissions
Usage: bullpen hyperliquid pair setup [OPTIONS]
Options:
--no-multi-wallet-warning
Suppress the table-mode warning shown when multiple EVM wallet accounts exist
--output <OUTPUT>
Output format for command results
[possible values: table, json]
--preview
Show planned setup without signing or submitting
--env <ENV>
Target environment to connect to (overrides config.toml)
[env: BULLPEN_ENV=]
[possible values: staging, production]
-y, --yes
Required confirmation flag for live Pear setup
--config <CONFIG>
Path to a custom config.toml file (overrides $BULLPEN_CONFIG and the default location).
Explicit --config and BULLPEN_CONFIG paths fail closed: if the file is missing, the CLI exits validation instead of silently loading defaults. Credentials still resolve via BULLPEN_HOME, so set BULLPEN_HOME too when isolating a session.
--read-only
Enable read-only mode: blocks all mutating commands
--non-interactive
Suppress interactive prompts; does NOT imply --yes for money-moving commands
[env: BULLPEN_NON_INTERACTIVE=]
-h, --help
Print help (see a summary with '-h')
EXAMPLES:
# Preview Pear setup without signing or submitting
bullpen hyperliquid pair setup --preview
# Enable Pear pair trading for the active Hyperliquid account
bullpen hyperliquid pair setup --yes
PEAR PREREQUISITES:
Use `bullpen status --output json` and `bullpen doctor auth --output json`
to confirm the active Bullpen-managed EVM wallet. Run `bullpen login` only
when diagnostics report login is required. Enable `hyperliquid` for reads/status and
`hyperliquid_trading` before live setup, approvals, orders, or cancels.
`pair login --yes` is Pear session login; it is not a substitute for Bullpen
login.
SAFETY:
Setup is explicit. Preview never signs, creates a Pear agent wallet, approves
a Hyperliquid agent, or approves Pear builder fees. Live setup may sign
Pear auth, POST /agentWallet, approve the named Hyperliquid agent
pear-pair-trade, and approve Pear's builder address/rate. Setup/deposit
blockers return guidance before signing or submitting.
Example Commands¶
JSON Output¶
Contract: JSON Output Contract.
This command supports --output json, but this generated reference page intentionally does not include a synthetic success schema or example.
Use the live command in your target environment to inspect command-specific success fields. Error output follows the shared JSON output contract linked above.
Schema version: 1 when a command emits schema_version; otherwise treat the current command shape as contract version 1.
Stability¶
Patch releases may add nullable or optional fields. Minor releases may add required fields or increment schema_version. Major releases may remove or rename fields.