Finance Market CLI

AI-friendly financial market analysis toolkit. JSON-first CLI for technical indicators, signal detection, backtesting, and real-time market data. Built with Bun + CCXT.

Quick Start

bun install
bun run src/index.ts list                    # List all plugins
bun run src/index.ts indicators rsi --symbol BTC/USDT --tf 1h
bun run src/index.ts signals macd-crossover --symbol BTC/USDT --tf 4h
bun run src/index.ts analysis backtest --symbol ETH/USDT --tf 1h --strategy macd-crossover

AI Agent Usage

# Discover capabilities
finance-market list

# Get RSI with structured JSON output
finance-market indicators rsi --symbol BTC/USDT --tf 1h --period 14

# Output is always valid JSON with status field
# { "status": "ok", "plugin": {...}, "data": {...}, "metadata": {...} }
# { "status": "error", "plugin": {...}, "error": { "code": "...", "message": "..." } }

Supported Plugins

Indicators (7)

SMA, EMA, RSI, MACD, Bollinger Bands, Volume, ATR

Signals (4)

MACD Crossover, RSI Divergence, Support/Resistance, Candlestick Patterns

Analysis (1)

Backtest (MACD Crossover strategy)

Environment Variables

• EXCHANGE_API_KEY — Exchange API key (optional)
• EXCHANGE_SECRET — Exchange API secret (optional)