CLI Reference¶

Complete reference for the tradai command-line interface.

Installation¶

The CLI is installed automatically with the TradAI workspace:

just setup

Verify installation:

tradai --help

Global Options¶

Option	Description
`--verbose`, `-v`	Enable verbose/debug output
`--quiet`, `-q`	Suppress non-essential output
`--help`	Show help message
`--install-completion`	Install shell completion
`--show-completion`	Show completion script

JSON Output Format¶

Commands supporting --json output a consistent envelope:

Success:

{
  "success": true,
  "data": { ... }
}

Error:

{
  "success": false,
  "error": {
    "code": "SERVICE_UNAVAILABLE",
    "message": "Failed to connect to backend"
  }
}

Exit Codes¶

Code	Name	Exit Code	Meaning
`SUCCESS`	-	0	Command completed successfully
`GENERAL_ERROR`	General	1	Unspecified error
`VALIDATION_ERROR`	Validation	2	Invalid input or parameters
`TIMEOUT_ERROR`	Timeout	3	Operation timed out
`AUTH_ERROR`	Auth	4	Authentication failure
`SERVICE_UNAVAILABLE`	Service	5	Backend/service unreachable

Example scripting usage:

# Check if command succeeded
result=$(tradai monitor status --json)
if echo "$result" | jq -e '.success' > /dev/null 2>&1; then
  echo "OK"
else
  echo "Failed: $(echo "$result" | jq -r '.error.message')"
fi

Service Commands¶

`tradai up`¶

Start all TradAI services using Docker Compose.

tradai up

`tradai down`¶

Stop all TradAI services.

tradai down

`tradai ps`¶

Show status of running services.

tradai ps

`tradai logs`¶

View logs for TradAI services.

# All services
tradai logs

# Specific service
tradai logs backend
tradai logs strategy-service

Strategy Commands¶

Strategy management and development.

tradai strategy --help

`tradai strategy new`¶

Create a new strategy from template.

# Basic strategy
tradai strategy new MyStrategy

# ML-enabled strategy
tradai strategy new MyMLStrategy --ml

# With specific exchange
tradai strategy new MyStrategy --exchange binance_futures

Options:

Option	Description	Default
`--ml`	Enable FreqAI ML support	`false`
`--exchange`	Target exchange	`binance_futures`
`--output-dir`	Output directory	`./strategies`

`tradai strategy wizard`¶

Interactive wizard for creating a new strategy with guided prompts.

tradai strategy wizard

`tradai strategy list`¶

List available strategies from backend service.

tradai strategy list

`tradai strategy info`¶

Get detailed information about a strategy.

tradai strategy info PascalStrategy

`tradai strategy lint`¶

Lint a strategy for common issues.

tradai strategy lint PascalStrategy

# With auto-fix
tradai strategy lint PascalStrategy --fix

`tradai strategy check`¶

Run all validation checks on a strategy project (files, config, lint, typecheck, tests, params).

# Run all checks (stops on first failure)
tradai strategy check ./strategies/my-strategy/

# Continue past failures to see all results
tradai strategy check ./strategies/my-strategy/ --continue-on-error

`tradai strategy check-files`¶

Validate required file structure (pyproject.toml, Dockerfile, tradai.yaml, src/, tests/, configs/).

tradai strategy check-files ./strategies/my-strategy/

# JSON output
tradai strategy check-files ./strategies/my-strategy/ --json

`tradai strategy check-config`¶

Validate tradai.yaml schema (name, version, entry_point, category, timeframe).

tradai strategy check-config ./strategies/my-strategy/

# JSON output
tradai strategy check-config ./strategies/my-strategy/ --json

`tradai strategy typecheck`¶

Run mypy on strategy source code.

tradai strategy typecheck ./strategies/my-strategy/

`tradai strategy test`¶

Run pytest on strategy tests.

tradai strategy test ./strategies/my-strategy/

`tradai strategy check-params`¶

Validate hyperopt parameter search spaces (ranges, defaults, categories).

tradai strategy check-params ./strategies/my-strategy/

# JSON output
tradai strategy check-params ./strategies/my-strategy/ --json

`tradai strategy version`¶

Show current version of a strategy in MLflow registry.

tradai strategy version PascalStrategy

`tradai strategy versions`¶

