Indodax CLI

⚡ Features

Everything you need to interact with Indodax — without leaving your terminal.

📦 Installation

Requires Rust. Install from source in seconds:

git clone https://github.com/ibidathoillah/indodax-cli.git
cd indodax-cli
cargo install --path .

Or build locally:

cargo build --release
./target/release/indodax --help

🚀 Quick Start

1. Check Market Data (No API Key Needed)

indodax market server-time
indodax market ticker btc_idr
indodax market orderbook btcidr
indodax market pairs

2. Set API Credentials (For Account & Trading)

indodax auth set --api-key YOUR_API_KEY --api-secret YOUR_API_SECRET

Or use environment variables for CI/CD:

export INDODAX_API_KEY=your_api_key
export INDODAX_API_SECRET=your_api_secret

3. Check Your Account

indodax account balance
indodax account info

4. Start the Interactive Shell

indodax shell

🤖 MCP Server

indodax-cli includes a built-in Model Context Protocol (MCP) server over stdio. No subprocess wrappers needed.

MCP tool calls run through the same Rust code path as CLI commands and inherit the same error handling, rate-limit behavior, and security model.

Usage

indodax mcp                           # default: market, account, paper (read-only)
indodax mcp -s all                    # all services, dangerous calls require acknowledged=true
indodax mcp -s all --allow-dangerous  # all services, no per-call confirmation
indodax mcp -s market,trade,paper     # specific service groups

Service Groups

Configure Your MCP Client

Add to your MCP client configuration:

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "indodax": {
      "command": "indodax",
      "args": ["mcp", "-s", "all"]
    }
  }
}

VS Code / Cursor (.vscode/mcp.json or Cursor MCP settings):

{
  "mcpServers": {
    "indodax": {
      "command": "indodax",
      "args": ["mcp", "-s", "all"]
    }
  }
}

Gemini CLI:

gemini extensions install https://github.com/ibidathoillah/indodax-cli

📖 Commands

Market Data (Public API)

Account (Private API)

Trading (Private API)

WebSocket Streaming

📝 Output Formats

Human-friendly tables by default, or JSON for automation and AI agent consumption.

# Table mode (default)
indodax market ticker btc_idr

# JSON mode
indodax -o json market ticker btc_idr

When an error occurs in JSON mode, a structured error envelope is returned:

{
  "error": true,
  "message": "Invalid trading pair: xxx_idr",
  "error_type": "invalid_pair",
  "retryable": false
}

🧪 Paper Trading

Test strategies with virtual balances before risking real funds.

# Initialize with default balances (100M IDR, 1 BTC)
indodax paper init

# Place simulated orders
indodax paper buy --pair btc_idr --price 500000000 --amount 0.1
indodax paper sell --pair btc_idr --price 600000000 --amount 0.05

# Check status
indodax paper balance
indodax paper status

🔔 Price Alerts

Set price alerts and get notified when conditions are met. Monitor in real-time via WebSocket.

# Price threshold alerts
indodax alert add -p btc_idr --above 150000000
indodax alert add -p btc_idr --below 50000000

# Percentage change alerts
indodax alert add -p btc_idr --percent-up 5
indodax alert add -p btc_idr --percent-down 10

# Real-time monitoring
indodax alert watch
indodax alert list

🔐 Security

Indodax uses HMAC-SHA512 signing. Credentials are resolved in priority order:

1. CLI flags (--api-key, --api-secret)
2. Environment variables (INDODAX_API_KEY, INDODAX_API_SECRET)
3. Config file (~/.config/indodax/config.toml with 0600 permissions)