Command Reference

Use markets and trade for perpetuals, and spot for spot trading and market data. The two products use separate market lookups; list markets for the selected product and network before placing an order.

Account commands

Manage locally stored trading accounts.

`account add`

Interactively add a new trading account.

decibel-cli account add

Prompts for subaccount address, account type (api-wallet or read-only), private key, alias, and default status. Keys are stored in ~/.decibel/data.db; they are only encrypted when a password is supplied, which this interactive flow does not currently prompt for.

`account ls`

List all stored accounts.

decibel-cli account ls [--json]

`account set-default`

Set the default account used when no --account flag is provided.

decibel-cli account set-default [alias]

If alias is omitted, an interactive picker is shown.

`account remove`

Remove a stored account.

decibel-cli account remove [alias] [-y]

Option	Description
`-y`	Skip confirmation

`account info`

Show account balances and equity.

decibel-cli account info [--json] [--account <alias>] [--network <network>]

Displays: subaccount address, account value, unrealized PnL, withdrawable balance, total margin, and maintenance margin.

Market commands

Query perpetual market data and prices. For spot, use spot markets ls, spot price, and spot book.

`markets ls`

List all available perpetual markets.

decibel-cli markets ls [--json] [--network <network>]

Displays: market name, max leverage, tick size, min size, and trading mode. tickSize is in price units; minSize and lotSize are in base-asset units, matching order inputs. JSON output also includes rawTickSize, rawMinSize, and rawLotSize as on-chain integers, plus sizeDecimals and priceDecimals. Do not pass the raw values as order sizes or prices.

`markets price`

Get the current price for a market.

decibel-cli markets price <symbol> [--json] [--network <network>] [-w]

Argument	Description
`symbol`	Market symbol (e.g., `BTC/USD`)

Option	Description
`-w`	Watch price in real-time via WebSocket

Displays: mark price, oracle price, funding rate, and open interest.

`markets book`

View the order book for a market.

decibel-cli markets book <symbol> [--json] [--network <network>] [-w] [--depth <n>]

Option	Default	Description
`-w`		Watch orderbook in real-time
`--depth <n>`	`10`	Number of price levels to show

Displays: color-coded bid/ask levels with size and depth bars.

Trade commands

Place perpetual orders, manage positions, and view perpetual trading history.

Place orders

`trade order limit`

Place a limit order.

decibel-cli trade order limit <side> <size> <symbol> <price> [options]

Argument	Description
`side`	`buy`, `sell`, `long`, or `short`
`size`	Order size (e.g., `0.01`)
`symbol`	Market symbol (e.g., `BTC/USD`)
`price`	Limit price

Option	Default	Description
`--tif <tif>`	`gtc`	Time in force: `gtc`, `post-only`, `ioc`
`--reduce-only`	`false`	Reduce-only order
`--client-id <id>`		Client order ID for tracking

# Buy 0.01 BTC at $50,000 limit
decibel-cli trade order limit buy 0.01 BTC/USD 50000

# Post-only sell order
decibel-cli trade order limit sell 0.5 ETH/USD 4000 --tif post-only

`trade order market`

Place a market order.

decibel-cli trade order market <side> <size> <symbol> [options]

Argument	Description
`side`	`buy`, `sell`, `long`, or `short`
`size`	Order size
`symbol`	Market symbol

Option	Default	Description
`--slippage <pct>`	`1`	Max slippage percentage
`--reduce-only`	`false`	Reduce-only order
`--client-id <id>`		Client order ID for tracking

decibel-cli trade order market buy 0.01 BTC/USD
decibel-cli trade order market sell 1 ETH/USD --slippage 0.5

`trade order stop-limit`

Place a stop limit order. Triggers at the stop price and executes at the limit price.

decibel-cli trade order stop-limit <side> <size> <symbol> <price> <stopPrice> [options]

