• deepbook account:

- details - list - balance - import [privateKey] - use

• deepbook stream:

- trades

• deepbook spot:

- pools - buy - sell - limit

• deepbook swap:

- base-for-quote - quote-for-base

• deepbook margin:

- pools - managers - deposit - market - limit - position - close

• deepbook manager:

- ls - create - deposit - withdraw - balance

Command cheat sheet (required args/options)

• deepbook providers
• deepbook pools
• deepbook orderbook
• deepbook trades
• deepbook ohlcv
• deepbook stream trades
• deepbook spot pools
• deepbook spot buy --quantity [--price ] [--manager ]
• deepbook spot sell --quantity [--price ] [--manager ]
• deepbook spot limit --side --price --quantity [--manager ]
• deepbook spot limit --cancel [--manager ]

• deepbook config show
• deepbook config set-network
• deepbook config set-provider
• deepbook config set-rpc-url
• deepbook config set-address
• deepbook config set-trade-cap
• deepbook config set-read-key [apiKey] (or --stdin)
• deepbook config set-stream-key [apiKey] (or --stdin)
• deepbook config set-provider-base-url
• deepbook config set-provider-stream-base-url
• deepbook config import-key [privateKey] (or --stdin, optional --alias)

• deepbook account details
• deepbook account list
• deepbook account balance [--coin ]
• deepbook account import [privateKey] (or --stdin)
• deepbook account use

• deepbook swap base-for-quote --amount
• deepbook swap quote-for-base --amount

• deepbook margin pools
• deepbook margin managers
• deepbook margin deposit --coin --amount [--margin-manager ]
• deepbook margin market --side --quantity [--margin-manager ]
• deepbook margin limit --side --price --quantity [--margin-manager ]
• deepbook margin position [--margin-manager ]
• deepbook margin close [--margin-manager ] + either:

- --full - OR --side --quantity

• deepbook manager ls
• deepbook manager create
• deepbook manager deposit --coin --amount [--manager ]
• deepbook manager withdraw --coin --amount [--manager ]
• deepbook manager balance --coin [--manager ]

Key margin close flags

• deepbook margin close --full --withdraw
• deepbook margin close --full --non-reduce-only
• deepbook margin close --side --quantity --reduce-only --no-repay

Swap vs spot market buy

• Swap (deepbook swap quote-for-base) is a direct pool swap with exact-input semantics.
• Spot market buy (deepbook spot buy --quantity ...) is an orderbook market order and uses a balance manager.
• CLI output now includes execution.kind and execution.type/direction so the mode is explicit.

Safety defaults

• Prefer --dry-run first for all state-changing commands.
• Validate pool key and manager object ID before placing/canceling orders.
• SUI-involved deposit/collateral paths split from gas coin inside the transaction automatically.
• Never print or log private keys.
• Margin manager type safety:

- Margin managers are generic typed objects: MarginManager. - The margin manager type must match the exact pool pair being traded. - Example: MarginManager works with DEEP_USDC, not DEEP_SUI.

• Margin manager resolution behavior:

- If --margin-manager is omitted, CLI auto-selects a compatible manager for that pool, or creates one in-transaction if none exists. - If --margin-manager is provided, CLI treats it as explicit and strict: it must match signer + pool; no fallback or auto-create is performed.

• Internal margin fee buffer behavior:

- Margin market/limit orders auto-deposit a fee buffer before placing the order. - With --no-pay-with-deep, buffer is deposited in trade asset collateral (base for sell, quote for buy). - Without --no-pay-with-deep, buffer is deposited as DEEP into the margin manager.

• Full-close quantity normalization:

- deepbook margin close --full now auto-normalizes inferred quantity to pool lot-size/min-size. - If reduce-only full close cannot satisfy lot-size exactly, CLI auto-switches to non-reduce-only and rounds up, then repays debt in the same transaction. - If user explicitly passes --reduce-only, CLI keeps reduce-only semantics and errors when full close cannot be represented as a valid lot-size quantity.

End-to-end spot trading flow (fund -> buy -> withdraw)

Use this when executing a real spot trade through a balance manager.

1. Discover balance managers:

- deepbook manager ls

1. If none exist, create one:

- deepbook manager create

1. Deposit quote coin to manager (for DEEP_SUI buy, fund SUI):

- deepbook manager deposit --coin SUI --amount 1 --manager

1. Optional balance check:

- deepbook manager balance --coin SUI --manager

1. Simulate buy first:

- deepbook spot buy DEEP_SUI --quantity 38 --manager --no-pay-with-deep --dry-run

1. Execute live buy:

- deepbook spot buy DEEP_SUI --quantity 38 --manager --no-pay-with-deep

1. Withdraw purchased asset to signer address (or explicit recipient):

- deepbook manager withdraw --coin DEEP --amount 38 --manager - optional recipient: --recipient