OnePro AI

Análise completa de uma ou mais carteiras (salvas ou montadas na conversa), EM DIAS: retorno, risco, drawdown e recuperação em dias, contra até 5 benchmarks (com 'portfolios' e sem benchmarks, entram CDI e IBOV, o default da tela; em 'carteiras', só o que você pedir). A carteira tem rebalanceamento mensal; a janela é a de TODAS as linhas (benchmarks inclusive) e a resposta traz o grão, a data-base e quem limitou a janela em janela_efetiva — cite-os. Um ativo só mensal na janela leva a análise ao mensal. IPCA ou CPI como benchmark terminam a janela no último mês publicado. Portfólio salvo entra pela IMPLEMENTAÇÃO (produtos e taxas reais; base='classes' mede a alocação-alvo), com base_da_analise e a complementação declaradas. É a tool de "analise minha carteira" e da área Análise › Comparativo: "Ranking de Portfolios", "Consistência de Retorno — 10 Anos", "Recuperação dos Portfólios" e "Janelas Móveis" com a tabela de vitórias. 'carteiras' reproduz o montador da tela: até 10 linhas, cada uma um portfólio salvo ou itens {ticker, peso}, produto OU índice do catálogo (um índice sozinho a 100% É o índice). visao="ranking" ordena carteiras, "consistencia" cobre janelas de 10 anos, "sequencias_negativas" os piores períodos e "janelas_moveis" responde "em quantas janelas de N anos a carteira superou o CDI": o retorno de cada janela é ACUMULADO, nunca anualizado. A "Correlação 5 anos móveis" NÃO está no conector. Para a aba Comportamento de UMA carteira use onepro_comportamento. Fundo entra pelo CNPJ e pode ser medido COM COME-COTAS (come_cotas=true). Resultados nominais na moeda pedida. Não otimiza pesos (onepro_otimizacao) nem projeta o futuro.

Busca ativos e índices por ticker ou trecho do nome no catálogo do OnePro (ETFs BR e globais, ações, BDRs, FIIs, fundos, debêntures, renda fixa, criptoativos, índices). Use PRIMEIRO sempre que o usuário citar um ativo por nome ou ticker incerto — as demais tools exigem o identificador exato retornado aqui (ticker; slug para RF pública; ISIN para RF privada; par BTC-USD para criptoativo). A busca é por texto (substring), não semântica: prefira o ticker ou um trecho único do nome ("IVVB", "Ibovespa"); descrições genéricas ("ETF de S&P 500 da BlackRock") não encontram nada. Não retorna preços nem retornos (use onepro_ficha_ativo).

Calculadoras determinísticas de acumulação, sem carteira: que retorno anual preciso para chegar à meta (retorno_necessario), quanto terei (patrimonio_alvo), quanto aportar (aporte_necessario) e se um plano fecha (verificar_plano) — tudo em termos REAIS (R$ de hoje e % a.a. acima da inflação). São as abas de Análise › Aportes do app: retorno necessário, patrimônio alvo e sucesso aposentadoria (esta parte da renda mensal alvo — converta em meta de patrimônio antes). A quarta aba, TWRR x MWRR, NÃO está no conector: só existe no site. Use para contas rápidas de planejamento; para probabilidade com uma carteira concreta use onepro_gbi, e para simular a aposentadoria (retiradas), onepro_plano_retirada. Cada cálculo exige campos próprios — o erro diz exatamente o que falta.

Analisa o histórico de 1 ativo ou compara 2 a 10 no mesmo período e moeda: retorno, CAGR, volatilidade, Sharpe, drawdown máximo e correlação. Use para "qual foi melhor", "quão correlacionados são", "qual caiu mais" ou o risco de um ativo. A análise de 1 ativo (de qualquer classe) e a comparação de 2+ saem em DIAS (dados até D-1): leia o grão (janela_efetiva.grao) e cite data_base. A janela vai da data inicial mais tarde à final mais cedo de todas as linhas, benchmarks inclusive (janela_efetiva.limitado_por diz quem cortou); com IPCA ou CPI na análise (1 ativo sem benchmarks já os inclui), ela termina no último mês publicado. Um ativo só mensal na janela leva tudo ao mensal. Drawdown e recuperação em dias; vol, Sharpe e correlação usam meses, ancorados na data final. Para medir contra um índice (IBOV, IDIV, CDI, IFIX, IMA-B, S&P 500…), passe a sigla em benchmarks — índice não entra em tickers. Não projeta o futuro (para simulação use os motores, ex.: onepro_plano_retirada). incluir_overlap=true acrescenta as posições em comum entre ETFs. incluir_janelas_moveis=true responde o gráfico "Janelas Móveis" — em quantas janelas de 1, 3, 5, 10, 15 e 20 anos cada linha ficou acima das outras —, com o retorno de cada janela ACUMULADO do período, NUNCA anualizado: não compare esses % com CAGR. Para o mesmo gráfico de CARTEIRAS use onepro_analise_portfolio (visao="janelas_moveis"). FUNDO entra aqui com a série BRUTA de come-cotas: o Comparativo do OnePro TEM o checkbox "Aplicar come-cotas" por slot de fundo; pedido com come-cotas vai em onepro_analise_portfolio com come_cotas=true, cada ativo como uma carteira de um item a 100%. Nunca responda que "o comparador não tem come-cotas": é esta rota que não aplica o imposto.