Argument	Description
`side`	`buy`, `sell`, `long`, or `short`
`size`	Order size
`symbol`	Market symbol
`price`	Limit price (execution price)
`stopPrice`	Trigger price

Option	Default	Description
`--tif <tif>`	`gtc`	Time in force: `gtc`, `post-only`, `ioc`
`--reduce-only`	`false`	Reduce-only order
`--client-id <id>`		Client order ID for tracking

decibel-cli trade order stop-limit sell 0.01 BTC/USD 49000 49500

`trade order stop-market`

Place a stop market order. Triggers at the stop price and executes immediately.

decibel-cli trade order stop-market <side> <size> <symbol> <stopPrice> [options]

Argument	Description
`side`	`buy`, `sell`, `long`, or `short`
`size`	Order size
`symbol`	Market symbol
`stopPrice`	Trigger price

Option	Default	Description
`--slippage <pct>`	`1`	Slippage percentage from stop price
`--reduce-only`	`false`	Reduce-only order
`--client-id <id>`		Client order ID for tracking

decibel-cli trade order stop-market sell 0.01 BTC/USD 49000

`trade order twap`

Place a TWAP (Time-Weighted Average Price) order. Splits the order into smaller sub-orders over a duration.

decibel-cli trade order twap <side> <size> <symbol> --duration <seconds> --frequency <seconds> [options]

Argument	Description
`side`	`buy`, `sell`, `long`, or `short`
`size`	Total order size
`symbol`	Market symbol

Option	Default	Description
`--duration <seconds>`		Total execution duration: 120 (2 min) to 86400 (24 hrs)
`--frequency <seconds>`		Interval between sub-orders: at least 60, and no more than duration
`--reduce-only`	`false`	Reduce-only order

Values outside these bounds are rejected before the order is submitted.

# Buy 1 BTC over 10 minutes, placing sub-orders every minute
decibel-cli trade order twap buy 1 BTC/USD --duration 600 --frequency 60

Cancel orders

`trade cancel`

Cancel a specific open order.

decibel-cli trade cancel <orderId> --market <symbol> [options]

Argument	Description
`orderId`	The order ID to cancel

Option	Description
`--market <symbol>`	Market symbol

`trade cancel-all`

Cancel all open orders.

decibel-cli trade cancel-all [--market <symbol>] [options]

Option	Description
`--market <symbol>`	Cancel only orders in this market
`-y, --yes`	Skip confirmation prompt

`trade cancel-twap`

Cancel an active TWAP order.

decibel-cli trade cancel-twap <orderId> --market <symbol> [options]

Close positions

`trade close`

Close an open position at market price.

decibel-cli trade close <symbol> [options]

Argument	Description
`symbol`	Market symbol (e.g., `BTC/USD`)

Option	Default	Description
`--slippage <pct>`	`1`	Max slippage percentage
`--size <size>`	Full position	Partial close size (omit for full close)

TP/SL (Take-Profit / Stop-Loss)

`trade tp-sl set`

Set take-profit and/or stop-loss for a position.

decibel-cli trade tp-sl set <symbol> [options]

Argument	Description
`symbol`	Market symbol

Option	Description
`--tp-trigger <price>`	Take-profit trigger price
`--sl-trigger <price>`	Stop-loss trigger price
`--tp-limit <price>`	Take-profit limit price
`--sl-limit <price>`	Stop-loss limit price
`--tp-size <size>`	Take-profit size (omit for full position)
`--sl-size <size>`	Stop-loss size (omit for full position)

decibel-cli trade tp-sl set BTC/USD --tp-trigger 55000 --sl-trigger 45000

`trade tp-sl ls`

List active TP/SL orders for a position.

decibel-cli trade tp-sl ls <symbol> [--json]

`trade tp-sl cancel`

Cancel a TP/SL order.

decibel-cli trade tp-sl cancel <orderId> --market <symbol>

Configuration

`trade set-leverage`

Set leverage for a market.

