Communitygithub.com

baneeishaque/ljt-520_openclaw-backup

Conecta-se às contas de investimento do usuário via SnapTrade SDK e gera relatórios de portfólio (ex.: valor total diário). Use quando o usuário precisar de conectividade com corretoras via SnapTrade (Webull, E*TRADE, etc.), links de portal de conexão, registro de conta ou resumos automatizados de portfólio.

O que é ljt-520_openclaw-backup?

Esta habilidade permite que um agente de IA se conecte a contas de corretagem de investimento de um usuário por meio da API SnapTrade e gere relatórios automatizados de portfólio, como o valor total diário. Ela é particularmente útil para desenvolvedores e usuários de ferramentas como Claude Code, Cursor ou Codex que desejam integrar dados financeiros de corretoras como Webull e E*TRADE. A habilidade utiliza o SDK oficial do SnapTrade em Python, que lida automaticamente com a assinatura de requisições, simplificando a autenticação. O fluxo de trabalho inclui desde a criação de uma conta SnapTrade e registro de usuário até a execução de ordens de compra/venda, listagem de corretoras disponíveis, obtenção de valores totais de portfólio e agendamento de relatórios diários. Scripts auxiliares gerenciam a reconexão de conexões desabilitadas e fornecem totais por corretora com conversão de moeda. A habilidade é suportada por uma série de scripts em Python que podem ser executados diretamente no terminal, e as credenciais são armazenadas de forma segura em um arquivo de configuração local.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/baneeishaque/ljt-520_openclaw-backup/tree/HEAD/skills/brendanwood/portfolio-trader

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

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-interval e --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-interval e --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_secret estiver faltando
  • armazenar user_secret de 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 cliente
  • scripts/snaptrade_portal.py — registrar usuário + gerar link do portal de conexão
  • scripts/snaptrade_reconnect.py — gerar link de reconexão para conexões desabilitadas
  • scripts/snaptrade_brokers.py — listar corretoras permitidas para este cliente
  • scripts/snaptrade_order.py — colocar ordens de compra/venda (market/limit) com monitoramento opcional
  • scripts/snaptrade_watch_order.py — monitorar uma ordem existente por ID para execuções
  • scripts/snaptrade_total.py — calcular valor total em todas as contas
  • scripts/snaptrade_broker_totals.py — totais por corretora com conversão de moeda

Notas

  • A assinatura de requisição é tratada pelo SDK via request_after_hook usando consumer_key.
  • O total é calculado somando o account.balance.total de 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.

Individual skills in this repo

This repo contains 13 individual skills — each has its own dedicated page.

baneeishaque/ljt-520_openclaw-backup

Complete investment portfolio risk management system. Analyze positions, calculate risk metrics, stress test scenarios, optimize allocations, and generate institutional-grade risk reports — all without external APIs.

baneeishaque/ljt-520_openclaw-backup

Balance tracking, order overview, and market data across exchanges using OpenMM.

baneeishaque/ljt-520_openclaw-backup

Balance tracking, order overview, and market data across exchanges using OpenMM.

baneeishaque/ljt-520_openclaw-backup

An investment portfolio tracker that runs entirely locally. All data stays in ~/.portfolio-tracker/.

baneeishaque/ljt-520_openclaw-backup

Discover and register autonomous AI agents. Use when: browsing the agent registry, submitting an agent for verification, or embedding agent badges. NOT for: general web search or agent capability analysis.

baneeishaque/ljt-520_openclaw-backup

Query land ownership, leases, landlord info, and land payments. Write operations for payment management and lease renewals.

baneeishaque/ljt-520_openclaw-backup

Build high-converting landing pages and product sales pages using proven 10-section conversion frameworks. Includes Hero → Social Proof → Benefits → CTA flow for both lead capture and e-commerce pages.

baneeishaque/ljt-520_openclaw-backup

Generate complete, responsive HTML landing pages from a product name, tagline, and description. Clean CSS, mobile-ready, with hero, features, CTA, and footer sections.

baneeishaque/ljt-520_openclaw-backup

Optimize conversion pages for paid traffic from Meta (Facebook/Instagram), Google Ads, TikTok Ads, YouTube Ads, Amazon Ads, and Shopify Ads journeys.

baneeishaque/ljt-520_openclaw-backup

Perform a structured conversion rate optimization (CRO) audit of a landing page. Use when a user shares a landing page URL, pastes their page copy, describes their page content, or uploads a screenshot and asks for a conversion audit, CRO review, conversion analysis, landing page feedback, or wants to know why their page isn't converting. Produces a scored 8-factor audit (0–80 total), prioritized fix list with quick wins and strategic recommendations, and an executive summary. Covers: headline clarity, supporting copy, social proof, CTA effectiveness, visual hierarchy, trust signals, mobile/speed signals, and offer clarity.

baneeishaque/ljt-520_openclaw-backup

Generate landing page content from PRD — hero section, features, A/B headline variants, CTA, and SEO meta tags. Use when user says "create landing page", "write landing copy", "hero section", "A/B headlines", or "landing content". Can scaffold actual pages for astro-static. Do NOT use for SEO auditing (use /seo-audit).

baneeishaque/ljt-520_openclaw-backup

Build high-converting landing pages with proven structure, persuasive copy, and conversion optimization.

baneeishaque/ljt-520_openclaw-backup

Track a crypto portfolio across Binance, Hyperliquid, and Polymarket. Calculates NAV, unrealized P&L, daily drawdown, win rate, and equity curve. Use when you need portfolio tracking, NAV calculation, drawdown monitoring, or multi-venue position management.

Habilidades Relacionadas