List all versions of a strategy with their stages.

tradai strategy versions PascalStrategy

`tradai strategy set-version`¶

Promote a strategy version to a stage (Staging, Production).

# Stage for validation
tradai strategy set-version PascalStrategy 3 --stage Staging

# Promote to production
tradai strategy set-version PascalStrategy 3 --stage Production

# Dry run (preview without acting)
tradai strategy set-version PascalStrategy 3 --stage Production --dry-run

# Force (skip confirmation)
tradai strategy set-version PascalStrategy 3 --stage Production --force

Options:

Option	Description	Default
`--stage`	Target stage (Staging, Production)	Required
`--dry-run`	Preview without promoting	`false`
`--force`	Skip confirmation prompt	`false`

`tradai strategy optimize`¶

Optimize strategy parameters using Freqtrade hyperopt.

tradai strategy optimize PascalStrategy \
  --epochs 100 \
  --spaces buy sell \
  --timerange 20240101-20240301

Options:

Option	Description	Default
`--epochs`, `-e`	Number of optimization epochs	100
`--spaces`	Spaces to optimize (buy, sell, roi, stoploss)	`buy sell`
`--timerange`	Date range for optimization	Last 90 days
`--jobs`, `-j`	Parallel jobs	CPU count

`tradai strategy optimize-preset`¶

Run optimization with preset configuration.

# Quick optimization
tradai strategy optimize-preset PascalStrategy quick

# Standard optimization
tradai strategy optimize-preset PascalStrategy standard

# Thorough optimization
tradai strategy optimize-preset PascalStrategy thorough

`tradai strategy optimize-results`¶

List recent optimization runs from MLflow.

tradai strategy optimize-results

# Filter by strategy
tradai strategy optimize-results --strategy PascalStrategy

`tradai strategy optuna`¶

Run Optuna ML hyperparameter optimization for FreqAI models.

tradai strategy optuna PascalStrategy \
  --n-trials 100 \
  --metric sharpe_ratio

`tradai strategy bump`¶

Bump strategy version with optional changelog entry.

# Patch bump (1.0.0 -> 1.0.1)
tradai strategy bump PascalStrategy patch

# Minor bump (1.0.0 -> 1.1.0)
tradai strategy bump PascalStrategy minor

# Major bump (1.0.0 -> 2.0.0)
tradai strategy bump PascalStrategy major

# With changelog message
tradai strategy bump PascalStrategy patch -m "Fixed entry signal logic"

# Dry run (preview without bumping)
tradai strategy bump PascalStrategy minor --dry-run

Options:

Option	Description	Default
`--message`, `-m`	Changelog message	-
`--dry-run`	Preview version bump without acting	`false`

`tradai strategy changelog`¶

View strategy changelog.

tradai strategy changelog PascalStrategy

Backtest Commands¶

Backtest visualization and analysis.

tradai backtest --help

`tradai backtest quick`¶

Quick backtest with minimal output for rapid iteration.

# Basic quick backtest
tradai backtest quick PascalStrategy

# With options
tradai backtest quick PascalStrategy \
  --period 30d \
  --symbol BTC/USDT:USDT \
  --timeframe 1h

# Local mode (no backend required)
tradai backtest quick PascalStrategy --local

# Strategy in external repo (forces local mode)
tradai backtest quick StochRsiStrategy --strategy-dir ../tradai-strategies

Options:

Option	Description	Default
`--period`, `-p`	Backtest period (e.g., 7d, 30d, 3m)	`30d`
`--symbol`, `-s`	Trading symbol	`BTC/USDT:USDT`
`--timeframe`, `-t`	Candle timeframe	`1h`
`--stake`	Stake amount per trade	`1000.0`
`--local`	Run locally without backend	`false`
`--no-wait`	Return job ID immediately	`false`
`--timeout`	Max wait time in seconds	`600`
`--strategy-dir`	Directory containing strategies (forces local mode)	`$TRADAI_STRATEGY_DIR`

`tradai backtest list`¶

List recent backtest jobs.

# List all
tradai backtest list

# Filter by status
tradai backtest list --status completed
tradai backtest list --status failed

# Limit results
tradai backtest list --limit 10

`tradai backtest show`¶

Show backtest results with ASCII visualizations.

tradai backtest show <job_id>