decibel-cli trade set-leverage <symbol> <leverage>

Argument	Description
`symbol`	Market symbol
`leverage`	Leverage multiplier (e.g., `10`)

Option	Default	Description
`--cross`	`true`	Use cross margin
`--isolated`		Use isolated margin

decibel-cli trade set-leverage BTC/USD 10

`trade set-margin`

Set the margin type for a market.

decibel-cli trade set-margin <symbol> <type>

Argument	Description
`symbol`	Market symbol
`type`	`cross` or `isolated`

decibel-cli trade set-margin BTC/USD cross

View trading data

`trade positions`

List open positions.

decibel-cli trade positions [--json] [-w]

Option	Description
`-w`	Watch positions in real-time via WebSocket

`trade orders`

List open orders.

decibel-cli trade orders [--json] [-w]

Option	Description
`-w`	Watch orders in real-time via WebSocket

`trade active-twaps`

List active TWAP orders.

decibel-cli trade active-twaps [--json]

`trade history`

View trade fill history.

decibel-cli trade history [--json] [--limit <n>]

`trade order-history`

View order history (all states: filled, cancelled, etc.).

decibel-cli trade order-history [--json] [--limit <n>]

`trade twap-history`

View TWAP order history.

decibel-cli trade twap-history [--json] [--limit <n>]

`trade funding-history`

View funding rate payment history.

decibel-cli trade funding-history [--json] [--limit <n>]

Spot commands

Trade spot assets and query spot-only market and account data. Symbols are case-insensitive and must exist in spot markets ls on the selected network. Spot orders accept only buy and sell. Sizes are positive quantities of the base asset, and prices are positive amounts of the quote asset per base unit. For example, buy 10 APT/USDC 5.2 buys 10 APT at a limit of 5.20 USDC per APT. Use the market’s normalized minSize, lotSize, and tickSize to check order inputs. Spot commands do not support long/short, leverage, margin settings, position closing, reduce-only, stop orders, TP/SL, TWAP, or client order IDs.

Common spot options

Option	Applies to	Description
`--json`	All spot commands	Output JSON in non-watch mode
`--network <network>`	All spot commands	Select `mainnet`, `testnet`, or `local`
`--account <alias>`	Order placement, cancellation, and account data	Use a stored account instead of the default
`--encrypt`	Order placement and cancellation	Submit an encrypted, mempool-private transaction

Spot uses the same authentication and account configuration as perpetuals. Market data needs only a Node API key; account queries also need a subaccount address, and placement/cancellation require a signing account.

Place spot orders

`spot order limit`

Place a spot limit order.

decibel-cli spot order limit <side> <size> <symbol> <price> [options]

Argument	Description
`side`	`buy` or `sell`
`size`	Positive order size in base-asset units
`symbol`	Spot market symbol (e.g., `APT/USDC`)
`price`	Positive limit price in quote-asset units

Option	Default	Description
`--tif <tif>`	`gtc`	Time in force: `gtc`, `post-only`, or `ioc`

Prices are aligned to the market tick down for buys and up for sells, so rounding never crosses your requested limit. A price that rounds to zero is rejected before submission.

decibel-cli spot order limit buy 10 APT/USDC 5.2
decibel-cli spot order limit sell 10 APT/USDC 5.5 --tif post-only

`spot order market`

Submit an immediate-or-cancel (IOC) limit order at a slippage-adjusted price. Spot has no separate on-chain market order type.

decibel-cli spot order market <side> <size> <symbol> [options]

Argument	Description
`side`	`buy` or `sell`
`size`	Positive order size in base-asset units
`symbol`	Spot market symbol (e.g., `APT/USDC`)

Option	Default	Description
`--slippage <pct>`	`1`	Slippage percentage: 0–100 for buys; 0 up to, but not including, 100 for sells

