Portfólio SnapTrade
Visão Geral
Conecte contas de corretagem através do SnapTrade e gere um relatório diário de valor total. Esta habilidade usa o SDK oficial do SnapTrade Python (snaptrade_client) com assinatura de requisição tratada automaticamente.
Fluxo de Trabalho
2d) Colocar ordens de compra/venda (ações/ETFs)
Execute:
python3 scripts/snaptrade_order.py buy|sell TICKER UNIDADES --account-id <ID_DA_CONTA> [--order-type market|limit] [--limit-price <PREÇO>] [--tif Day|GTC|IOC|FOK]
Padrões:
- tipo de ordem: market
- time in force: Day
- preço limite: obrigatório apenas para ordens limitadas
Monitoramento opcional (consultar ordens recentes):
python3 scripts/snaptrade_order.py buy|sell TICKER UNIDADES --account-id <ID_DA_CONTA> --watch
- consulta a cada 10s por até 120s por padrão
- ajuste com
--watch-intervale--watch-seconds
Monitorar uma ordem existente por ID:
python3 scripts/snaptrade_watch_order.py --account-id <ID_DA_CONTA> --order-id <ID_DA_ORDEM_DA_CORRETORA>
- mesmos padrões de 10s/120s, ajustáveis com
--watch-intervale--watch-seconds
Use o endpoint de ordens da conta para confirmar execuções e relatar ordens abertas ao usuário quando solicitado.
0) Criar uma conta SnapTrade + chaves de API
Você precisa de uma conta SnapTrade para conectar corretoras. Crie uma conta gratuita em https://snaptrade.com, gere seu Client ID e Consumer Key, e adicione-os à configuração da habilidade.
1) Instalar dependências
pip3 install -r requirements.txt
2) Configurar credenciais (uma vez)
Armazene as credenciais em um arquivo de configuração local (não versionado). user_id é gerado automaticamente na primeira execução:
/home/openclaw/.openclaw/workspace/secrets/snaptrade.json
Exemplo:
{
"client_id": "SEU_CLIENT_ID",
"consumer_key": "SUA_CONSUMER_KEY",
"user_id": "<uuid-gerado-automaticamente>"
}
2) Registrar usuário + gerar link do portal de conexão
Execute:
python3 scripts/snaptrade_portal.py
Isso irá:
- registrar o usuário se
user_secretestiver faltando - armazenar
user_secretde volta no arquivo de configuração - imprimir uma URL do portal de conexão que o usuário deve abrir para vincular contas
2b) Reconectar uma conexão desabilitada
Execute:
python3 scripts/snaptrade_reconnect.py [nome-da-corretora]
Isso irá:
- listar conexões desabilitadas
- gerar um link de reconexão (opcionalmente, filtrar por nome da corretora)
- imprimir uma URL de reconexão para o usuário reabilitar a conexão
2c) Listar corretoras disponíveis (conexões permitidas)
Execute:
python3 scripts/snaptrade_brokers.py
Isso chama /snaptrade/partners e retorna a lista allowed_brokerages (nomes de exibição).
3) Obter valor total do portfólio
Execute:
python3 scripts/snaptrade_total.py
A saída é JSON como:
{"total_value": 123456.78, "currency": "CAD"}
3b) Totais por corretora (moeda convertida)
Execute:
python3 scripts/snaptrade_broker_totals.py --currency BRL
O JSON de saída inclui os totais por corretora na moeda escolhida e as taxas de câmbio utilizadas.
Notas de implementação: Evite get_user_holdings quando possível. Prefira get_user_account_positions (endpoint de posições) para dados de posições/participações. Use saldos/caixa de participações apenas se explicitamente solicitado pelo usuário; caso contrário, não chame participações.
4) Agendar relatório diário
Use cron para chamar snaptrade_total.py, formatar uma mensagem concisa do WhatsApp e enviá-la ao usuário. Apenas o valor total é necessário.
Scripts
scripts/snaptrade_common.py— carregar/salvar configuração + criação de clientescripts/snaptrade_portal.py— registrar usuário + gerar link do portal de conexãoscripts/snaptrade_reconnect.py— gerar link de reconexão para conexões desabilitadasscripts/snaptrade_brokers.py— listar corretoras permitidas para este clientescripts/snaptrade_order.py— colocar ordens de compra/venda (market/limit) com monitoramento opcionalscripts/snaptrade_watch_order.py— monitorar uma ordem existente por ID para execuçõesscripts/snaptrade_total.py— calcular valor total em todas as contasscripts/snaptrade_broker_totals.py— totais por corretora com conversão de moeda
Notas
- A assinatura de requisição é tratada pelo SDK via
request_after_hookusandoconsumer_key. - O total é calculado somando o
account.balance.totalde cada conta a partir de participações; isso evita erros quando contas são adicionadas ou removidas. - Se houver múltiplas moedas, o script usa a primeira moeda encontrada.
- Mantenha os segredos no arquivo de configuração local com permissões
chmod 600.