Skip to main content

​
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. Private keys are encrypted at rest in ~/.decibel/data.db.

​
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]
OptionDescription
-ySkip 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 market data and prices.

​
markets ls

List all available markets. 
decibel-cli markets ls [--json] [--network <network>]
Displays: market name, max leverage, tick size, min size, and trading mode.

​
markets price

Get the current price for a market. 
decibel-cli markets price <symbol> [--json] [--network <network>] [-w]
ArgumentDescription
symbolMarket symbol (e.g., BTC/USD)
OptionDescription
-wWatch 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>]
OptionDefaultDescription
-wWatch orderbook in real-time
--depth <n>10Number of price levels to show
Displays: color-coded bid/ask levels with size and depth bars.

​
Trade commands

Place orders, manage positions, and view trading history.

​
Place orders

​
trade order limit

Place a limit order. 
decibel-cli trade order limit <side> <size> <symbol> <price> [options]
ArgumentDescription
sidebuy, sell, long, or short
sizeOrder size (e.g., 0.01)
symbolMarket symbol (e.g., BTC/USD)
priceLimit price
OptionDefaultDescription
--tif <tif>gtcTime in force: gtc, post-only, ioc
--reduce-onlyfalseReduce-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]
ArgumentDescription
sidebuy, sell, long, or short
sizeOrder size
symbolMarket symbol
OptionDefaultDescription
--slippage <pct>1Max slippage percentage
--reduce-onlyfalseReduce-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]
ArgumentDescription
sidebuy, sell, long, or short
sizeOrder size
symbolMarket symbol
priceLimit price (execution price)
stopPriceTrigger price
OptionDefaultDescription
--tif <tif>gtcTime in force: gtc, post-only, ioc
--reduce-onlyfalseReduce-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]
ArgumentDescription
sidebuy, sell, long, or short
sizeOrder size
symbolMarket symbol
stopPriceTrigger price
OptionDefaultDescription
--slippage <pct>1Slippage percentage from stop price
--reduce-onlyfalseReduce-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]
ArgumentDescription
sidebuy, sell, long, or short
sizeTotal order size
symbolMarket symbol
OptionDefaultDescription
--duration <seconds>Total execution duration in seconds
--frequency <seconds>Interval between sub-orders in seconds
--reduce-onlyfalseReduce-only order
# Buy 1 BTC over 10 minutes, placing sub-orders every 30 seconds
decibel-cli trade order twap buy 1 BTC/USD --duration 600 --frequency 30

​
Cancel orders

​
trade cancel

Cancel a specific open order. 
decibel-cli trade cancel <orderId> --market <symbol> [options]
ArgumentDescription
orderIdThe order ID to cancel
OptionDescription
--market <symbol>Market symbol

​
trade cancel-all

Cancel all open orders. 
decibel-cli trade cancel-all [--market <symbol>] [options]
OptionDescription
--market <symbol>Cancel only orders in this market
-y, --yesSkip 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]
ArgumentDescription
symbolMarket symbol (e.g., BTC/USD)
OptionDefaultDescription
--slippage <pct>1Max slippage percentage
--size <size>Full positionPartial 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]
ArgumentDescription
symbolMarket symbol
OptionDescription
--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>
ArgumentDescription
symbolMarket symbol
leverageLeverage multiplier (e.g., 10)
OptionDefaultDescription
--crosstrueUse cross margin
--isolatedUse 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>
ArgumentDescription
symbolMarket symbol
typecross or isolated
decibel-cli trade set-margin BTC/USD cross

​
View trading data

​
trade positions

List open positions. 
decibel-cli trade positions [--json] [-w]
OptionDescription
-wWatch positions in real-time via WebSocket

​
trade orders

List open orders. 
decibel-cli trade orders [--json] [-w]
OptionDescription
-wWatch 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>]
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.