# With equity curve
tradai backtest show <job_id> --equity

# With trade table
tradai backtest show <job_id> --trades

`tradai backtest compare`¶

Compare two backtest runs side by side.

tradai backtest compare <job_id_1> <job_id_2>

`tradai backtest report`¶

Generate interactive HTML report for a backtest.

tradai backtest report <job_id>

# Custom output path
tradai backtest report <job_id> --output ./reports/my-report.html

# Auto-open in browser
tradai backtest report <job_id> --open

`tradai backtest trades`¶

Export trade log from a backtest run.

# Export to CSV
tradai backtest trades <job_id> --format csv --output trades.csv

# Export to JSON
tradai backtest trades <job_id> --format json --output trades.json

Data Commands¶

Data collection and management.

tradai data --help

`tradai data sync`¶

Sync OHLCV data from exchange to storage.

# Sync specific symbol
tradai data sync BTC/USDT:USDT --days 90

# Sync with date range
tradai data sync BTC/USDT:USDT \
  --start 2024-01-01 \
  --end 2024-06-01

# Sync multiple symbols
tradai data sync BTC/USDT:USDT ETH/USDT:USDT SOL/USDT:USDT

# Sync all configured symbols
tradai data sync --all

Options:

Option	Description	Default
`--days`	Days of history to sync	30
`--start`	Start date (YYYY-MM-DD)	-
`--end`	End date (YYYY-MM-DD)	Today
`--timeframe`	Candle timeframe	`1h`
`--all`	Sync all configured symbols	`false`

`tradai data list-symbols`¶

List available trading symbols from exchange.

tradai data list-symbols

# Filter by quote currency
tradai data list-symbols --quote USDT

# Search
tradai data list-symbols --search BTC

`tradai data check-freshness`¶

Check data freshness for given symbols.

tradai data check-freshness BTC/USDT:USDT ETH/USDT:USDT

# With stale threshold
tradai data check-freshness BTC/USDT:USDT --stale-hours 24

`tradai data preview`¶

Preview recent OHLCV data for a symbol.

tradai data preview BTC/USDT:USDT

# With row limit
tradai data preview BTC/USDT:USDT --rows 20

`tradai data health`¶

Check data collection service health status.

tradai data health

Deploy Commands¶

Strategy deployment to AWS.

tradai deploy --help

`tradai deploy strategy`¶

Deploy a strategy to AWS ECS.

# Deploy to staging
tradai deploy strategy PascalStrategy --env staging

# Deploy to production
tradai deploy strategy PascalStrategy --env production

# Deploy specific version
tradai deploy strategy PascalStrategy --version 3 --env production

# Dry run (preview only)
tradai deploy strategy PascalStrategy --env staging --dry-run

Options:

Option	Description	Default
`--env`	Target environment	Required
`--version`	Strategy version	Latest
`--dry-run`	Preview without deploying	`false`
`--skip-validation`	Skip pre-deploy checks	`false`

`tradai deploy status`¶

Show deployment status.

# All deployments
tradai deploy status

# Specific strategy
tradai deploy status PascalStrategy

# Specific environment
tradai deploy status --env production

`tradai deploy logs`¶

View deployment logs from CloudWatch.

tradai deploy logs PascalStrategy --env production

# Follow logs
tradai deploy logs PascalStrategy --env production --follow

# Last N lines
tradai deploy logs PascalStrategy --env production --tail 100

`tradai deploy rollback`¶

Rollback a strategy to previous version.

tradai deploy rollback PascalStrategy --env production

# Rollback to specific version
tradai deploy rollback PascalStrategy --env production --version 2

`tradai deploy history`¶

Show deployment history for a strategy.

tradai deploy history PascalStrategy

# With environment filter
tradai deploy history PascalStrategy --env production

`tradai deploy diff`¶

Compare strategy deployments between environments.

tradai deploy diff PascalStrategy --env staging --target production

`tradai deploy emergency-close`¶

Emergency stop a running strategy (closes all positions).

tradai deploy emergency-close PascalStrategy --env production

# With confirmation skip
tradai deploy emergency-close PascalStrategy --env production --yes

# Dry run (preview what would happen)
tradai deploy emergency-close PascalStrategy --env production --dry-run

Options:

