Como criar um portfólio por meio da importação de transações

Para criar um portfólio usando a importação de transações de um arquivo CSV:

  1. Vá para a página de portfólios.
  2. Selecione o cartão Importar arquivo CSV

Após clicar, uma janela pop-up se abrirá com as configurações para o novo portfólio e a opção de fazer o upload de um arquivo CSV com as transações.


 Campos para configuração do portfólio:

  • Nome do portfólio — nome do portfólio. Você pode inserir até 128 caracteres. Os nomes dos portfólios podem ser idênticos.
  • Moeda — moeda do portfólio. Todos os valores dos ativos serão convertidos automaticamente para esta moeda se forem negociados em outra. As posições de caixa também são contabilizadas na moeda do portfólio.
  • Taxa livre de risco — a taxa de retorno livre de risco. Este é o retorno anual teórico que pode ser obtido com risco zero ou mínimo. Normalmente, pode ser baseado em taxas de depósitos bancários, na taxa de juros básica do principal país de investimento ou em títulos públicos de longo prazo. É utilizado nos cálculos dos índices Sortino e Sharpe.
  • Benchmark — referencial de desempenho do mercado. Permite comparar o desempenho de seu portfólio com uma referência de mercado. Recomendamos o uso de um índice ou de um fundo correspondente ao mercado, ou setor de seu portfólio como benchmark. Saiba mais no relacionado artigoAjustar automaticamente as negociações para desdobramentos - quando ativado, todas as transações inseridas são ajustadas automaticamente para refletir os desdobramentos de ações
  • Descrição (opcional) — descrição do portfólio. Este campo pode ser deixado vazio. Comprimento máximo — 1200 caracteres.

Formato do arquivo CSV

Apenas um formato é suportado. O arquivo deve estar no formato CSV com a vírgula como delimitador. É necessário um cabeçalho. Um arquivo de exemplo pode ser baixado na janela de upload.

Campos suportados:

  • Símbolo — instrumento no formato bolsa:ticker (por exemplo, NASDAQ:AAPL ou BYBIT:BTCUSDT). Para adicionar uma transação de caixa, este campo deve conter — $CASH. Observação: $ é o identificador de uma transação de caixa. Todas as transações de caixa serão adicionadas na moeda do portfólio.
  • Lado — direção da transação:
    • para instrumentos: compra, venda ou dividendo
    • para caixa: depósito, retirada, impostos e taxas
  • Qtd — quantidade:
    • para transações de compra ou venda, este é o número de ativos em unidades. Se o ativo for negociado em lotes, você deve especificar o número de unidades, não de lotes.
    • para transações de dividendos, este é o valor total de dividendos recebidos de um pagamento de dividendos
    • para transações de caixa, este é o montante de dinheiro
  • Status (opcional) — suportado para a capacidade de importar transações de um painel de negociação. Se o campo estiver presente, apenas transações com o valor Executada serão adicionadas; o restante será ignorado. Se o campo estiver ausente, todas as transações serão adicionadas.
  • Preço de Execução — para transações de compra ou venda, este é o preço pelo qual a transação foi realizada. Para transações de dividendos e caixa, o valor será ignorado.
  • Comissão — para transações de compra ou venda, esta é a comissão paga quando a transação foi realizada. Para transações de caixa, o valor será ignorado.
  • Horário de Fechamento — data e hora da transação no formato AAAA-MM-DD hh:mm:ss ou AAAA-MM-DDTHH:mm:ss.sssZ. A data da transação é obrigatória. A hora da transação é opcional.

Após fazer o upload do arquivo, informações preliminares serão exibidas: número de instrumentos e número de transações que serão adicionadas, e a comissão total. Se houver erros de formato no arquivo, aparecerá uma mensagem indicando a linha. Neste caso, nenhuma transação será adicionada.

Importante

Se o número de transações ou instrumentos exceder os limites do seu nível de assinatura atual, o portfólio não será criado. Reduza o número de elementos e tente novamente.

Novo portfólio criado!

As transações do arquivo serão adicionadas ao portfólio — apenas para instrumentos suportados. Você pode editá-las na página de transações. Mais detalhes — no artigo sobre edição de transações. O guia para adição manual de transações — em um artigo separado.