The reference price comes from the midpoint of a two-sided order book, falling back to the asset-context midpoint and then the last trade. A one-sided book is not used as a reference. If no positive reference price is available, the command fails; use a limit order with an explicit price instead. The buy cap is referencePrice * (1 + slippage / 100); the sell floor is referencePrice * (1 - slippage / 100). The submitted price is then rounded down for buys or up for sells to the market tick. This preserves the slippage bound but can prevent a fill, particularly with zero slippage or a coarse tick. A zero submitted price is rejected. JSON output includes referencePrice and the actual tick-aligned limitPrice. A buy reserves size * limitPrice of the quote asset, not size * referencePrice. An IOC order fills immediately, partially fills and cancels the remainder, or cancels without filling; it never rests in spot orders.

decibel-cli spot order market buy 10 APT/USDC --slippage 0.5 --json
decibel-cli spot order market sell 10 APT/USDC --slippage 1

Queued placement

Both placement commands can return pendingCbs: true when funding needs a rate-limited collateral withdrawal. The transaction succeeded, but the order is queued, not placed. The CLI prints QUEUED rather than reporting placement success. Neither a successful transaction nor a returned order ID proves the order filled.

Track the returned orderId with spot order-history for its final state and spot history for fills. GTC/post-only orders can also appear in spot orders once they rest. IOC orders never appear there, so an empty open-orders list does not establish their outcome.

Cancel spot orders

`spot cancel`

Cancel a spot order by ID and market, including an order still queued behind a collateral withdrawal.

decibel-cli spot cancel <orderId> --market <symbol> [options]

Argument / option	Required	Description
`orderId`	Yes	Spot order ID returned at placement
`--market <symbol>`	Yes	Spot market symbol

`spot cancel-all`

Cancel open spot orders, optionally scoped to one market. Perpetual orders are not affected.

decibel-cli spot cancel-all [--market <symbol>] [options]

Option	Description
`--market <symbol>`	Cancel only orders in this spot market
`-y, --yes`	Skip the confirmation prompt

Cancellation pages through open orders and repeats from the start to reach orders beyond a single pagination window. JSON results report cancelled, failed, and total counts of distinct attempted orders; inspect all three instead of assuming every cancellation succeeded.

Incomplete: The sweep could not finish or confirm the remaining orders. The error includes the number already cancelled; re-run to continue.
Unreachable: With --market, other markets’ orders can fill the API pagination window and hide remaining matching orders. The error reports partial progress. Re-running the same filtered command cannot reach the hidden orders; cancel them individually by ID. Removing the filter cancels orders on every spot market, so only do that intentionally.

spot cancel-all only sweeps the open-orders feed. Orders queued behind collateral withdrawals (pendingCbs) are absent and can execute later. Cancel queued orders individually with spot cancel <orderId> --market <symbol>; a successful sweep does not mean the account has no remaining live orders or holdings.

View spot account data

`spot orders`

List resting spot orders, following pagination.

decibel-cli spot orders [--json] [-w] [--account <alias>] [--network <network>]

Option	Description
`-w, --watch`	Watch open spot orders in real time via WebSocket

Snapshot JSON has the shape { orders, truncated }. When truncated is true, the listing is limited by the API pagination window and must not be treated as the complete set. The CLI displays a warning. Queued orders and IOC orders are not included.

`spot balances`

View spot holdings, USD value, entry notional (recorded cost basis), unrealized PnL, and assets reserved by open orders.

decibel-cli spot balances [--json] [--account <alias>] [--network <network>]

JSON includes positions, inFlightOrders, totalUsd, unrealizedPnlUsd, and lifetime metrics for volume, maker/taker fees, and realized PnL when available. Entry notional is a total cost basis, not a per-unit average cost. Lifetime metrics can remain available even with no current holdings.

`spot history`

View spot trade fills, including market, action, size, price, and fee.

decibel-cli spot history [--json] [--limit <n>] [--account <alias>] [--network <network>]

--limit defaults to 20 and accepts integers from 1 to 100.