Reproduz a aba Comportamento do OnePro (Análise › Asset Allocation › Comportamento) para UMA carteira, EM DIAS: métricas (retorno, CAGR real, volatilidade, Sharpe, Sortino, Ulcer, melhor/pior ano, maior queda e o tempo de recuperação em dias, do vale à volta ao pico), retorno ano a ano, rentabilidade suavizada, drawdown, correlação, as quedas intra-ano (por ano, o retorno e a maior queda DENTRO do ano, com o pregão do vale) e as janelas móveis — os mesmos números do app. Analisa EXATAMENTE os pesos informados, com rebalanceamento mensal, sem otimizar (para otimizar use onepro_otimizacao e passe os pesos como 'carteira'). A resposta traz o grão, a data-base e quem limitou a janela em janela_efetiva — cite-os; um ativo só mensal leva a análise ao mensal, e IPCA ou CPI na sub-aba Índices Econômicos terminam a janela no último mês publicado. Portfólio salvo entra pela IMPLEMENTAÇÃO (produtos e taxas reais; base='classes' mede a alocação-alvo), com base_da_analise e a complementação declaradas. Use quando o usuário citar a aba Comportamento ou um de seus gráficos ("Rentabilidade do Portfólio", "Rentabilidade Anual e Maior Queda Dentro do Ano", "Janelas Móveis", "Performance Frente aos Benchmarks"); para comparar carteiras entre si, ranking e consistência, a tool é onepro_analise_portfolio. 'incluir' reproduz as sub-abas Ativos, Índices Econômicos (IPCA, CPI, CDI, dólar) e Rastreio (IBOV, CDI, TSM, TSMUS). visao='janelas_moveis' responde "em quantas janelas de N anos a carteira superou o CDI": o retorno de cada janela é ACUMULADO, nunca anualizado — não compare com CAGR; para CAGR real por janela use onepro_multiperiodo. A série de uma janela sai com response_format='detailed' e 'janela_anos'. A "Correlação 5 anos móveis" NÃO está no conector.

Composição de um ETF, BDR ou FII: visão "resumo" traz agregados por setor, país e as 10 maiores posições; visão "posicoes" lista as posições individuais, paginadas. Use quando o usuário perguntar "o que o fundo X carrega". Para o caminho inverso ("quem carrega a ação Y"), use onepro_etfs_que_carregam. Não cobre fundos sem carteira divulgada (a resposta orienta a alternativa). ETFs de ETFs são decompostos: as posições efetivas (look-through) declaram o ETF de origem em via_etf.

Diagnóstico da conexão com o OnePro: status da assinatura, cotas de uso restantes e versão do snapshot de dados — o mesmo estado que o assinante vê em Configurações › OnePro AI no app. Use quando outra tool falhar de forma inesperada, quando o usuário perguntar "por que não funciona" ou para saber a data-base dos dados. Não retorna dados pessoais nem de carteira; conectar ou revogar um cliente de IA é feito no site, nessa mesma tela.

Lookup reverso de holdings: dado um ativo (ex.: NVDA, PETR4, BTC-USD), lista os ETFs do catálogo que o carregam e com que peso, do maior para o menor. Use para "quais ETFs têm exposição a X" ou "quem carrega Y". Não responde a composição de um fundo (use onepro_composicao_ativo). Não cobre fundos sem carteira divulgada — um ativo pode estar em mais ETFs do que os listados.

Ficha completa de UM ativo de qualquer classe: identificação, custos, PL, retornos por período, alocação e estrutura. Use quando o usuário quiser entender ou avaliar um ativo específico; para comparar dois ou mais, prefira onepro_comparar_ativos; para posições individuais da carteira do fundo, use onepro_composicao_ativo. Exige o identificador exato (resolva antes com onepro_buscar_ativos). Retornos na moeda pedida. Toda classe com série responde em dias (dados até D-1): cotacao (último fechamento, cota ou PU, com a data_base DO ATIVO; nula no fundo sem cota publicada), retornos 1D/5D/1M/6M/YTD/1A/3A/5A/10A/Max contados por data, grao de cada período, emenda ("mensal até AAAA-MM") e dias_sem_negocio (só papel da B3). Ativo sem diário (tem_diario=false) responde no mensal e a nota diz isso. Cite a data-base e o grão. O bloco complementacao diz se o histórico foi estendido pelo índice de referência do ativo.

Goal-based investing: probabilidade de a carteira atingir uma meta de patrimônio em um prazo, dado o patrimônio atual e aportes mensais (valores em R$ de hoje, resultado em termos REAIS — não aplique inflação por cima). É a aba Sucesso do portfólio do app (Análise › GBI): "Taxa de Sucesso", "Trajetórias Históricas vs. Meta", "Distribuição de Patrimônio Simulado vs. Meta" e os percentis por horizonte. Use para "chego a R$ X em N anos?". Portfólio salvo entra pela IMPLEMENTAÇÃO (produtos e taxas reais, a mesma carteira de onepro_analise_portfolio; base='classes' mede a alocação-alvo) — os parâmetros base e complementar_com_indice detalham a regra, e a resposta declara base_da_analise e complementacao. Se o usuário quiser o aporte ou retorno NECESSÁRIO para a meta (cálculo determinístico, sem carteira), use onepro_calculadora_aportes; para a distribuição completa sem meta, onepro_prospectivo. Seed pela data-base (o dia): repetir a chamada no mesmo dia dá o mesmo resultado. Confira janela_efetiva na resposta.