Author

Topic: Portfolio Performance [Código Aberto] - Controle o seu (crypto) portefólio! (Read 110 times)

legendary
Activity: 2688
Merit: 2297
Crypto Swap Exchange
Sempre procurei um app que importasse os trades e mostrasse os lucros/perdas de forma prática e bonita.. Pena que parei com essa vida, se algum dia eu voltar vou testar..

Quanto a usar planilhas, já tentei e da muito trabalho..
legendary
Activity: 1148
Merit: 3117
Bastante interessante.

Como mencionei no tópico global, eu sempre tive muito receio de colocar meus dados financeiros em qualquer aplicação semelhante. Dados financeiros são bastante sensíveis, e esses programas que mantem seus dados num servidor são um pesadelo pra privacidade.

Como resultado, há anos eu controlo meus investimento numa planilha do excel, que atende totalmente minhas necessidades.
Reconheço que, de todos os programas que existem, uma folha de excel acaba por ser talvez a mais privada. Contudo, como referi, a suite do Office continua a ser um conjunto de programas em código fechado e que não sabemos que tipo de informações é que acabam por ser enviadas para os servidores deles... Certamente que é menor que nas outras aplicações, mas acho que sabemos o quão intrusivo o Windows tem ficado (e cada vez mais nos últimos anos). A melhor solução acaba mesmo por ser instalar o programa no Linux ...

Bom tutorial @RickDeckard.
Obrigado.

Eu desconhecia o programa, o que pareceu bem interessante.

Fiquei com uma duvida, ele automaticamente indica qual é o valor do ativo no momento e apresenta os respetivos ganhos/perdas, dos ativos, correto?
Ainda bem que viste o conteúdo como útil joker_josue! Traduzi na integra o guia, espero que tenha ficado claro.
Em relação à questão sim, ele actualiza com a informação que é fornecida pelo CoinGecko ...
legendary
Activity: 1722
Merit: 4711
**In BTC since 2013**
Bom tutorial @RickDeckard.
Obrigado.

Eu desconhecia o programa, o que pareceu bem interessante.

Fiquei com uma duvida, ele automaticamente indica qual é o valor do ativo no momento e apresenta os respetivos ganhos/perdas, dos ativos, correto?
legendary
Activity: 2352
Merit: 6089
bitcoindata.science
Bastante interessante.

Como mencionei no tópico global, eu sempre tive muito receio de colocar meus dados financeiros em qualquer aplicação semelhante. Dados financeiros são bastante sensíveis, e esses programas que mantem seus dados num servidor são um pesadelo pra privacidade.

Como resultado, há anos eu controlo meus investimento numa planilha do excel, que atende totalmente minhas necessidades.

Mas certamente para uma pessoa que não tem nenhuma planilha de investimentos ou usa um programa de terceiros que envia seus dados para um servidor, vale a pena migrar para esse aí!

Ver a carteira crescendo é um ótimo estimulo para poupar e investir com mais dedicação. Visualizar tudo em um só lugar também ajuda em muito a realocar (quando necessário) e tomar boas decisões.
legendary
Activity: 1148
Merit: 3117
Reservado - Actualizações Futuras?
legendary
Activity: 1148
Merit: 3117


.
Índice Remissivo
Introdução
Instruções para Windows
Conclusão
Referências

.
Introdução
.
Sobre o Portfolio Performance

Fazendo uso das palavras dos programadores contidas no site oficial[1], o Portfolio Performance é:
Quote
Uma ferramenta de código aberto para calcular o desempenho global de uma carteira de investimentos - em todas as contas - usando o Retorno Ponderado Pelo Tempo ou a Taxa Interna de Retorno.
.
Porquê utilizá-lo?

Sei no que estão a pensar - existem centenas de programas que me permitem controlar as minhas finanças. Temos programas como o do FTX[2] (antigamente chamado de "Blockfolio"), Delta.app - propriedade do eToro desde finais de 2019[4] -, CoinMarketCap Portefolio Tracker[5], Coinpeak[6] e até mesmo folhas de Excel da Google feitas por vários utilizadores[7][8] de todas as partes do mundo. Porque é que escolheria usar uma aplicação alemã que é claramente direcionada mais para produtos financeiros tradicionais? Bem, ao contrário das soluções previamente apresentadas onde não sabemos que tipo de dados é que são recolhidos - FTX, Delta.app, ConMarketCap, Microsoft Excel + Google Sheets são produtos de código fechado -, o Portfolio Performance é uma ferramenta grátis e de código aberto, podendo ser auditada por qualquer pessoa que o queira fazer. Visitem a página de GitHub[9] e comprovem por vocês mesmos!