`spot order-history`

View spot order history across all order states, including filled and cancelled orders. Use this alongside spot history to track queued and IOC orders.

decibel-cli spot order-history [--json] [--limit <n>] [--account <alias>] [--network <network>]

--limit defaults to 20 and accepts integers from 1 to 200.

Spot market data

`spot markets ls`

List spot markets and their order constraints.

decibel-cli spot markets ls [--json] [--network <network>]

Displays market name, tick size, minimum size, lot size, and trading mode. tickSize is in quote-asset units; minSize and lotSize are in base-asset units, matching order inputs. JSON also includes rawTickSize, rawMinSize, and rawLotSize as on-chain integers, plus baseDecimals and quoteDecimals. Do not use raw values as order inputs. Spot markets have no leverage.

`spot price`

Get a spot market’s last/mid price and 24-hour statistics.

decibel-cli spot price <symbol> [--json] [--network <network>]

Returns last price, midpoint, previous-day price, percentage change, high/low, and base/quote volume. midPrice is null unless both book sides have resting liquidity; lastPrice, high24h, and low24h are null without a trade in the last 24 hours. Percentage change is null without a usable baseline. The CLI displays unavailable prices as n/a, not zero. Spot price data has no funding rate, open interest, mark price, or oracle price. This command is a snapshot and has no watch option.

`spot book`

Fetch a spot orderbook snapshot via WebSocket.

decibel-cli spot book <symbol> [--json] [--depth <n>] [--network <network>]

--depth defaults to 10 and accepts integers from 1 to 20. Returns bids, asks, best bid/ask, spread, and spread percentage. Spread is unavailable when either side is empty. This command has no watch option.

The CLI also includes a built-in MCP server for AI agent integration. See the MCP Server Tool Reference for the full list of MCP tools.

​Account commands

​account add

​account ls

​account set-default

​account remove

​account info

​Market commands

​markets ls

​markets price

​markets book

​Trade commands

​Place orders

​trade order limit

​trade order market

​trade order stop-limit

​trade order stop-market

​trade order twap

​Cancel orders

​trade cancel

​trade cancel-all

​trade cancel-twap

​Close positions

​trade close

​TP/SL (Take-Profit / Stop-Loss)

​trade tp-sl set

​trade tp-sl ls

​trade tp-sl cancel

​Configuration

​trade set-leverage

​trade set-margin

​View trading data

​trade positions

​trade orders

​trade active-twaps

​trade history

​trade order-history

​trade twap-history

​trade funding-history

​Spot commands

​Common spot options

​Place spot orders

​spot order limit

​spot order market

​Queued placement

​Cancel spot orders

​spot cancel

​spot cancel-all

​View spot account data

​spot orders

​spot balances

​spot history

​spot order-history

​Spot market data

​spot markets ls

​spot price

​spot book

Account commands

`account add`

`account ls`

`account set-default`

`account remove`

`account info`

Market commands

`markets ls`

`markets price`

`markets book`

Trade commands

Place orders

`trade order limit`

`trade order market`

`trade order stop-limit`

`trade order stop-market`

`trade order twap`

Cancel orders

`trade cancel`

`trade cancel-all`

`trade cancel-twap`

Close positions

`trade close`

TP/SL (Take-Profit / Stop-Loss)

`trade tp-sl set`

`trade tp-sl ls`

`trade tp-sl cancel`

Configuration

`trade set-leverage`

`trade set-margin`

View trading data

`trade positions`

`trade orders`

`trade active-twaps`

`trade history`

`trade order-history`

`trade twap-history`

`trade funding-history`

Spot commands

Common spot options

Place spot orders

`spot order limit`

`spot order market`

Queued placement

Cancel spot orders

`spot cancel`

`spot cancel-all`

View spot account data

`spot orders`

`spot balances`

`spot history`

`spot order-history`

Spot market data

`spot markets ls`

`spot price`

`spot book`