Option	Description	Default
`--env`	Target environment	Required
`--yes`, `-y`	Skip confirmation prompt	`false`
`--dry-run`	Preview without acting	`false`

`tradai deploy restart`¶

Restart a stopped or unhealthy strategy.

tradai deploy restart PascalStrategy --env production

Live Trading Commands¶

Manage live and dry-run trading instances.

tradai live --help

`tradai live start`¶

Start a strategy in live or dry-run mode.

# Start in dry-run mode (default)
tradai live start PascalStrategy --mode dry-run

# Start in live mode (requires confirmation)
tradai live start PascalStrategy --mode live

# With custom timeframe and symbols
tradai live start PascalStrategy \
  --mode dry-run \
  --timeframe 4h \
  --symbols "BTC/USDT:USDT,ETH/USDT:USDT"

# With config overrides
tradai live start PascalStrategy \
  --mode dry-run \
  --config '{"stake_amount": 50}'

# JSON output
tradai live start PascalStrategy --mode dry-run --json

Options:

Option	Description	Default
`--mode`, `-m`	Trading mode: `live` or `dry-run`	`dry-run`
`--timeframe`, `-t`	Candle timeframe (e.g., 1h, 4h)	`1h`
`--symbols`, `-s`	Comma-separated trading pairs	-
`--config`, `-c`	JSON config overrides	-
`--timeout`	Max wait time for strategy startup (seconds)	`120`
`--json`	Output as JSON	`false`

Warning: Starting in live mode requires explicit confirmation as it trades with real funds.

`tradai live stop`¶

Stop a running strategy instance.

# Stop (auto-selects if only one instance)
tradai live stop PascalStrategy

# Stop specific instance
tradai live stop PascalStrategy --instance-id abc123

# Force stop without confirmation
tradai live stop PascalStrategy --force

# JSON output
tradai live stop PascalStrategy --json

Options:

Option	Description	Default
`--instance-id`, `-i`	Instance ID to stop	Auto-select
`--force`, `-f`	Skip confirmation	`false`
`--dry-run`	Show what would be stopped without acting	`false`
`--json`	Output as JSON	`false`

`tradai live instances`¶

List running instances for a strategy.

tradai live instances PascalStrategy

# JSON output
tradai live instances PascalStrategy --json

Options:

Option	Description	Default
`--json`	Output as JSON	`false`

`tradai live logs`¶

View logs for a strategy instance.

tradai live logs PascalStrategy abc123

# Limit number of lines
tradai live logs PascalStrategy abc123 --limit 50

# JSON output
tradai live logs PascalStrategy abc123 --json

Options:

Option	Description	Default
`--limit`, `-n`	Number of log lines	`100`
`--follow`, `-f`	Follow log output (not yet implemented)	`false`
`--json`	Output as JSON	`false`

`tradai live status`¶

Show status of all active trading instances.

tradai live status

# JSON output
tradai live status --json

Displays a summary table with: - Running instances by strategy - Mode (live vs dry-run) - Current status (running, paused, initializing, etc.) - P&L percentage - Uptime

Options:

Option	Description	Default
`--json`	Output as JSON	`false`

`tradai live pause`¶

Pause a running strategy instance.

Pausing stops the strategy from opening new trades while keeping existing positions open. This is useful for temporarily halting trading during market uncertainty without closing positions.

tradai live pause PascalStrategy abc123

# JSON output
tradai live pause PascalStrategy abc123 --json

Options:

Option	Description	Default
`--json`	Output as JSON	`false`

`tradai live resume`¶

Resume a paused strategy instance.

tradai live resume PascalStrategy abc123

# JSON output
tradai live resume PascalStrategy abc123 --json

Options:

Option	Description	Default
`--json`	Output as JSON	`false`

Monitor Commands¶

Monitor running trading strategies.

tradai monitor --help

`tradai monitor status`¶

Show live status of running strategies.

tradai monitor status

# Watch mode with auto-refresh
tradai monitor status --watch
tradai monitor status --watch --interval 10

# JSON output
tradai monitor status --json

Options:

Option	Description	Default
`--watch`, `-w`	Auto-refresh display	`false`
`--interval`, `-i`	Refresh interval (seconds)	`5`
`--json`	Output as JSON	`false`

`tradai monitor stale`¶