.
Pontos Positivos / Delta

Pontos PositivosDelta
_____________________________________________________________________________________________________________________________________________________
  • Código aberto;
  • Funciona completamente offline;
  • Não depende de nenhum servidor externo - Uma vez instalado irá ser possível executá-lo a qualquer altura;
  • Fornece indicadores muito exaustivos como, por exemplo, Retorno Ponderado Pelo Tempo, Taxa Interna de Retorno...;
  • Suporta múltiplos idiomas - (Inglês, Espanhol, Holandês, Português (BR), Italiano ...)
  • Aplicação alemã - A procura por ajuda irá levar, a maior parte das vezes, a respostas em alemão;
  • Curva de aprendizagem média;
  • Não existe nenhuma aplicação móvel de momento. Contudo, estão a trabalhar[10] para lançar uma no futuro;

.
Instruções para Windows
.
Instalar o programa

É a parte mais fácil - basta aceder ao endereço web (Versão inglesa mencionada anteriormente[1]) e clicar no sistema operativo desejado. Num futuro próximo (espero eu) irei adicionar um passo adicional que permite verificar o ficheiro descarregado.



.
Definir o idioma

Por defeito o programa deverá aplicar o mesmo idioma que está a ser utilizado pelo vosso Sistema Operativo. Caso isso não aconteça e assumindo que o programa adopta o alemão como língua de interacção, sigam os próximos passos para proceder à alteração do idioma:



Depois de clicar no botão identificado com o número 3 é necessário reiniciar  o programa para as alterações serem aplicadas.

.
Menu principal - Criar um ficheiro de portefólio

Sempre que abram o programa vão ser introduzidos à seguinte janela:



Uma vez que estamos a criar um novo ficheiro que irá ser guardado com a extensão .XML no vosso computador, podemos prosseguir ao clicar na opção "Criar novo ficheiro (A secção de Exemplos já possui alguns ficheiros de amostra criados cujo propósito é mais direccionado para a gestão de títulos tradicionais e para demonstrar o potencial do programa (se estiverem interessados podem também explorar esses ficheiros)). A próxima janela que aparece é bastante simples, apenas têm de selecionar a moeda em que querem que o vosso portefólio seja baseado (neste tutorial vou usar o EURO). Assim que estiverem prontos selecionem o botão Seguinte.



Vão ser introduzidos à seguinte janela:



Estes dois conceitos - Conta de Títulos e Conta de Referência - são a "essência" do programa. Passo a explicar:

  • Conta de Referência - Interpretem esta designação como sendo uma conta/saco onde irão depositar/levantar o vosso dinheiro.
  • Conta de Títulos - É a conta onde vão acumular os vossos títulos (neste caso as criptomoedas). Será nesta conta que irão registar todas as transacções que fizeram num determinado intermediário financeiro.

Vamos assumir, por exemplo, que quero comprar BTC do LocalCryptos.com[12] (um intermediário financeiro que não tem processos de KYC). Teria de configurar da seguinte forma:

  • Conta de Referência - Podem dar-lhe qualquer nome. Para este exemplo fui para o mais simples - "Conta de Depósito";
  • Conta de Títulos - Uma vez que já mencionei onde pretendo fazer as minhas transacções, vou dar-lhe o nome desse mesmo serviço - "LocalCryptos";

Cliquem em Adicionar para salvar este registo e a seguinte janela irá aparecer:



Se costumam vender/comprar noutros intermediário financeiros (HodlHodl, LocalCoinSwap, Bitsq), também os podem adicionar nesta etapa. Assim que estejam prontos, cliquem em Terminar.

.
Menu principal do portefólio

Quando terminarem a etapa anterior vão ser introduzidos à seguinte imagem que é constituida por 5 secções principais. Estão bastante bem resumidas aqui[11] pelo que passo a citar::



Quote
  • Títulos - Nesta secção especifica todos os títulos sobre os quais pretende criar transacções.
  • Contas - Nesta secção regista as suas transacções nas suas contas de corretagem (por exemplo, depósitos, levantamentos, compra, venda, dividendos).
  • Relatórios - Nesta secção pode ver gráficos sobre a sua carteira e como esta está a funcionar de acordo com várias métricas
  • Taxonomias - Nesta secção pode ver como a sua carteira é distribuída por classes de activos. Pode também especificar a sua alocação de activos alvo.
  • Dados Gerais - Nesta secção pode ver a evolução das taxas de câmbio de moeda e pode também alterar os detalhes de onde a informação ETF é obtida.

.
Realizar o primeiro deposito

