Rastreamento de Portfólio de Criptomoedas
Visão Geral
Acompanhe suas participações em criptomoedas com avaliações em tempo real da CoinGecko, análise de alocação, rastreamento de lucros/perdas e alertas de risco de concentração.
Pré-requisitos
- Python 3.8+ instalado
- Dependências:
pip install requests - Conectividade com a internet para acesso à API CoinGecko
- Um arquivo JSON de portfólio com suas participações (veja
references/implementation.mdpara o formato)
Instruções
-
Avalie a intenção do usuário - determine qual visão do portfólio é necessária:
- Consulta rápida: valor total e principais participações
- Lista de participações: detalhamento completo de todas as posições
- Análise detalhada: alocações, P&L, sinalizadores de risco
- Exportação: JSON ou CSV para ferramentas externas
-
Execute o rastreador de portfólio com as opções apropriadas:
# Resumo rápido do portfólio python ${CLAUDE_SKILL_DIR}/scripts/portfolio_tracker.py --portfolio holdings.json # Detalhamento completo das participações python ${CLAUDE_SKILL_DIR}/scripts/portfolio_tracker.py --portfolio holdings.json --holdings # Análise detalhada com P&L e alocações python ${CLAUDE_SKILL_DIR}/scripts/portfolio_tracker.py --portfolio holdings.json --detailed -
Exporte resultados para ferramentas de análise ou relatórios fiscais:
python ${CLAUDE_SKILL_DIR}/scripts/portfolio_tracker.py --portfolio holdings.json --format json --output portfolio_export.json python ${CLAUDE_SKILL_DIR}/scripts/portfolio_tracker.py --portfolio holdings.json --format csv --output portfolio.csv -
Apresente os resultados ao usuário:
- Mostre o valor total do portfólio em destaque
- Destaque as variações de 24h e 7d
- Explique os percentuais de alocação
- Sinalize quaisquer riscos de concentração (posições > 25% de alocação por padrão)
Saída
Resumo mostrando valor total, variações de 24h/7d, alocação por ativo e avisos de concentração para posições que excedem o limite:
==============================================================================
RASTREADOR DE PORTFÓLIO DE CRIPTOMOEDAS Atualizado: 2026-01-14 15:30
==============================================================================
RESUMO DO PORTFÓLIO: Meu Portfólio
------------------------------------------------------------------------------
Valor Total: $125.450,00 USD
Variação 24h: +$2.540,50 (+2,07%)
Variação 7d: +$8.125,00 (+6,92%)
Participações: 8 ativos
PRINCIPAIS PARTICIPAÇÕES
------------------------------------------------------------------------------
Moeda Quantidade Preço Valor Aloc. 24h
BTC 0,500 $95.000,00 $47.500,00 37,9% +2,5%
ETH 10,000 $3.200,00 $32.000,00 25,5% +1,8%
SOL 100,000 $180,00 $18.000,00 14,4% +4,2%
AVISO: BTC (37,9%) excede o limite de 25%
==============================================================================
Tratamento de Erros
| Erro | Causa | Solução |
|---|---|---|
| Arquivo de portfólio não encontrado | Caminho inválido | Verifique se o caminho do arquivo existe |
| JSON inválido | Arquivo mal formatado | Valide a sintaxe JSON |
| Moeda não encontrada | Símbolo desconhecido | Verifique a ortografia do símbolo, use símbolos padrão |
| Limite de taxa da API | Muitas requisições | Aguarde e tente novamente, use cache |
Consulte ${CLAUDE_SKILL_DIR}/references/errors.md para tratamento abrangente de erros.
Exemplos
Fluxos de trabalho de rastreamento de portfólio, desde consultas rápidas até análise detalhada e exportação:
# Verificação básica do portfólio
python ${CLAUDE_SKILL_DIR}/scripts/portfolio_tracker.py --portfolio ~/crypto/holdings.json
# Todas as participações ordenadas por alocação
python ${CLAUDE_SKILL_DIR}/scripts/portfolio_tracker.py --portfolio holdings.json --holdings --sort allocation
# Análise detalhada com limite personalizado de 15%
python ${CLAUDE_SKILL_DIR}/scripts/portfolio_tracker.py --portfolio holdings.json --detailed --threshold 15
# Exportação para software fiscal
python ${CLAUDE_SKILL_DIR}/scripts/portfolio_tracker.py --portfolio holdings.json --format csv --output tax_export.csv
Recursos
${CLAUDE_SKILL_DIR}/references/implementation.md- Formato do arquivo de portfólio, opções de CLI, limites de alocação, formato JSON${CLAUDE_SKILL_DIR}/references/errors.md- Tratamento abrangente de erros${CLAUDE_SKILL_DIR}/references/examples.md- Exemplos detalhados de uso- API CoinGecko: https://www.coingecko.com/en/api
${CLAUDE_SKILL_DIR}/config/settings.yaml- Opções de configuração