Show strategies with stale heartbeats (potential health issues).

tradai monitor stale

# Custom threshold
tradai monitor stale --threshold 10

# JSON output
tradai monitor stale --json

`tradai monitor get`¶

Get detailed status of a specific strategy.

tradai monitor get pascal-v1
tradai monitor get pascal-v1 --json

`tradai monitor pnl`¶

Show P&L for running strategies.

# All strategies
tradai monitor pnl

# Specific strategy
tradai monitor pnl pascal-v1

# Watch mode
tradai monitor pnl --watch

# JSON output
tradai monitor pnl --json

`tradai monitor trades`¶

Show recent trades from running strategies.

tradai monitor trades pascal-v1

# Limit results
tradai monitor trades pascal-v1 --limit 50

# JSON output
tradai monitor trades pascal-v1 --json

`tradai monitor compare`¶

Compare live performance vs backtest expectations.

tradai monitor compare pascal-v1

# Custom deviation threshold
tradai monitor compare pascal-v1 --threshold 15

# JSON output
tradai monitor compare pascal-v1 --json

Shows side-by-side comparison of live metrics against the latest Production backtest from MLflow. Highlights significant deviations.

`tradai monitor health`¶

Show detailed health status of running strategies.

# All strategies
tradai monitor health

# Specific strategy
tradai monitor health pascal-v1

# Custom stale threshold
tradai monitor health --stale 10

# JSON output
tradai monitor health --json

Monitor Alerts Commands¶

Alert monitoring and webhook testing.

tradai monitor alerts --help

`tradai monitor alerts list`¶

List recent alerts from DynamoDB.

tradai monitor alerts list

# Filter by severity
tradai monitor alerts list --severity critical

# Filter by service
tradai monitor alerts list --service strategy-service

# Limit results
tradai monitor alerts list --limit 10

`tradai monitor alerts history`¶

Show alert history for a time range.

# Last 24 hours (default)
tradai monitor alerts history --start 24h

# Last 7 days
tradai monitor alerts history --start 7d

# Date range
tradai monitor alerts history --start 2024-01-01 --end 2024-01-02

# Filter by severity
tradai monitor alerts history --start 7d --severity error

`tradai monitor alerts get`¶

Get detailed view of a specific alert.

tradai monitor alerts get abc-123-def
tradai monitor alerts get abc-123-def --json

`tradai monitor alerts test-slack`¶

Send a test alert to Slack.

tradai monitor alerts test-slack --url https://hooks.slack.com/...

# With severity
tradai monitor alerts test-slack --severity critical

# Using environment variable
SLACK_WEBHOOK_URL=https://... tradai monitor alerts test-slack

`tradai monitor alerts test-discord`¶

Send a test alert to Discord.

tradai monitor alerts test-discord --url https://discord.com/api/webhooks/...

# With severity
tradai monitor alerts test-discord --severity error

# Using environment variable
DISCORD_WEBHOOK_URL=https://... tradai monitor alerts test-discord

Monitor Queue Commands¶

Monitor and manage backtest job queues and DLQs.

tradai monitor queue --help

`tradai monitor queue status`¶

Show queue and DLQ message counts.

tradai monitor queue status
tradai monitor queue status --json

`tradai monitor queue inspect`¶

View DLQ message details.

# Show all DLQ messages
tradai monitor queue inspect

# Limit results
tradai monitor queue inspect --max 5

# Specific message
tradai monitor queue inspect MSG-123

# JSON output
tradai monitor queue inspect --json

`tradai monitor queue replay`¶

Replay messages from DLQ to main queue.

# Replay specific message
tradai monitor queue replay MSG-123

# Replay all messages
tradai monitor queue replay --all

# Dry run
tradai monitor queue replay --all --dry-run

Validate Commands¶

Validation commands for strategies and data.

tradai validate --help

`tradai validate strategy`¶

Run pre-flight validation checks on a strategy.

tradai validate strategy PascalStrategy

# Verbose output
tradai validate strategy PascalStrategy --verbose

`tradai validate config`¶

Validate a strategy configuration file.

tradai validate config configs/my-strategy.json

Validate Dryrun Commands¶

Dry-run validation for strategy deployments.

tradai validate dryrun --help

`tradai validate dryrun run`¶

