Skill de Trading Alpaca
Ejecuta operaciones y gestiona carteras a través de la herramienta de línea de comandos apcacli para la API de Trading de Alpaca.
Instalación
apcacli es una CLI escrita en Rust. Instálala de forma multiplataforma:
macOS (Homebrew)
brew install rustup
rustup-init -y
source "$HOME/.cargo/env"
cargo install apcacli
Linux
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
source "$HOME/.cargo/env"
cargo install apcacli
Windows
- Descarga y ejecuta rustup-init.exe
- Abre una nueva terminal y luego:
cargo install apcacli
Variables de Entorno
export APCA_API_KEY_ID='tu-id-de-clave'
export APCA_API_SECRET_KEY='tu-clave-secreta'
# Para trading real (por defecto es papel):
# export APCA_API_BASE_URL='https://api.alpaca.markets'
Descripción General
Eres un experto en el uso de apcacli para trading de acciones desde la línea de comandos. Tu objetivo es ayudar a los usuarios a negociar acciones, ETFs, opciones y criptomonedas de manera eficiente a través de la API de Alpaca, enfatizando la seguridad y las mejores prácticas.
Cómo Usar Esta Skill
Al ayudar a los usuarios con tareas de trading:
- Seguridad Primero: Siempre recomienda paper trading para nuevos usuarios o al hacer pruebas
- Verificar Comandos: Muestra el comando exacto antes de ejecutar operaciones
- Requisitos Previos: Confirma horarios de mercado, saldo de cuenta y símbolos válidos
- Explicar Tipos de Órdenes: Ayuda a los usuarios a elegir el tipo de orden adecuado para sus necesidades
- Gestión de Riesgos: Sugiere stops de pérdida y dimensionamiento de posiciones
Qué Hace Esta Skill
apcacli es una CLI basada en Rust para interactuar con la plataforma de trading de Alpaca. Proporciona:
- Trading: Enviar, modificar y cancelar órdenes de acciones, ETFs, opciones y criptomonedas
- Gestión de Cartera: Ver posiciones, P/G e información de la cuenta
- Datos de Mercado: Acceder a información de activos y estado del reloj del mercado
- Actividad de la Cuenta: Seguimiento del historial de operaciones y cambios en la cuenta
- Streaming en Tiempo Real: Monitorear eventos de la cuenta y operaciones
Cuándo Usar Esta Skill
Usa esta skill cuando el usuario quiera:
- Ejecutar operaciones (comprar/vender acciones, ETFs, opciones, criptomonedas)
- Consultar posiciones y rendimiento de la cartera
- Ver o gestionar órdenes (abiertas, ejecutadas, canceladas)
- Obtener saldo de cuenta y poder de compra
- Acceder a datos de mercado e información de activos
- Monitorear actividad de la cuenta y eventos
- Verificar si el mercado está abierto
- Configurar stops de pérdida o trailing stops
- Automatizar flujos de trabajo de trading con scripts
Frases de activación comunes:
- "Comprar 10 acciones de AAPL"
- "Mostrar mis posiciones abiertas"
- "¿Cuál es mi saldo de cuenta?"
- "Listar todas mis órdenes"
- "Cancelar orden [ID]"
- "¿Está abierto el mercado?"
- "Mostrar rendimiento de mi cartera"
- "Poner un stop de pérdida en mi posición"
- "Cerrar todas mis posiciones"
Cuándo NO usar esta skill:
- El usuario quiere trading con interfaz gráfica (dirigirlo a la interfaz web)
- El usuario pide asesoría financiera (proporcionas herramientas, no recomendaciones)
- El usuario quiere operar instrumentos no soportados por Alpaca
- El usuario no tiene apcacli instalado (ayúdale a instalarlo primero)
Instalación y Configuración
Instalar apcacli
# Usando Cargo (gestor de paquetes de Rust)
cargo install apcacli
# Verificar instalación
apcacli --help
Requisitos:
- Rust 1.71 o superior
- Cuenta de Alpaca (paper trading o trading real)
- Credenciales de API de Alpaca
Configurar Variables de Entorno
Para Paper Trading (Recomendado para pruebas):
export APCA_API_KEY_ID='tu_id_de_clave_de_papel'
export APCA_API_SECRET_KEY='tu_clave_secreta_de_papel'
# Paper trading es el predeterminado, no es necesario establecer APCA_API_BASE_URL
Para Trading Real:
export APCA_API_BASE_URL='https://api.alpaca.markets'
export APCA_API_KEY_ID='tu_id_de_clave_real'
export APCA_API_SECRET_KEY='tu_clave_secreta_real'
Obtener Credenciales de API:
- Regístrate en https://alpaca.markets/
- Navega a tu panel de control
- Genera claves de API (papel o real)
- Exporta las variables de entorno
Comandos Principales
Información de la Cuenta
Ver detalles de la cuenta:
apcacli account get
Muestra estado de la cuenta, saldo en efectivo, poder de compra, capital e información de margen.
Ver actividad de la cuenta:
apcacli account activity
Muestra la actividad reciente de la cuenta, incluyendo operaciones, dividendos y transferencias.
Actualizar configuración de la cuenta:
apcacli account config <opciones>
Modifica la configuración de la cuenta (usa --help para opciones disponibles).
Gestión de Órdenes
Enviar una orden de mercado:
# Comprar con cantidad en dólares
apcacli order submit buy AAPL --value 1000
# Comprar cantidad específica
apcacli order submit buy AAPL --quantity 10
# Vender acciones
apcacli order submit sell TSLA --quantity 5
Enviar una orden límite:
# Comprar a un precio específico
apcacli order submit buy MSFT --quantity 10 --limit-price 420
# Vender a un precio específico
apcacli order submit sell NVDA --quantity 20 --limit-price 850
Enviar órdenes avanzadas:
# Orden stop
apcacli order submit sell AAPL --quantity 10 --stop-price 180
# Orden stop-límite
apcacli order submit sell TSLA --quantity 5 --stop-price 800 --limit-price 795
# Orden trailing stop (porcentaje)
apcacli order submit sell NVDA --quantity 10 --trail-percent 5
Listar todas las órdenes:
apcacli order list
Muestra todas las órdenes con su estado (abierta, ejecutada, cancelada, etc.).
Obtener detalles de una orden específica:
apcacli order get <ID_ORDEN>
Muestra información completa de la orden, incluyendo marcas de tiempo, precio y estado.
Cancelar una orden:
apcacli order cancel <ID_ORDEN>
Cancela una orden pendiente por su ID.
Cancelar todas las órdenes:
apcacli order cancel-all
Cancela todas las órdenes abiertas.
Gestión de Posiciones
Listar todas las posiciones abiertas:
apcacli position list
Muestra todas las posiciones abiertas con:
- Cantidad y precio de entrada
- Valor de mercado actual
- P/G diario (con porcentaje)
- P/G total (con porcentaje)
- Ganancia/pérdida codificada por colores
Obtener una posición específica:
apcacli position get <SÍMBOLO>
Muestra información detallada de una posición específica.
Cerrar una posición:
# Cerrar posición completa
apcacli position close <SÍMBOLO>
# Cerrar posición parcial
apcacli position close <SÍMBOLO> --quantity 5
Cerrar todas las posiciones:
apcacli position close-all
Cierra todas las posiciones abiertas.
Información de Activos
Listar activos disponibles:
apcacli asset list
Muestra todos los activos negociables.
Obtener detalles de un activo:
apcacli asset get <SÍMBOLO>
Muestra información del activo, incluyendo bolsa, clase y estado de negociabilidad.
Buscar activos:
apcacli asset search <CONSULTA>
Busca activos que coincidan con la consulta.
Datos de Mercado
Consultar reloj del mercado:
apcacli market clock
Muestra el estado actual del mercado (abierto/cerrado), próxima hora de apertura y próxima hora de cierre.
Streaming (Eventos en Tiempo Real)
Stream de actualizaciones de cuenta:
apcacli stream account
Monitorea eventos de la cuenta en tiempo real, incluyendo actualizaciones de órdenes y ejecuciones.
Stream de actualizaciones de operaciones:
apcacli stream trades
Monitorea eventos de operaciones en tiempo real para tus posiciones.
Mejores Prácticas
Seguridad y Gestión de Riesgos
- Empieza con Paper Trading - Siempre prueba estrategias primero con paper trading
- Usa Órdenes Límite - Evita órdenes de mercado en condiciones volátiles para un mejor control de precios
- Verifica Símbolos - Revisa dos veces los símbolos de las acciones antes de ejecutar operaciones
- Revisa Antes de Ejecutar - Usa
apcacli order getpara verificar los detalles de la orden - Configura Stops de Pérdida - Protege posiciones con órdenes stop
- Consulta el Saldo de la Cuenta - Asegura suficiente poder de compra antes de operar
- Monitorea Posiciones - Revisa regularmente el P/G con
apcacli position list
Uso Efectivo
- Consulta la ayuda de cualquier comando - Usa
apcacli <comando> --helppara opciones detalladas - Guarda los IDs de órdenes - Almacena los IDs de órdenes devueltos para rastrear y gestionar órdenes después
- Usa variables de entorno - Mantén las credenciales seguras en variables de entorno, nunca las codifiques
- Verifica horarios de mercado - Consulta
apcacli market clockantes de colocar órdenes - Revisa la actividad regularmente - Monitorea la actividad de la cuenta para cambios inesperados
Flujos de Trabajo Comunes
Compra simple de acciones:
# 1. Consultar saldo de cuenta
apcacli account get
# 2. Verificar que el activo sea negociable
apcacli asset get AAPL
# 3. Verificar que el mercado esté abierto
apcacli market clock
# 4. Enviar orden de mercado
apcacli order submit buy AAPL --value 1000
# 5. Verificar posición
apcacli position list
Orden límite con monitoreo:
# 1. Enviar orden límite
apcacli order submit buy MSFT --quantity 10 --limit-price 420
# 2. Guardar el ID_ORDEN devuelto
# 3. Consultar estado de la orden
apcacli order get <ID_ORDEN>
# 4. Si es necesario, cancelar
apcacli order cancel <ID_ORDEN>
Revisión de cartera:
# 1. Ver todas las posiciones
apcacli position list
# 2. Consultar resumen de cuenta
apcacli account get
# 3. Revisar actividad reciente
apcacli account activity
Cerrar posición con stop de pérdida:
# 1. Consultar posición actual
apcacli position get AAPL
# 2. Configurar trailing stop para proteger ganancias
apcacli order submit sell AAPL --quantity 10 --trail-percent 5
# 3. Monitorear la orden
apcacli order list
Guía Rápida de Referencia de Comandos
| Tarea | Comando |
|---|---|
| Ver cuenta | apcacli account get |
| Actividad de cuenta | apcacli account activity |
| Comprar acción (mercado) | apcacli order submit buy SÍMBOLO --value CANTIDAD |
| Comprar acción (límite) | apcacli order submit buy SÍMBOLO --quantity N --limit-price PRECIO |
| Vender acción | apcacli order submit sell SÍMBOLO --quantity N |
| Listar todas las órdenes | apcacli order list |
| Obtener detalles de orden | apcacli order get ID_ORDEN |
| Cancelar orden | apcacli order cancel ID_ORDEN |
| Cancelar todas las órdenes | apcacli order cancel-all |
| Listar posiciones | apcacli position list |
| Obtener posición | apcacli position get SÍMBOLO |
| Cerrar posición | apcacli position close SÍMBOLO |
| Cerrar todas las posiciones | apcacli position close-all |
| Listar activos | apcacli asset list |
| Obtener info de activo | apcacli asset get SÍMBOLO |
| Consultar estado del mercado | apcacli market clock |
| Stream de eventos de cuenta | apcacli stream account |
| Stream de operaciones | apcacli stream trades |
Tipos de Órdenes y Parámetros
Parámetros Básicos de Órdenes
--quantity N- Número de acciones a negociar--value CANTIDAD- Cantidad en dólares a invertir (para órdenes de mercado)--limit-price PRECIO- Precio límite para órdenes límite--stop-price PRECIO- Precio stop para órdenes stop--trail-percent N- Porcentaje de trailing stop--trail-amount CANTIDAD- Cantidad en dólares de trailing stop
Tipos de Órdenes
Orden de Mercado - Se ejecuta inmediatamente al precio actual del mercado
apcacli order submit buy AAPL --quantity 10
Orden Límite - Se ejecuta solo al precio especificado o mejor
apcacli order submit buy AAPL --quantity 10 --limit-price 185
Orden Stop - Se convierte en orden de mercado cuando se alcanza el precio stop
apcacli order submit sell AAPL --quantity 10 --stop-price 180
Orden Stop-Límite - Se convierte en orden límite cuando se alcanza el precio stop
apcacli order submit sell AAPL --quantity 10 --stop-price 180 --limit-price 179
Trailing Stop - El precio stop sigue al mercado según un porcentaje o cantidad especificados
# Basado en porcentaje
apcacli order submit sell AAPL --quantity 10 --trail-percent 5
# Basado en dólares
apcacli order submit sell AAPL --quantity 10 --trail-amount 10
Notas Importantes
Requisitos
- El binario apcacli debe estar instalado - Instálalo con
cargo install apcacli - Las variables de entorno deben estar configuradas - Se requieren
APCA_API_KEY_IDyAPCA_API_SECRET_KEY - Cuenta de Alpaca - Cuenta activa de paper trading o trading real
- Rust 1.71+ - Requerido para instalación desde código fuente
Limitaciones de Trading
- Papel vs Real: Por defecto es paper trading; establece
APCA_API_BASE_URLpara trading real - Horarios de mercado: La mayoría de las operaciones solo se ejecutan en horario de mercado (9:30 AM - 4:00 PM ET)
- Pattern Day Trading (PDT): Cuentas con menos de $25k tienen restricciones PDT
- Poder de compra: Limitado por el capital de la cuenta y requisitos de margen
- Restricciones de órdenes: Algunos tipos de órdenes pueden no estar disponibles para todos los valores
- Trading de criptomonedas: Puede tener reglas y horarios de negociación diferentes
Datos y Rendimiento
- Límites de velocidad de API: Alpaca tiene límites de solicitudes para prevenir abusos
- Datos en tiempo real: Puede requerir una suscripción activa de datos
- Salida de comandos: Resultados formateados con codificación de colores para fácil lectura
- IDs de órdenes: Guarda los IDs de órdenes devueltos para seguimiento y gestión
- Dependencia de red: Requiere conexión a internet para la API de Alpaca
Solución de Problemas
Variables de Entorno No Configuradas
# Error: "Missing APCA_API_KEY_ID"
# Solución: Exportar las variables de entorno requeridas
export APCA_API_KEY_ID='tu_clave'
export APCA_API_SECRET_KEY='tu_secreto'
Comando No Encontrado
# Error: "apcacli: command not found"
# Solución: Instalar apcacli
cargo install apcacli
# Verificar instalación
which apcacli
Autenticación de API Fallida
- Verifica que las credenciales de API sean correctas
- Revisa si estás usando el endpoint correcto (papel vs real)
- Asegúrate de que las claves de API no hayan sido revocadas
- Confirma que el estado de la cuenta esté activo
Orden Rechazada
- Verifica que el mercado esté abierto (para acciones)
- Revisa suficiente poder de compra
- Confirma que el símbolo sea válido y negociable
- Revisa los parámetros de la orden (precio, cantidad)
- Verifica restricciones de la cuenta
Posición No Encontrada
- Verifica que el símbolo sea correcto
- Asegúrate de que la posición esté realmente abierta
- Revisa si la posición fue cerrada anteriormente
- Confirma que estás usando la cuenta correcta (papel vs real)
Funciones Avanzadas
Completado de Shell
Genera completado de shell para una entrada de comandos más rápida:
# Instalar script de completado
cargo run --bin=shell-complete > apcacli.bash
source apcacli.bash
# Ahora puedes usar autocompletado con TAB
apcacli order <TAB>
Streaming para Monitoreo
Usa comandos de streaming para monitorear la actividad de la cuenta en tiempo real:
# Terminal 1: Monitorear eventos de cuenta
apcacli stream account
# Terminal 2: Ejecutar operaciones
apcacli order submit buy AAPL
…
[truncado para traducción]