Communitygithub.com

SnapTrade Portafolio

Conéctate a cuentas de inversión mediante SnapTrade SDK y genera informes de portafolio (ej. valor total diario). Útil para conectividad bursátil con Webull, E*TRADE, etc., enlaces de portal, registro de cuentas o resúmenes automatizados.

¿Qué es SnapTrade Portafolio?

SnapTrade Portafolio es una habilidad para agentes de IA que proporciona conectividad con corredurías de bolsa a través de la API de SnapTrade. Permite registrar usuarios, conectar cuentas de inversión (como Webull, E*TRADE), consultar el valor total del portafolio, obtener desgloses por correduría con conversión de divisas y ejecutar órdenes de compra/venta (mercado o limitadas) con monitoreo opcional. Soporta programar informes diarios automáticos mediante cron. La habilidad utiliza el SDK oficial de Python `snaptrade_client` con firma de solicitudes automática y se ejecuta mediante scripts en Python dentro del directorio de trabajo. Es compatible con plataformas que pueden ejecutar Python y cron, como Claude Code, Cursor, o Codex en entornos Linux. El flujo de trabajo incluye la creación de una cuenta SnapTrade, configuración de credenciales, registro de usuario para obtener enlaces de portal de conexión, y posteriormente la consulta de datos financieros o ejecución de órdenes. Todas las credenciales sensibles se almacenan de forma segura en un archivo local con permisos restringidos.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace SnapTrade Portafolio?

Descripción general

Conecta cuentas de correduría a través de SnapTrade y genera un informe diario del valor total. Esta habilidad usa el SDK oficial de Python de SnapTrade (snaptrade_client) con firma de solicitudes manejada automáticamente.

Flujo de trabajo

2d) Realizar órdenes de compra/venta (acciones/ETFs)

Ejecuta:

python3 scripts/snaptrade_order.py buy|sell TICKER UNIDADES --account-id <ID_CUENTA> [--order-type market|limit] [--limit-price <PRECIO>] [--tif Day|GTC|IOC|FOK]

Valores por defecto:

  • tipo de orden: market
  • time in force: Day
  • precio límite: solo requerido para órdenes limitadas

Monitoreo opcional (consultar órdenes recientes):

python3 scripts/snaptrade_order.py buy|sell TICKER UNIDADES --account-id <ID_CUENTA> --watch
  • consulta cada 10s hasta 120s por defecto
  • ajusta con --watch-interval y --watch-seconds

Monitorear una orden existente por ID:

python3 scripts/snaptrade_watch_order.py --account-id <ID_CUENTA> --order-id <ID_ORDEN_BROKER>
  • mismos valores por defecto 10s/120s, ajustables con --watch-interval y --watch-seconds

Usa el endpoint de órdenes de la cuenta para confirmar ejecuciones e informar al usuario sobre órdenes abiertas cuando se solicite.

0) Crear una cuenta SnapTrade + claves API

Necesitas una cuenta de SnapTrade para conectar corredurías. Crea una cuenta gratuita en https://snaptrade.com, genera tu ID de cliente y Clave de consumidor, luego agrégalos a la configuración de la habilidad.

1) Instalar dependencias

pip3 install -r requirements.txt

2) Configurar credenciales (una sola vez)

Guarda las credenciales en un archivo de configuración local (sin subir al repositorio). user_id se genera automáticamente en la primera ejecución:

/home/openclaw/.openclaw/workspace/secrets/snaptrade.json

Ejemplo:

{
  "client_id": "TU_CLIENTE_ID",
  "consumer_key": "TU_CLAVE_CONSUMIDOR",
  "user_id": "<uuid-generado-automáticamente>"
}

2) Registrar usuario + generar enlace del portal de conexión

Ejecuta:

python3 scripts/snaptrade_portal.py

Esto:

  • registra el usuario si falta user_secret
  • guarda user_secret de nuevo en el archivo de configuración
  • imprime una URL del portal de conexión que el usuario debe abrir para vincular cuentas

2b) Reconectar una conexión deshabilitada

Ejecuta:

python3 scripts/snaptrade_reconnect.py [nombre-correduría]

Esto:

  • lista las conexiones deshabilitadas
  • genera un enlace de reconexión (opcionalmente coincide por nombre de correduría)
  • imprime una URL de reconexión para que el usuario vuelva a habilitar la conexión

2c) Listar corredurías disponibles (conexiones permitidas)

Ejecuta:

python3 scripts/snaptrade_brokers.py

Esto llama /snaptrade/partners y devuelve la lista allowed_brokerages (nombres para mostrar).

3) Obtener el valor total del portafolio

Ejecuta:

python3 scripts/snaptrade_total.py

La salida es JSON como:

{"total_value": 123456.78, "currency": "CAD"}

3b) Totales por correduría (divisa convertida)

Ejecuta:

python3 scripts/snaptrade_broker_totals.py --currency CAD

La salida JSON incluye totales por correduría en la divisa elegida y los tipos de cambio utilizados.

Notas de implementación: Evita get_user_holdings cuando sea posible. Prefiere get_user_account_positions (endpoint de posiciones) para datos de tenencias/posiciones. Solo usa saldos/efectivo de tenencias si el usuario lo solicita explícitamente; de lo contrario, no llames a holdings.

4) Programar informe diario

Usa cron para llamar a snaptrade_total.py, formatear un mensaje conciso de WhatsApp y luego enviarlo al usuario. Solo se requiere el valor total.

Scripts

  • scripts/snaptrade_common.py — carga/guardado de configuración + creación de cliente
  • scripts/snaptrade_portal.py — registrar usuario + generar enlace del portal de conexión
  • scripts/snaptrade_reconnect.py — generar enlace de reconexión para conexiones deshabilitadas
  • scripts/snaptrade_brokers.py — listar corredurías permitidas para este cliente
  • scripts/snaptrade_order.py — realizar órdenes de compra/venta (mercado/límite) con monitoreo opcional
  • scripts/snaptrade_watch_order.py — monitorear una orden existente por ID para ver ejecuciones
  • scripts/snaptrade_total.py — calcular el valor total en todas las cuentas
  • scripts/snaptrade_broker_totals.py — totales por correduría con conversión de divisas

Notas

  • La firma de solicitudes es manejada por el SDK mediante request_after_hook usando consumer_key.
  • El total se calcula sumando el account.balance.total de cada cuenta desde holdings; esto evita errores cuando se añaden o eliminan cuentas.
  • Si hay múltiples divisas, el script usa la primera divisa encontrada.
  • Guarda los secretos en el archivo de configuración local con permisos 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.

Skills relacionados