bullpen hyperliquid¶
Last updated: May 29, 2026
Hyperliquid perp trading, account reads, and order workflows (experimental)
Usage¶
Subcommands¶
| Subcommand | Description |
|---|---|
status |
Show account positions and balances |
price |
Show mark price, funding, OI, and volume for a single market |
markets |
List available perpetual markets |
mids |
Show current mid prices for all active markets |
orderbook |
Show L2 orderbook for a market |
funding |
Show current funding rates for all markets, or your funding payment history |
funding-history |
Show historical funding rates for a market |
candles |
Show OHLCV candle data for a market |
balances |
Show spot + perp balance and equity breakdown |
fees |
Show current fee rates and fee schedule |
stats |
Show stable account stats from Hyperliquid portfolio history |
topology |
Show account topology, including role, vaults, subaccounts, and extra agents |
orders |
Show open orders for an address |
frontend-orders |
Show rich frontend open orders, including trigger and child order detail |
order-status |
Show the current status for a single order by OID or client order ID |
order-history |
Show historical orders for an address |
watch |
Watch live Hyperliquid market or account updates |
transfer |
Transfer USDC between Hyperliquid spot and perp balances (requires hyperliquid_trading feature) |
withdraw |
Withdraw USDC from Hyperliquid to the authenticated signer wallet (requires hyperliquid_trading feature) |
deposit |
Deposit USDC from Arbitrum into Hyperliquid Spot |
take-profit |
Place a reduce-only take-profit order for an existing position (requires hyperliquid_trading feature) |
stop-loss |
Place a reduce-only stop-loss order for an existing position (requires hyperliquid_trading feature) |
long |
Open a long position (requires hyperliquid_trading feature) |
short |
Open a short position (requires hyperliquid_trading feature) |
scale |
Place a multi-level Hyperliquid limit ladder in one signed action |
close |
Close a position fully or partially (requires hyperliquid_trading feature) |
close-all |
Flatten every open Hyperliquid position with one batched reduce-only action (requires hyperliquid_trading feature) |
cancel |
Cancel one resting order by numeric OID (requires hyperliquid_trading feature) |
cancel-all |
Cancel all open orders, optionally for a single coin (requires hyperliquid_trading feature) |
leverage |
Set leverage for a coin (requires hyperliquid_trading feature) |
modify |
Modify a resting order's price and/or size (requires hyperliquid_trading feature) |
cancel-by-cloid |
Cancel a resting order by client order ID (requires hyperliquid_trading feature) |
schedule-cancel |
Set or clear a dead-man's-switch cancel-all trigger (requires hyperliquid_trading feature) |
update-margin |
Add or remove isolated margin for a position (requires hyperliquid_trading feature) |
Live Help¶
Hyperliquid perp trading, account reads, and order workflows (experimental)
Usage: bullpen hyperliquid [OPTIONS] <COMMAND>
Commands:
status Show account positions and balances
price Show mark price, funding, OI, and volume for a single market
markets List available perpetual markets
mids Show current mid prices for all active markets
orderbook Show L2 orderbook for a market
funding Show current funding rates for all markets, or your funding payment history
funding-history Show historical funding rates for a market
candles Show OHLCV candle data for a market
balances Show spot + perp balance and equity breakdown
fees Show current fee rates and fee schedule
stats Show stable account stats from Hyperliquid portfolio history
topology Show account topology, including role, vaults, subaccounts, and extra agents
orders Show open orders for an address
frontend-orders Show rich frontend open orders, including trigger and child order detail
order-status Show the current status for a single order by OID or client order ID
order-history Show historical orders for an address
watch Watch live Hyperliquid market or account updates
transfer Transfer USDC between Hyperliquid spot and perp balances (requires hyperliquid_trading feature)
withdraw Withdraw USDC from Hyperliquid to the authenticated signer wallet (requires hyperliquid_trading feature)
deposit Deposit USDC from Arbitrum into Hyperliquid Spot
take-profit Place a reduce-only take-profit order for an existing position (requires hyperliquid_trading feature)
stop-loss Place a reduce-only stop-loss order for an existing position (requires hyperliquid_trading feature)
long Open a long position (requires hyperliquid_trading feature)
short Open a short position (requires hyperliquid_trading feature)
scale Place a multi-level Hyperliquid limit ladder in one signed action
close Close a position fully or partially (requires hyperliquid_trading feature)
close-all Flatten every open Hyperliquid position with one batched reduce-only action (requires hyperliquid_trading feature)
cancel Cancel one resting order by numeric OID (requires hyperliquid_trading feature)
cancel-all Cancel all open orders, optionally for a single coin (requires hyperliquid_trading feature)
leverage Set leverage for a coin (requires hyperliquid_trading feature)
modify Modify a resting order's price and/or size (requires hyperliquid_trading feature)
cancel-by-cloid Cancel a resting order by client order ID (requires hyperliquid_trading feature)
schedule-cancel Set or clear a dead-man's-switch cancel-all trigger (requires hyperliquid_trading feature)
update-margin Add or remove isolated margin for a position (requires hyperliquid_trading feature)
help Print this message or the help of the given subcommand(s)
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]
--env <ENV>
Target environment to connect to (overrides config.toml)
[env: BULLPEN_ENV=]
[possible values: staging, production]
--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')