CLI Reference
This page provides auto-generated documentation for the cc-liquid CLI tool.
cc-liquid
cc-liquid - A metamodel-based rebalancer for Hyperliquid.
Usage:
Options:
cc-liquid account
Show comprehensive account and positions summary.
Usage:
Options:
cc-liquid analyze
Run backtest analysis on historical data.
⚠️ IMPORTANT DISCLAIMER: Past performance does not guarantee future results. Backtesting results are hypothetical and have inherent limitations. Actual trading results may differ significantly. Always consider market conditions, liquidity, and execution costs that may not be fully captured in simulations.
Usage:
Options:
--prices TEXT Path to price data (parquet file with date,
id, close columns)
--start-date [%Y-%m-%d|%Y-%m-%dT%H:%M:%S|%Y-%m-%d %H:%M:%S]
Start date for backtest (YYYY-MM-DD)
--end-date [%Y-%m-%d|%Y-%m-%dT%H:%M:%S|%Y-%m-%d %H:%M:%S]
End date for backtest (YYYY-MM-DD)
--set TEXT Override config values (e.g., --set
portfolio.num_long=15 --set
data.source=numerai)
--fee-bps FLOAT Trading fee in basis points
--slippage-bps FLOAT Slippage cost in basis points
--prediction-lag INTEGER Days between prediction date and trading
date (default: 1, use higher values to avoid
look-ahead bias)
--save-daily TEXT Save daily results to CSV file
--show-positions Show detailed position analysis table
--verbose Show detailed progress
--help Show this message and exit.
cc-liquid close-all
Close all positions and return to cash.
Usage:
Options:
--skip-confirm Skip confirmation prompt for closing positions.
--set TEXT Override config values (e.g., --set is_testnet=true)
--force Force close positions below min notional by composing a two-
step workaround.
--help Show this message and exit.
cc-liquid completion
Shell completion utilities.
Usage:
Options:
cc-liquid completion install
Install shell completion for the current user.
Writes the generated completion script to a standard location and, for Bash/Zsh, appends a source line to the user's rc file idempotently.
Usage:
Options:
--shell [bash|zsh|fish] Target shell. Defaults to auto-detect from $SHELL.
--prog-name TEXT Program name to install completion for (as
installed on PATH). [default: cc-liquid]
--help Show this message and exit.
cc-liquid config
Show the current configuration.
Usage:
Options:
cc-liquid download-crowdcent
Download the CrowdCent meta model.
Usage:
Options:
cc-liquid download-numerai
Download the Numerai meta model.
Usage:
Options:
cc-liquid init
Interactive setup wizard for first-time users.
Guides you through creating config files with validation and helpful defaults.
Usage:
Options:
cc-liquid optimize
Optimize backtest parameters using parallel grid search.
⚠️ IMPORTANT DISCLAIMER: Optimization results are based on historical data and are subject to overfitting. Parameters that performed well in the past may not perform well in the future. Always use out-of-sample testing and forward walk analysis. Consider that optimized parameters may be curve-fit to historical noise rather than true patterns.
Usage:
Options:
--prices TEXT Path to price data
--start-date [%Y-%m-%d|%Y-%m-%dT%H:%M:%S|%Y-%m-%d %H:%M:%S]
Start date for backtest (YYYY-MM-DD)
--end-date [%Y-%m-%d|%Y-%m-%dT%H:%M:%S|%Y-%m-%d %H:%M:%S]
End date for backtest (YYYY-MM-DD)
--set TEXT Override config values (e.g., --set
data.source=numerai)
--num-longs TEXT Comma-separated list of long positions to
test
--num-shorts TEXT Comma-separated list of short positions to
test
--leverages TEXT Comma-separated list of leverage values to
test
--rebalance-days TEXT Comma-separated list of rebalance
frequencies to test
--metric [sharpe|cagr|calmar] Optimization metric
--max-drawdown FLOAT Maximum drawdown constraint (e.g., 0.2 for
20%)
--fee-bps FLOAT Trading fee in basis points
--slippage-bps FLOAT Slippage cost in basis points
--prediction-lag INTEGER Days between prediction date and trading
date (default: 1, use higher values to avoid
look-ahead bias)
--top-n INTEGER Show top N results
--apply-best Run full analysis with best parameters
--save-results TEXT Save optimization results to CSV
--plot Show contour plots of results
--max-workers INTEGER Number of parallel workers (default: auto)
--clear-cache Clear cached optimization results
--verbose Show detailed progress
--help Show this message and exit.
cc-liquid profile
Manage configuration profiles (owner/vault/signer).
Usage:
Options:
cc-liquid profile list
List available profiles from YAML and highlight the active one.
Usage:
Options:
cc-liquid profile show
Show details for a profile (defaults to active).
Usage:
Options:
cc-liquid profile use
Set active profile and persist to YAML.
Usage:
Options:
cc-liquid rebalance
Execute rebalancing based on the configured data source.
Usage:
Options:
--skip-confirm Skip confirmation prompt for executing trades.
--set TEXT Override config values (e.g., --set data.source=numerai
--set portfolio.num_long=10)
--help Show this message and exit.
cc-liquid run
Start continuous monitoring and automatic rebalancing with live dashboard.
Usage:
Options:
--skip-confirm Skip confirmation prompt for executing trades.
--set TEXT Override config values (e.g., --set is_testnet=true)
--refresh FLOAT Dashboard update cadence in seconds. [default: 1.0]
--tmux Run inside a fixed tmux session (attach if exists, else
create and run).
--help Show this message and exit.