Run full validation suite for a dry-run deployment.

tradai validate dryrun run pascal-v2 --days 7

# Custom output
tradai validate dryrun run pascal-v2 --days 7 --output validation.md

Validation Thresholds:

Metric	Default	Description
`uptime_percentage`	95%	Minimum heartbeat uptime
`max_gap_seconds`	300s	Maximum gap between heartbeats
`candle_completeness`	98%	Minimum data completeness

`tradai validate dryrun heartbeats`¶

Validate heartbeat uptime for a strategy.

tradai validate dryrun heartbeats pascal-v2 --days 7

`tradai validate dryrun candles`¶

Validate candle data completeness.

tradai validate dryrun candles pascal-v2 --symbol BTC/USDT:USDT
tradai validate dryrun candles pascal-v2 --symbol BTC/USDT:USDT --days 7

`tradai validate dryrun signoff`¶

Generate sign-off checklist for dry-run validation.

tradai validate dryrun signoff pascal-v2
tradai validate dryrun signoff pascal-v2 --output signoff.md

Validate Golive Commands¶

Go-live infrastructure validation before production deployment.

tradai validate golive --help

`tradai validate golive verify`¶

Run full infrastructure verification.

tradai validate golive verify --env prod
tradai validate golive verify --env staging --output report.md

`tradai validate golive alarms`¶

Verify CloudWatch alarms are configured and enabled.

tradai validate golive alarms --env prod

Expected Alarms: - {project}-{env}-backend-unhealthy - {project}-{env}-strategy-service-unhealthy - {project}-{env}-data-collection-unhealthy - {project}-{env}-orphan-scanner-errors - {project}-{env}-health-check-errors - {project}-{env}-trading-heartbeat-check-errors - {project}-{env}-drift-monitor-errors - {project}-{env}-retraining-scheduler-errors

`tradai validate golive alerts`¶

Verify SNS alerting is working.

tradai validate golive alerts --env prod

`tradai validate golive lambdas`¶

Verify Lambda health checks are running.

tradai validate golive lambdas --env prod

Expected Lambdas: - {project}-orphan-scanner-{env} - {project}-health-check-{env} - {project}-trading-heartbeat-check-{env} - {project}-drift-monitor-{env} - {project}-retraining-scheduler-{env}

Doctor Commands¶

System diagnostics and health checks.

tradai doctor --help

`tradai doctor`¶

Run full system diagnostics.

tradai doctor

# Quick check
tradai doctor --quick

# JSON output
tradai doctor --json

Options:

Option	Description	Default
`--quick`	Run minimal checks only	`false`
`--json`	Output as JSON	`false`

`tradai doctor deps`¶

Check Python dependencies status.

tradai doctor deps

`tradai doctor services`¶

Check service connectivity.

tradai doctor services

# JSON output
tradai doctor services --json

Options:

Option	Description	Default
`--json`	Output as JSON	`false`

Auth Commands¶

Authentication management.

tradai auth --help

`tradai auth login`¶

Authenticate with TradAI services.

tradai auth login

`tradai auth logout`¶

Clear authentication tokens.

tradai auth logout

`tradai auth status`¶

Show current authentication status.

tradai auth status
tradai auth status --env prod

`tradai auth whoami`¶

Display current user information from JWT token.

tradai auth whoami
tradai auth whoami --env prod

Shows decoded claims from the ID token including email, username, and Cognito groups.

`tradai auth config`¶

Initialize or show authentication configuration.

# Initialize new config file
tradai auth config

# Show current configuration
tradai auth config --show

Creates ~/.tradai/config.yaml with environment configuration template.

`tradai auth environments`¶

List all configured environments and their authentication status.

tradai auth environments

Shows which environments have valid stored tokens.

A/B Test Commands¶

A/B testing for strategy versions.

tradai ab-test --help

`tradai ab-test create`¶

Create a new A/B test (champion vs challenger).

tradai ab-test create PascalStrategy \
  --champion 2 \
  --challenger 3 \
  --min-trades 100

`tradai ab-test status`¶

Show status of active A/B tests.

tradai ab-test status

# Specific test
tradai ab-test status <test_id>

`tradai ab-test evaluate`¶

Evaluate A/B test results and get recommendation.

tradai ab-test evaluate <test_id>

