Monitoramento de Portfólio de Criptomoedas
Visão Geral
Acompanhe suas posições em criptomoedas com valuations em tempo real (CoinGecko), análise de alocação, monitoramento 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 acessar a API do CoinGecko
- Um arquivo JSON de portfólio com suas posiçõ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:
- Verificação rápida: valor total e principais posições
- Lista de posições: detalhamento completo de todas
- Análise detalhada: alocações, lucros/perdas, alertas 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 posições python ${CLAUDE_SKILL_DIR}/scripts/portfolio_tracker.py --portfolio holdings.json --holdings # Análise detalhada com lucros/perdas e alocações python ${CLAUDE_SKILL_DIR}/scripts/portfolio_tracker.py --portfolio holdings.json --detailed -
Exporte os 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 em 24h e 7d
- Explique os percentuais de alocação
- Sinalize riscos de concentração (posições > 25% de alocação por padrão)
Saída
Resumo exibindo valor total, variações em 24h/7d, alocação por ativo e avisos de concentração para posições que excedem o limite:
==============================================================================
RASTREADOR DE PORTFÓLIO CRYPTO Atualizado: 2026-01-14 15:30 # 2026 - timestamp do ano atual
==============================================================================
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%)
Ativos: 8
PRINCIPAIS POSIÇÕ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 grafia 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 monitoramento de portfólio, desde verificações rápidas até análises detalhadas e exportação:
# Verificação básica do portfólio
python ${CLAUDE_SKILL_DIR}/scripts/portfolio_tracker.py --portfolio ~/crypto/holdings.json
# Todas as posiçõ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 linha de comando, 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