backtest · wire operation
Run a cross-sectional backtest
Backtest a point-in-time cross-sectional strategy: a returns dataset with declared features, a universe history with entries and exits, one declarative signal (a versioned factor recipe, a composite score, or a screen), a rebalance schedule, and a portfolio construction (quantile/count/fraction selection on each side; equal, score, inverse-volatility, or risk-budget weights; dollar/sector/beta/factor neutrality; position, weight, turnover, and participation caps — every trim a reported goal). Fills go through the execution policy into the portfolio ledger; the final value reconciles to the ledger NAV. Rebalances, holdings, fills, the ledger, the timeline, attribution, the benchmark block, and the performance summary — crossSectionalBacktest(...) verbatim. Opt-in (backtestPack): payloads and runtime are heavier than the default set; bulk row sets above the row cap travel by handle.
totalfinance.backtest.cross_sectional_run- MCP tool name
- totalfinance_backtest_cross_sectional_run
- Pack / profiles
- backtest / backtesting, full
- Default discovery
- Opt-in (select its pack or profile)
- Required capabilities
- None
- Effects / authorization
- none / none
- Cost / cancellation
- job / Do not assume inline interruption
- Handle-eligible inputs
- dataset
- Idempotency
- not-applicable
Input schema
| Field | Type | Meaning |
|---|---|---|
datasetRequired | object | — |
universeHistoryRequired | object | — |
signalRequired | object | object | object | The three declarative signal forms; a signal callback is SDK-only |
rebalanceScheduleRequired | object | — |
portfolioConstructionRequired | object | — |
executionOptional | object | A declared execution policy over session bars (execution.declared): the label is the caller's claim; a caller fill model, session rules, and quote/order-book observations are SDK-only |
transactionCostModelOptional | object | — |
initialCapitalOptional | number | Default 1,000,000 |
baseCurrencyOptional | string | Default 'USD' |
windowOptional | object | — |
periodsPerYearOptional | number | Default 252 |
riskFreeRateOptional | number | Per-period; default 0 |
seedOptional | integer | Seeds only the bootstrap confidence intervals; absent = none |
Complete JSON Schema
Loading…
Output schema
| Field | Type | Meaning |
|---|---|---|
rebalancesRequired | object[] | — |
holdingsRequired | object[] | — |
pointsRequired | object[] | — |
returnsRequired | number[] | — |
tradesRequired | object[] | — |
fillsRequired | object[] | — |
ledgerRequired | object | The portfolio ledger snapshot (events) |
timelineRequired | object | The ledger timeline |
attributionRequired | object | — |
benchmarkRequired | object | null | — |
performanceRequired | object | The standard performance summary |
performanceConfidenceRequired | object | null | — |
finalValueRequired | number | — |
runIdRequired | string | — |
assumptionsRequired | object | Applied conventions |
diagnosticsRequired | object | Engine, method, warnings |
Complete JSON Schema
Loading…