Skip to content

cents backtest

Run and analyze agent backtests.

Terminal window
cents backtest <subcommand> [OPTIONS] [ARGS]...
  • cents backtest analyze — Analyze signal-to-return correlations.
  • cents backtest delete — Delete a backtest and its signals.
  • cents backtest list — List all backtests.
  • cents backtest report — Generate detailed backtest report with best/worst signals.
  • cents backtest run — Run a backtest for one or more symbols over a date range.
  • cents backtest show — Show backtest details and signals.

Analyze signal-to-return correlations.

Shows correlation and hit rate by agent across time horizons.

Examples: cents backtest analyze abc123 # Single backtest cents backtest analyze —symbol NVDA # All NVDA backtests cents backtest analyze —all # All backtests

Synopsis

Terminal window
cents backtest analyze [OPTIONS] [BACKTEST_ID]

Arguments

ArgumentTypeRequired
BACKTEST_IDtextno

Options

OptionTypeDefaultDescription
--symbol/-s TEXTtextAnalyze all backtests for symbol
--allbooleanfalseAnalyze all backtests
`—output [textjson]`[text | json]text

Example

Terminal window
cents backtest analyze [OPTIONS] [BACKTEST_ID]

Delete a backtest and its signals.

Synopsis

Terminal window
cents backtest delete [OPTIONS] BACKTEST_ID

Arguments

ArgumentTypeRequired
BACKTEST_IDtextyes

Options

OptionTypeDefaultDescription
--yes/-ybooleanfalseSkip confirmation

Example

Terminal window
cents backtest delete [OPTIONS] BACKTEST_ID

List all backtests.

Synopsis

Terminal window
cents backtest list [OPTIONS]

Options

OptionTypeDefaultDescription
--symbol/-s TEXTtextFilter by symbol
`—output [textjson]`[text | json]text

Example

Terminal window
cents backtest list [OPTIONS]

Generate detailed backtest report with best/worst signals.

Synopsis

Terminal window
cents backtest report [OPTIONS] BACKTEST_ID

Arguments

ArgumentTypeRequired
BACKTEST_IDtextyes

Options

OptionTypeDefaultDescription
`—output [textjson]`[text | json]text

Example

Terminal window
cents backtest report [OPTIONS] BACKTEST_ID

Run a backtest for one or more symbols over a date range.

Examples: cents backtest run NVDA —start 2023-01-01 —end 2024-01-01 cents backtest run —symbols AAPL,MSFT,NVDA —start 2023-01-01

Synopsis

Terminal window
cents backtest run [OPTIONS] [SYMBOL]

Arguments

ArgumentTypeRequired
SYMBOLtextno

Options

OptionTypeDefaultDescription
--symbols TEXTtextComma-separated list of symbols (alternative to positional arg)
--start/-s TEXTtextStart date (YYYY-MM-DD)
--end/-e TEXTtextEnd date (YYYY-MM-DD, default: 60 days ago)
`—interval/-i [dailyweeklymonthly]`[daily | weekly | monthly]
--agents/-a TEXTtextComma-separated list of agents (default: all)
`—output [textjson]`[text | json]text

Example

Terminal window
cents backtest run [OPTIONS] [SYMBOL]

Show backtest details and signals.

Synopsis

Terminal window
cents backtest show [OPTIONS] BACKTEST_ID

Arguments

ArgumentTypeRequired
BACKTEST_IDtextyes

Options

OptionTypeDefaultDescription
`—output [textjson]`[text | json]text

Example

Terminal window
cents backtest show [OPTIONS] BACKTEST_ID
Not financial advice. Cents is an educational and research tool for tracking your own investment theses. Outputs are model-generated and may be inaccurate. You are solely responsible for your own investment decisions.