onepro_analise_portfolio
ChatGPTAná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.
onepro_buscar_ativos
ChatGPTBusca 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).
onepro_calculadora_aportes
ChatGPTCalculadoras 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.
onepro_comparar_ativos
ChatGPTAnalisa 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.
onepro_comportamento
ChatGPTReproduz 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.
onepro_composicao_ativo
ChatGPTComposiçã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.
onepro_conexao_status
ChatGPTDiagnó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.
onepro_etfs_que_carregam
ChatGPTLookup 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.
onepro_ficha_ativo
ChatGPTFicha 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.
onepro_gbi
ChatGPTGoal-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.
onepro_localizar_grafico
ChatGPTLocaliza a tela do OnePro pelo nome que o assinante usa — o da interface, o do relatório ou o apelido — e devolve a tool e os parâmetros que respondem àquele gráfico, ou a negativa explícita com a área e a aba onde ele mora, quando a tela existe no app mas não no conector. Use quando a pergunta citar um gráfico, uma aba ou um relatório pelo nome ("aquele de janelas móveis", "a consistência", "o rastreio") e você não tiver certeza de qual tool responde. Ela SÓ localiza: não executa nada e não devolve número — chame depois a tool indicada em tool com os parametros devolvidos. Quando nada corresponder, ela devolve as telas mais próximas em sugestoes: confirme com o assinante em vez de responder pela tool mais parecida.
onepro_meus_portfolios
ChatGPTLista os portfólios (estudos de carteira) salvos do assinante no OnePro: nome, descrição, data, número de ativos e as implementações de cada um, nomeadas — o mesmo modal "Meus Portfólios" da barra de slots das telas de Análise › Asset Allocation. Use como primeiro passo de qualquer análise da carteira do usuário, ou quando ele disser "minha carteira" sem nomear qual. Retorna apenas os portfólios da própria conta — pesos e nomes, nunca dados pessoais. Lista vazia = o usuário ainda não montou carteiras no OnePro (oriente-o a criar em etf1.com.br/onepro).
onepro_multiperiodo
ChatGPTComportamento da carteira em TODAS as janelas móveis de N anos do histórico: tabela de métricas, percentis de CAGR real por janela, distribuição de retornos, heatmap por ano inicial e piores sequências negativas. É a aba Multi Período do app (Análise › Asset Allocation › Multi Período), EM DIAS: "Métricas do Portfólio", "Heatmap dos retornos históricos › CAGR Real (ano inicial × horizonte)" e "Sequências de Drawdown Real". A distribuição e os percentis usam as janelas de N anos que terminam em cada pregão (no grão diário; no mensal, anos civis); o heatmap e as sequências usam anos civis completos; a tabela mede o caminho no grão da análise e vol/Sharpe/Sortino em meses. Use para "como esta carteira se comportou em janelas de 10 anos" ou para calibrar expectativas de longo prazo. 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. É análise histórica, não projeção (para projetar use onepro_prospectivo). Não devolve os heatmaps de patrimônio (real vs inflação, nominal) da tela. Respostas grandes: comece com visao='tabela' em concise; confira janela_efetiva (datas, grão e real_ate).
onepro_otimizacao
ChatGPTCalcula a fronteira eficiente do conjunto de ativos informado e a carteira ótima pelo método escolhido em 'metodo' (máximo Sharpe por default; também Ulcer, Volatilidade Alvo e Paridade de Risco), comparando com os pesos atuais: são os gráficos "Fronteira Eficiente" e "Portfólio Ótimo" da aba Otimização do app (Análise › Asset Allocation › Otimização), com o mesmo seletor de método da tela. Use para "otimize minha carteira" ou "qual a melhor combinação destes ativos". 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. A otimização é histórica (janela em janela_efetiva, com as datas e o grão) — não é recomendação; apresente como análise do período. Em dias: pesos e volatilidade vêm dos retornos mensais ancorados na data final, o drawdown do caminho diário, e a nuvem da fronteira muda com a data-base. Não aceita restrições de peso mín/máx por ativo (isso é da Exploração › Asset Allocation, fora do conector). Pesos de saída somam 100%. Precisa de 2+ ativos; para analisar risco/retorno de UMA carteira sem otimizar, use onepro_analise_portfolio, e para a tabela completa da tela (Sortino, Ulcer, tempo de recuperação), onepro_comportamento. Não devolve a "Distribuição Normal dos Retornos" nem o "Gráfico de Crescimento" da tela.
onepro_plano_retirada
ChatGPTSimula a aposentadoria: dado um patrimônio, uma carteira e uma retirada mensal em R$ de hoje, estima a probabilidade de o dinheiro durar o horizonte, o SWR (taxa segura) e o PWR (taxa perpétua). É a área Plano de Retirada do app (Análise › Plano de Retirada), nas três abas: 4% (Clássico/Rebalanceado), Bucket strategy e Dynamic spending — com a "Curva de Sobrevivência", a "Distribuição do Patrimônio" e a "Simulação de Retiradas Anuais". TUDO em termos REAIS — não aplique inflação por cima. Use para "quanto posso sacar", "meu dinheiro dura?". metodo="historico" percorre janelas reais; "monte_carlo" amostra retornos (blocos de 12 meses, seed pela data-base, o dia — repetir a chamada no mesmo dia dá o mesmo resultado; a janela termina no último IPCA/CPI publicado). 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) nos dois métodos — os parâmetros base e complementar_com_indice detalham a regra, e a resposta declara base_da_analise e complementacao. estrategia: "classico" (buy-and-hold), "rebalanceado" (anual), "baldes" (caixa/estabilidade/crescimento) e "dynamic" exigem a config correspondente (config_baldes/config_dynamic). Na estratégia de baldes, cada balde pode carregar um portfólio salvo próprio (portfolio_caixa/portfolio_estabilidade; a carteira principal é o balde de crescimento) — o balde que carrega um declara a base DELE em base_da_analise. A janela ano_inicio–ano_fim define DE QUAIS anos históricos os retornos vêm (não é o ano da aposentadoria); confira janela_efetiva na resposta. Não recomenda carteiras.
onepro_portfolio_detalhe
ChatGPTDetalha um portfólio salvo do assinante: alocação-alvo (pesos por índice) e, se existirem, as implementações com produtos concretos e custos (taxa_adm) — o que o app mostra na aba Portfolio de Análise › Implementação. implementacao_default nomeia a implementação (a mais recente) que os motores usam por default como base da análise deste portfólio. Use após onepro_meus_portfolios, passando o nome exato. Os pesos somam 100%; valores em R$ não existem no OnePro — se o usuário quiser simular com valores, peça os montantes a ele e use os motores (ex.: onepro_plano_retirada). Só lê: montar ou editar uma implementação é feito no site.
onepro_prospectivo
ChatGPTProjeção prospectiva do patrimônio via Monte Carlo: distribui os caminhos possíveis da carteira no horizonte dado, com aportes mensais opcionais (termos REAIS — R$ de hoje, sem inflação por cima). Use para "onde minha carteira pode estar em N anos". Difere de onepro_gbi (que responde a probabilidade de UMA meta) por devolver a distribuição completa (percentis por ano). 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. É a resposta mais próxima da aba Prospectivo do app (Análise › Asset Allocation › Prospectivo), mas devolve percentis de PATRIMÔNIO, não os percentis de CAGR da tela — outro motor de Monte Carlo, então não prometa os mesmos números; as "Probabilidades de Retorno" e as "Probabilidades de Quedas no 1º Ano" da tela não estão no conector. Simulações fixas em 10.000, seed pela data-base (o dia): repetir a chamada no mesmo dia dá o mesmo resultado. Confira janela_efetiva na resposta.
onepro_screener
ChatGPTBusca filtrada de ativos dentro de uma classe (screener). Chame SEM o campo "filtros" para descobrir quais filtros a classe aceita (faixas, categorias e contagens); depois chame com "filtros" preenchido para obter a lista. Use para perguntas do tipo "quais ETFs de dividendos com PL acima de X e taxa abaixo de Y". Não busca por nome (use onepro_buscar_ativos) e não retorna a ficha completa (use onepro_ficha_ativo com os tickers do resultado). Rentabilidades por data, em %: ret_ytd (no ano), ret_12m (1 ano) e ret_60m (5 anos) vão do último pregão do ativo ao último pregão até a mesma data N atrás. Cada linha traz a própria data_base (ativo sem cotação recente termina antes da data_base da resposta) e, quando o histórico antigo é mensal, a emenda (AAAA-MM).
onepro_serie_diaria
ChatGPTSéries diárias brutas de ativos e índices (IBOV, CDI, S&P 500…), na moeda pedida, para o usuário produzir a própria análise. Use quando pedirem "a série", "os dados diários" ou análises que as demais tools não cobrem. Cada ponto é [AAAA-MM-DD, nível]: o nível é base 100 no 1º ponto da janela de cada série (o retorno entre dois pontos é a razão dos níveis). O USDBRL vem em nível de verdade (R$ por US$), sem base 100. Cada série traz a própria data_base (o último ponto dela: ativo parado termina antes) e o grao; a emenda marca até quando a série tem só um ponto por mês (histórico anterior à estreia do diário). Sem equalização: cada série vai do 1º ao último ponto que tem. Até 1.800 pontos por chamada, divididos entre as séries: acima disso a série é reduzida pelo LTTB, declarado em reduzida e em ajustes. O passo dos pontos reduzidos é irregular: não calcule vol nem correlação com eles. Para estatística pronta (retorno anualizado, vol, correlação), onepro_comparar_ativos é mais barato; para comparar séries na mesma janela, onepro_comparar_ativos ou onepro_analise_portfolio.