Para dar início à compra de criptomoedas é necessário ter fundos disponíveis na conta do portefólio. Para fazer isso temos de fazer os seguintes passos:

  • Clicar em Contas de Depósito -> Clicar com o botão direito do rato na vossa conta de depósito (no meu caso tinha o nome de "Conta de Depósito") -> Selecionar "Depósito..."



Na próxima janela poderão introduzir a quantia que desejam depositar na vossa conta (vamos assumir que vão ser 1.000 €). Podem também adicionar em que data e hora foi feito este depósito, sendo possível também complementar com uma pequena nota. Depois de preencher todos os campos cliquem em Salvar.



Se clicarmos no menu de Posição de Activos vamos ver que os 1.000 € são agora 100 % do nosso portefólio. Estamos prontos para trocar este valor por criptomoedas!



.
Adicionar títulos (BTC, ETH, XMR ...)

Na sua gênese, não era possível adicionar nenhum tipo de criptomoeda ao nosso portefólio. Hoje em dia essa situação já não se verifica - se o vosso objectivo é adicionar criptomoedas como o BTC ou ETH (ou qualquer outra criptomoeda no Top 10 de volume por exemplo) apenas têm de seguir os seguintes passos:

  • Clicar em Todos os Títulos -> Clicar no sinal de + -> Selecionar "Novo instrumento..."



Na secção de pesquisa introduzam o nome da cryptomoeda que desejam. Neste exemplo vou escrever  "btc" e clicar Busca. Vão aparecer muitas opções mas as que mais nos interessam são aquelas que dizem "Bitcoin EUR" ou "Bitcoin USD". Selecionem a opção que se adequa a vocês (Vou selecionar Bitcoin EUR) e cliquem em Aplicar.



Uma janela nova aparece permitindo a introdução de pormenores adicionais do instrumento financeiro. Não recomendo que alterem os valores nesta aba. Recomendo, contudo, que selecionem a aba "Cotações Históricas" para escolherem a fonte responsável por actualizar os valores dos títulos do vosso portefólio (neste caso o BTC).



Como podem ver a opção que vem por defeito é o Yahoo Finance. Pessoalmente recomendo outra fonte de dados - CoinGecko. Se estiverem alinhados com a minha recomendação, cliquem nessa opção da lista. Um conjunto de novos dados para introduzir vão aparecer:



Como podem observar na imagem anterior, numa primeira análise, parece que a fonte dos dados está em erro - nenhum valor é apresentado na tabela. O que precisam de fazer é introduzir o "endereço" da CoinGecko que, em conjugação com o ID da moeda - pode ser encontrado aqui[13] -, permite actualizar este campo. Se procurarmos por "bitcoin" na lista enorme que nos aparece vemos que, como seria de esperar, o ID da BTC é bitcoin. Adicionamos essa informação no campo anterior e a tabela já actualiza automaticamente:



Prossigam para a próxima etapa clicando em OK. Está feito!! Acabaram de adicionar o primeiro título ao vosso portefólio! Podem repetir o passo anterior para adicionar mais criptomoedas.

.
Adicionar transacções

Tendo depositado dinheiro na conta de depósito e adicionado os primeiros títluos, estamos em condições de começar a registar as nossas transacções. Para tal sigam os próximos passos:

  • Clicar em Contas de Títulos -> Clicar com o botão direito do rato no nome da conta de títulos respetivo (uma vez que farei compras no LocalCryptos, dei o mesmo nome à conta) -> Selecionem "Comprar..."



A próxima janela é simples - apenas têm de introduzir toda a informação relativa às vossas compras. Se tiverem adicionado mais do que um título nas etapas anteriores podem selecionar aquele que vão comprar no campo Activo. Para demonstrar as potencialidades dos relatórios gerados pelo programa vou simular uma compra - a título de experiência - de 6 BTC, a 01/01/2015, a 100 € cada uma. Assim que estejam prontos para avançar cliquem em Salvar. janela:



Na vossa Posição de Activos verão que o saldo do vosso portefólio foi ajustado tendo em conta a mais recente transacção adicionada:



Se clicarem na opção Performance contida dentro do menu Relatórios, vão visualizar o seguinte quadro informativo:



Chamo a atenção que estes indicadores apenas dizem respeito a 1 ano. Se aumentarmos o alcance para, por exemplo, 3 anos - podem-no fazer clicando na opção no canto superior direito - seríamos "presenteados" com a seguinte informação:



A tabela à direita também dá uma informação valiosa - Se eu vendesse o meu BTC hoje, teria mais valis de 168,344.56 €. Com mais transacções a serem registadas esta tabela é bastante útil para informar, de uma forma rápida, se estamos com mais valias (ou não).

