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

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.