Certificação Walk-Forward OOS
O motor determinístico out-of-sample. Walk-forward, modo de validação, ancorado, 5 folds, 2022→hoje — os folds OOS são o veredito, não um único backtest.
A chamada do estudo
mcp__nexustrade__run_walk_forward_study (as ferramentas são diferidas — carregue via ToolSearch). Execute sempre
preview_only: true PRIMEIRO para ver o calendário de folds + custo, confirme que ele abrange 2022→hoje (deve incluir
tanto o bear market de 2022 quanto a queda de abril de 2025 — o maior drawdown deste livro é um evento de abril
de 2025, então os folds precisam abrangê-lo), depois mude para false e registre o study_id.
{
"portfolio_id": "<SUJEITO ou um clone limpo>",
"global_start_date": "2022-01-01",
"global_end_date": "<HOJE>",
"fold_count": 5,
"walk_forward_mode": "anchored",
"mode": "validation", // OOS independente por fold
"oos_width_days": 252,
"embargo_days": 14,
"interval": "Day",
"inner_mode": "backtest_only", // certifica o livro FIXO — sem otimizador por fold
"preview_only": true // mude para false para executar de fato
}
- Certificar um livro fixo:
inner_mode: "backtest_only"(engine_kind ga/default — um sweep é rejeitado para certificação de configuração fixa). - Reotimizar (apenas em FALHA ou mudança estrutural):
engine_kind: "sweep",inner_mode: "optimize",certification: true, maisgene_intents. GA sobreajusta e é rejeitado para certificação de deploy — sweep é o caminho certificado. Veja sweep-reotimização. certification: trueaplica a política de piso de atividade +percentChange ≥ 0+sortino ≥ 0.5e definevalidation_percentcomo 50.
Pré-voo antes de certificar um livro ao vivo
get_portfolio— capture o conjunto de estratégias,conditionFieldAudite a escada de saída.- Remova o LaunchAgent. Uma estratégia LaunchAgent não pode ser executada historicamente — ela dispara uma vez e registra
milhares de eventos
cooldownSkip, contaminando os folds. Certifique um clone sem LaunchAgent (apenas regras de rebalanceamento e fechamento) e diga que fez isso. - Verificação de formato de spread das estruturas ao vivo (veja regras-de-estrutura-de-opções). Um spread vertical de longo prazo é uma violação grave → o livro não pode certificar como está; vá direto para reotimização.
- Armadilha de limite de convexidade: se múltiplos fechamentos de take-profit "sempre" existem (ex.: P/L ≥ 20% / 50% / 200%), o mais baixo vincula primeiro e limita todo vencedor a ~+20%, frustrando a lógica da compra de opção. Sinalize isso — é a razão mais provável para retornos ficarem atrás de um livro que deixa os vencedores correrem.
Monitorar o estudo
Consulte list_walk_forward_studies / get_walk_forward_study_results <study_id> até o estado terminal
(COMPLETE / ERROR / CANCELLED). Analise com jq — os payloads são grandes, não os despeje. Fique atento a
modos de falha conhecidos e os exiba (não os ignore — isso aciona um protocolo-de-bug):
- Falha silenciosa / ERROR — sem estatísticas de fold /
validationAggregatevazio. Reporte; não invente um veredito. - Janela errada — calendário de folds não começando em 2022-01-01 / pulando o bear market.
- Contaminação do backtest — LaunchAgent disparando nos folds (deveria ter sido removido no pré-voo).
- Folds com zero negócios / NaN — corrupção de marcação de posição upstream; reporte quais folds, nunca calcule média sobre NaNs.
- Um estudo genuinamente travado além do custo/tempo estimado → pare, resuma, aguarde o humano (o motor pode estar sendo reparado em outra aba).
As verificações obrigatórias por fold (estas SÃO o veredito)
- Tabela OOS por fold — para cada fold: janela de treino, janela OOS, retorno OOS, maxDD OOS, Sortino OOS,
implantação mediana, subjacentes distintos, participação. Mais o
validationAggregate. - Verificação pontual com re-backtest independente —
backtest_portfolio($25k) no ciclo completo (2022-01-01→hoje), no bear market de 2022 (2022-01-01→2023-01-01) e nos últimos 12 meses;audit_backtest_posturena execução do ciclo completo. Os folds do estudo devem concordar com um backtest standalone novo. Linha de base ≠ SPY para um livro de opções — use um subjacente material ou um universo de comprar e manter com pesos iguais, e anote isso. - Degradação — treino vs OOS por fold. Grande colapso treino→OOS = sobreajuste, mesmo que o backtest do ciclo completo pareça ótimo.
- Honestidade do drawdown — maxDD OOS junto com retorno OOS por fold; lidere com risco. Nessa alavancagem, um fold pode exibir um retorno enorme e um drawdown de 50–77%.
- Portão de amplitude a FIXOS $25k (auditoria-de-amplitude).
- Reprodutibilidade / auditoria de campo —
conditionFieldAuditcorresponde aos controles pretendidos;compare_backtests {tolerance_bps: 0}em uma reexecução. Verifique por campo, nunca por nome de exibição. - Conformidade de formato de spread (regras-de-estrutura-de-opções) — rejeição forte em violação.
Alinhamento de calendário (variante vs base)
O motor walk-forward corta o calendário de folds para a cobertura do indicador / dados, portanto o estudo de uma
variante pode silenciosamente obter folds diferentes dos da base. Sempre execute um CONTROLE base com o
mesmo global_end_date que o calendário cortado da variante e compare fold por fold. Reporte a cobertura de sinal
por fold junto com o OOS por fold. Uma variante que só vence onde o sinal existe é uma constatação, não uma trapaça —
mas diga isso.