Boba CLI

AI-powered crypto trading agent for your terminal — swap tokens, manage portfolios, trade perps, and run analytics across Solana, Ethereum, Base, and 7+ chains.

What is Boba?

Boba is a multi-chain crypto trading agent that runs in your terminal. It supports spot trading (swaps, limit orders, DCA, TWAP), perpetual futures on Hyperliquid, prediction markets on Polymarket, and on-chain analytics including wallet tracking, KOL monitoring, and token auditing. Sign up, get free credits, and start trading — no API keys needed. Or use as an MCP server with Claude Code.

Install

npm install -g @tradeboba/cli

Quick Start

boba login
boba start

boba start launches the agent TUI — an interactive terminal with a full AI trading agent, portfolio tracking, and on-chain analytics built in. Free credits are included to get started.

If you're connecting an external MCP client instead of using the built-in agent, run the proxy:

boba login
boba proxy

This starts a local MCP proxy that authenticates requests to Boba's backend. Point your agent's MCP config at the local server. Run boba install to auto-configure Claude Code or Claude Desktop.

Features

Spot Trading & DEX Execution

• Swap tokens on Solana, Base, Ethereum, BSC, Arbitrum, Avalanche — cross-chain
• Limit orders with stop-loss and take-profit
• DCA and TWAP orders for large or recurring buys
• Perps trading on Hyperliquid with leverage

Portfolio Management & Wallet Analytics

• Portfolio holdings and PnL across all chains
• Trade history, transfer history, and balance tracking
• Wallet analytics — PnL, win rate, volume for any wallet
• Top holders and top traders for any token

Token Discovery & KOL Tracking

• Search and filter tokens by volume, holders, momentum, and launchpad
• Track KOL wallets and copy trades in real time
• Watch deployer wallets to catch new launches early
• Token auditing — honeypot detection, rug pull risk, verification checks

Prediction Markets

• Trade on Polymarket — browse events, place bets, manage positions
• Price history, order books, and market analytics

Automations

• Schedule recurring tasks that run on a timer (e.g. portfolio checks, KOL monitoring)
• Pause, resume, or delete automations at any time
• Results appear directly in your active chat session

Token Launch

• Launch tokens on Solana (Pump.fun, LaunchLab, Bonk) or EVM (Clanker)
• Fee sharing and claimable earnings

MCP Server & Agent Integration

• 80+ tools exposed via Model Context Protocol (MCP)
• Use as a standalone agent or connect external AI clients
• Auto-configure Claude Code and Claude Desktop with boba install

Commands

| Command | Description | |:--------|:------------| | boba start | Launch the agent TUI | | boba run "prompt" | Run a prompt non-interactively | | boba proxy | Start the MCP proxy for external agents | | boba claude | Launch Boba proxy alongside Claude | | boba login | Log in with your agent credentials | | boba install | Auto-configure Claude Code or Claude Desktop | | boba status | Check connection and auth status | | boba schedule list | List scheduled automations | | boba config | View or change settings | | boba mcp | Manage MCP server configuration | | boba logout | Sign out |

boba login --agent-id ID --secret S   # Non-interactive login
boba run "check my portfolio"         # Run a prompt non-interactively

Integrations

Boba works as a standalone agent or as an MCP server for external AI clients:

| Integration | Setup | |:------------|:------| | Built-in Agent | boba start | | Claude Code | boba install | | Claude Desktop | boba install | | Any MCP Client | boba proxy — connect to localhost |

Supported Chains

Solana · Ethereum · Base · BSC · Arbitrum · Avalanche · Polygon · Monad · HyperEVM · Ape Chain

Models & Providers

Boba comes pre-configured with AI credits — no API keys required. You can also bring your own provider key for Anthropic, OpenAI, Google, or others via the /provider command inside the TUI.

Security

| | | |:--|:--| | Credential Storage | Agent secret + auth tokens stored in OS Keychain | | Proxy Auth | Per-session cryptographic token — constant-time verification | | Transport | HTTPS enforced for all backend communication | | Config Permissions | Config files written with 0600 (user-only readable) | | No Debug Logging | No sensitive data written to logs | | Access Control | Revoke anytime at agents.boba.xyz |

Upgrading

[!IMPORTANT] v1.0.0 — Boba is now a full AI trading agent with its own TUI, not just a proxy for Claude.

What's new:

• Built-in agent TUI with boba start — no external Claude client needed
• Free AI credits included — no API keys required to get started
• Multi-provider support — Anthropic, OpenAI, Gemini, Groq, and more
• LSP integration — go-to-definition, references, hover, and more across languages
• Quick Trade — paste a token address for instant buy/sell with preset amounts, no agent delay
• Portfolio sidebar with chain filtering — view holdings across all supported chains
• Conversation compaction — long conversations auto-compact to stay within context limits
• Perps trading on Hyperliquid
• Prediction markets on Polymarket
• Limit orders, DCA, TWAP orders
• KOL tracking, wallet analytics, token auditing
• Conversation history with SQLite persistence
• Skills and custom agents — extend Boba with your own prompts and tools
• 10 supported chains: Solana, Base, BSC, Ethereum, Arbitrum, Avalanche, Ape Chain, HyperEVM, Monad, Polygon

To upgrade:

npm install -g @tradeboba/cli
boba login
boba start

License

Proprietary. Copyright © 2026 Boba. All rights reserved. Free for personal use.

[!WARNING] This software is experimental. Provided "as is" without warranty of any kind.

Use at your own risk. Boba assumes no liability for any losses or damages arising from use of this software.

Trading involves significant financial risk. Never trade more than you can afford to lose.