Skip to main content

​
What is the Decibel CLI?

The Decibel CLI (@decibeltrade/cli) is a command-line interface for trading on Decibel DEX. It provides direct terminal access to:
  • Trading - Place and cancel orders (limit, market, stop, TWAP), manage positions, set TP/SL
  • Account management - Multi-account support with encrypted local storage
  • Market data - Prices, orderbooks, and real-time WebSocket streaming
The CLI requires a Node API token for authentication. Get yours from Geomi before starting.
The CLI also ships with a built-in MCP server with 25 tools, enabling AI agents like Claude to trade through natural language.

Installation

Install the CLI globally via npm, yarn, or pnpm.

Configuration

Set up accounts, environment variables, and network selection.

Command Reference

Full reference for all available commands and options.

​
Quick start

# Set required environment variables
export DECIBEL_NODE_API_KEY=aptoslabs_...
export DECIBEL_NETWORK=testnet

# Add your trading account
decibel-cli account add

# List available markets
decibel-cli markets ls

# Check BTC price
decibel-cli markets price BTC/USD

# Place a limit order
decibel-cli trade order limit buy 0.01 BTC/USD 50000

# View open positions
decibel-cli trade positions

​
Design

The CLI is designed for two audiences:
  • AI agents (primary) - All commands support --json output for machine-readable responses. The built-in MCP server exposes 25 tools for direct agent integration.
  • Human power users (secondary) - Formatted tables, color-coded output, and real-time watch mode via WebSocket.

​
MCP server

The CLI includes a built-in Model Context Protocol (MCP) server that allows AI agents like Claude to interact with Decibel programmatically. See the MCP Server section under the Agents tab for setup instructions and the full tool reference.