`tradai ab-test conclude`¶

Conclude an A/B test (promote or rollback).

# Promote challenger
tradai ab-test conclude <test_id> --promote

# Keep champion
tradai ab-test conclude <test_id> --rollback

Indicator Commands¶

Indicator testing and exploration.

tradai indicator --help

`tradai indicator test`¶

Test an indicator expression interactively.

tradai indicator test "ta.EMA(close, 20)"

# With specific symbol and timeframe
tradai indicator test "ta.RSI(close, 14)" \
  --symbol BTC/USDT:USDT \
  --timeframe 1h

`tradai indicator list`¶

List available technical indicators.

tradai indicator list

# Filter by category
tradai indicator list --category trend
tradai indicator list --category momentum

Version Command¶

`tradai version`¶

Show TradAI CLI version.

tradai version

Configuration File¶

The CLI loads service URLs and settings from ~/.tradai/config.yaml. This is the recommended way to configure the CLI for different environments.

default_environment: dev   # or: local, prod
environments:
  local:
    backend_url: http://localhost:8000
    data_collection_url: http://localhost:8002
    mlflow_tracking_uri: http://localhost:5001
    ui_url: http://localhost:3000
  dev:
    backend_url: http://your-alb.region.elb.amazonaws.com
    data_collection_url: http://your-alb.region.elb.amazonaws.com
    mlflow_tracking_uri: http://your-alb.region.elb.amazonaws.com/mlflow
    ui_url: http://your-alb.region.elb.amazonaws.com
    arctic_s3_bucket: tradai-arcticdb-dev
    arctic_library: ohlcv

URL Resolution Priority¶

All service URLs follow this priority chain (highest to lowest):

