¿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-intervaly--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-intervaly--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_secretde 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 clientescripts/snaptrade_portal.py— registrar usuario + generar enlace del portal de conexiónscripts/snaptrade_reconnect.py— generar enlace de reconexión para conexiones deshabilitadasscripts/snaptrade_brokers.py— listar corredurías permitidas para este clientescripts/snaptrade_order.py— realizar órdenes de compra/venta (mercado/límite) con monitoreo opcionalscripts/snaptrade_watch_order.py— monitorear una orden existente por ID para ver ejecucionesscripts/snaptrade_total.py— calcular el valor total en todas las cuentasscripts/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_hookusandoconsumer_key. - El total se calcula sumando el
account.balance.totalde 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.