mach-one-bot

AI-powered algorithmic trading bot for Monaco Protocol CLOB

Configure, run, and manage automated trading strategies from the command line.

Quick Start

# Run directly (no install needed)
npx mach-one-bot

# Or install globally
npm install -g mach-one-bot

Usage

Initialize a configuration

mach-one-bot init

This launches an interactive wizard that creates a mach-one-bot.toml configuration file.

Run the bot

# Run with default config (mach-one-bot.toml)
mach-one-bot run

# Specify a config file
mach-one-bot run --config my-bot.toml

# Validate without running
mach-one-bot run --dry-run

Chat with AI assistant

mach-one-bot chat

List available strategies

mach-one-bot list-strategies
mach-one-bot list-strategies --by-category
mach-one-bot list-strategies --detailed

Options

| Flag | Description | |------|-------------| | --config <file> | Path to TOML config file | | --dry-run | Validate config without running | | --env <environment> | mainnet, staging, development, local | | --client-id <id> | Override Monaco client ID | | --rate-limit <rps> | Rate limit (requests per second) | | --log-level <level> | DEBUG, INFO, WARN, ERROR | | -v, --version | Show version | | -h, --help | Show help |

Configuration

The bot is configured via TOML files. Here's a minimal example:

[general]
name = "my-bot"
description = "My trading bot"

[wallet]
private_key = "0x..."

[trading]
mode = "simulation"
base_currency = "USDC"
initial_balance = 10000
max_position_size = 1000
max_daily_loss = 500

[strategy]
type = "dca"
risk_level = "medium"

[network]
rpc_url = "https://evm-rpc-testnet.sei-apis.com"
chain_id = 1328

Requirements

• Node.js 18+
• A Sei Network wallet (for live trading)

License

MIT — Built by the MACH1 Team