CLI flag (e.g., --backend http://custom)
Environment variable (e.g., BACKEND_URL=http://custom)
Config file (~/.tradai/config.yaml, selected by TRADAI_ENV)
Localhost default (e.g., http://localhost:8000)

Config File Fields¶

Field	Description	Default
`backend_url`	Backend API service URL	`http://localhost:8000`
`data_collection_url`	Data collection service URL	`http://localhost:8002`
`mlflow_tracking_uri`	MLflow tracking server URL	`http://localhost:5001`
`ui_url`	TradAI UI URL (for deep links)	`http://localhost:3000`
`arctic_s3_bucket`	ArcticDB S3 bucket name	`None` (uses service client)
`arctic_library`	ArcticDB library name	`ohlcv`

Environment Variables¶

Environment variables override the config file when set.

Service URLs¶

Variable	Description	Default
`BACKEND_URL`	Backend service URL	`http://localhost:8000`
`DATA_COLLECTION_URL`	Data collection service URL	`http://localhost:8002`
`MLFLOW_TRACKING_URI`	MLflow tracking server URL	`http://localhost:5001`
`TRADAI_UI_URL`	TradAI UI URL for deep links	`http://localhost:3000`
`ARCTIC_S3_BUCKET`	ArcticDB S3 bucket name	`None`
`ARCTIC_LIBRARY`	ArcticDB library name	`ohlcv`

Runtime Context¶

Variable	Description	Default
`TRADAI_RUNTIME`	Runtime environment: `local`, `localstack`, `aws`	auto-detect
`TRADAI_STAGE`	Deployment stage: `dev`, `staging`, `prod` (alias: `ENVIRONMENT`)	`dev`

General¶

Variable	Description	Default
`TRADAI_ENV`	Environment to use from config file	`local`
`TRADAI_LOG_LEVEL`	Log verbosity	`INFO`

Shell Completion¶

Install shell completion for better CLI experience:

# Bash
tradai --install-completion bash

# Zsh
tradai --install-completion zsh

# Fish
tradai --install-completion fish

CLI Reference¶

Installation¶

Global Options¶

JSON Output Format¶

Exit Codes¶

Service Commands¶

tradai up¶

tradai down¶

tradai ps¶

tradai logs¶

Strategy Commands¶

tradai strategy new¶

tradai strategy wizard¶

tradai strategy list¶

tradai strategy info¶

tradai strategy lint¶

tradai strategy check¶

tradai strategy check-files¶

tradai strategy check-config¶

tradai strategy typecheck¶

tradai strategy test¶

tradai strategy check-params¶

tradai strategy version¶

tradai strategy versions¶

tradai strategy set-version¶

tradai strategy optimize¶

tradai strategy optimize-preset¶

tradai strategy optimize-results¶

tradai strategy optuna¶

tradai strategy bump¶

tradai strategy changelog¶

Backtest Commands¶

tradai backtest quick¶

tradai backtest list¶

tradai backtest show¶

tradai backtest compare¶

tradai backtest report¶

tradai backtest trades¶

Data Commands¶

tradai data sync¶

tradai data list-symbols¶

tradai data check-freshness¶

tradai data preview¶

tradai data health¶

Deploy Commands¶

tradai deploy strategy¶

tradai deploy status¶

tradai deploy logs¶

tradai deploy rollback¶

tradai deploy history¶

tradai deploy diff¶

tradai deploy emergency-close¶

tradai deploy restart¶

Live Trading Commands¶

tradai live start¶

tradai live stop¶

tradai live instances¶

tradai live logs¶

tradai live status¶

tradai live pause¶

tradai live resume¶

Monitor Commands¶

tradai monitor status¶

tradai monitor stale¶

tradai monitor get¶

tradai monitor pnl¶

tradai monitor trades¶

tradai monitor compare¶

tradai monitor health¶

Monitor Alerts Commands¶

tradai monitor alerts list¶

tradai monitor alerts history¶

tradai monitor alerts get¶

tradai monitor alerts test-slack¶

tradai monitor alerts test-discord¶

Monitor Queue Commands¶

tradai monitor queue status¶

tradai monitor queue inspect¶

tradai monitor queue replay¶

Validate Commands¶

`tradai up`¶

`tradai down`¶

`tradai ps`¶

`tradai logs`¶

`tradai strategy new`¶

`tradai strategy wizard`¶

`tradai strategy list`¶

`tradai strategy info`¶

`tradai strategy lint`¶

`tradai strategy check`¶

`tradai strategy check-files`¶

`tradai strategy check-config`¶

`tradai strategy typecheck`¶

`tradai strategy test`¶

`tradai strategy check-params`¶

`tradai strategy version`¶

`tradai strategy versions`¶

`tradai strategy set-version`¶

`tradai strategy optimize`¶

`tradai strategy optimize-preset`¶

`tradai strategy optimize-results`¶

`tradai strategy optuna`¶

`tradai strategy bump`¶

`tradai strategy changelog`¶

`tradai backtest quick`¶

`tradai backtest list`¶

`tradai backtest show`¶

`tradai backtest compare`¶

`tradai backtest report`¶

`tradai backtest trades`¶

`tradai data sync`¶

`tradai data list-symbols`¶

`tradai data check-freshness`¶

`tradai data preview`¶

`tradai data health`¶

`tradai deploy strategy`¶

`tradai deploy status`¶

`tradai deploy logs`¶

`tradai deploy rollback`¶

`tradai deploy history`¶

`tradai deploy diff`¶

`tradai deploy emergency-close`¶

`tradai deploy restart`¶

`tradai live start`¶

`tradai live stop`¶

`tradai live instances`¶

`tradai live logs`¶

`tradai live status`¶

`tradai live pause`¶

`tradai live resume`¶

`tradai monitor status`¶

`tradai monitor stale`¶

`tradai monitor get`¶

`tradai monitor pnl`¶

`tradai monitor trades`¶

`tradai monitor compare`¶

`tradai monitor health`¶

`tradai monitor alerts list`¶

`tradai monitor alerts history`¶

`tradai monitor alerts get`¶

`tradai monitor alerts test-slack`¶

`tradai monitor alerts test-discord`¶

`tradai monitor queue status`¶

`tradai monitor queue inspect`¶

`tradai monitor queue replay`¶

`tradai validate strategy`¶

`tradai validate config`¶

`tradai validate dryrun run`¶

`tradai validate dryrun heartbeats`¶

`tradai validate dryrun candles`¶

`tradai validate dryrun signoff`¶

`tradai validate golive verify`¶

`tradai validate golive alarms`¶

`tradai validate golive alerts`¶

`tradai validate golive lambdas`¶

`tradai doctor`¶

`tradai doctor deps`¶

`tradai doctor services`¶

`tradai auth login`¶

`tradai auth logout`¶