.
Secção Extra I - P: "Eu não encontro a minha "inserir nome aleatório de moeda"! Posso utilizar o programa mesmo assim?"

Podem sim pequenos gafanhotos, apenas têm de seguir alguns passos adicionais. Sigam a etapa Adicionar títulos (BTC, ETH, XMR ...) até à fase em que têm de clicar no sinal +. Em vez de escolherem a opção "Novo instrumento...", cliquem na opção "Instrumento Vazio...". No próximo menu podem dar um nome à vossa criptomoeda (vou usar a Railgun para este exemplo) e procedam logo para a aba de Cotaçoes Históricas. No campo de Provedor escolham JSON.



Para terem o registo dos preços históricos desta moeda precisam da informação desta[13] fonte - ID da moeda (previamente mencionado e explicado) - e este link base:
Quote
Têm, contudo, de adaptar este link ao nome da cryptomoeda, à moeda (EUR ou USD) e aos dias que querem abrangir. Neste caso vou usar a seguinte informação:

  • id- railgun
  • currency (XYZ) - eur
  • days (XY) - 365

Agora apenas precisamos de preencher os seguintes campos na próxima janela:



Code:
Feed URL: https://api.coingecko.com/api/v3/coins/railgun/market_chart?vs_currency=eur&days=365
Caminho para a data: $.prices[*][0]
Caminho para o fecho: $.prices[*][1]

Quando terminarem cliquem em OK e está feito! A vossa próxima criptomoeda prestes a "explodir" foi adicionada ao vosso portefólio. Agarrem-se bem a esse lugar no foguete!



.
Secção Extra II - P: "Tenho centenas de transações no meu corrector, tenho de inserir manualmente cada uma delas?"

Não. O programa está preparado para importar um ficheiro CSV contendo as vossas transacções (assumindo que o vosso intermediário financeiro vos fornece esta informação). Originalmente pensei em adicionar uma etapa a descrever este processo, mas encontrei este[14] guia que explica bastante bem o processo (está, contudo, em Inglês. Se virem que é necessário posso traduzir e adicionar ao guia). Sigam o guia e estarão prontos a importar as vossas transações para a conta de títulos que desejarem. Se tiverem problemas escrevam neste tópico e farei tudo para ajudar!

.
Conclusão

Basicamente é isto! Estão totalmente prontos para adicionar qualquer criptomoeda que desejem - desde que seja seguida pelo CoinGecko - e também estão prontos para importar as vossas transacções para o novo portefólio. Não é, de todo, o programa mais intuitivo mas só o simples facto de saber que se trata de um programa grátis e de código aberto é uma segurança adicional tendo em conta que sabemos que ninguém está a vender os nossos dados privados a terceiros. Uma pequena nota : Acabei por não cobrir a parte de registar as vendas de activos porque é um processo bastante similar ao de registar as compras. Contudo, se acharem que é necessário digam e crio essa secção!

Aviso nº1: Partes deste guia foram baseadas nesta fonte[11]. Uma vez que se trata de um guia mais direccionado para investimentos tradicionais decidi juntar neste guia as partes essenciais que permitem aos utilizadores registar o vosso portefólio de criptomoedas. Recomendo explorarem o programa caso decidam utilizá-lo para registar outro tipo de investimentos.
Aviso nº2:O guia foi inicialmente publicado em Inglês a 16 de Janeiro no board "Beginners & Help". Podem consultá-lo aqui[15].

.
Referências

[1]https://www.portfolio-performance.info/en/
[2]https://blockfolio.com/
[3]https://delta.app/en
[4]https://techcrunch.com/2019/11/06/investment-platform-etoro-acquires-crypto-portfolio-tracker-app-delta/
[5]https://coinmarketcap.com/portfolio-tracker/
[6]https://coinpeak.io/
[7]https://www.reddit.com/r/CryptoCurrency/comments/n5tvpv/due_to_a_high_number_of_requests_ive_updated_my/
[8]https://www.reddit.com/r/CryptoCurrency/comments/7m3nvy/ive_created_an_excel_crypto_portfolio_tracker/
[9]https://github.com/buchen/portfolio
[10]https://forum.portfolio-performance.info/t/zur-entwicklung-der-mobilen-app-android-apple-beitragen/13303
[11]https://indexfundinvestor.eu/2019/06/27/how-to-track-your-investments-with-portfolio-performance/
[12]https://localcryptos.com/
[13]https://api.coingecko.com/api/v3/coins/list
[14]https://www.publish0x.com/bitcoin-trading-experiments/tracking-crypto-trades-how-to-import-in-portfolio-performanc-xzydnpd
[15]https://bitcointalksearch.org/topic/m.59003367
Jump to: