Communitygithub.com

lacymorrow/openclaw-alpaca-trading-skill

Ejecuta operaciones, analiza mercados y gestiona carteras usando la herramienta de línea de comandos apcacli para la API de Trading de Alpaca. Úsalo cuando el usuario quiera negociar acciones, ETFs, opciones, cripto, consultar datos de mercado, ver posiciones, gestionar órdenes o analizar su cartera. También cuando mencionen "comprar", "vender", "operar", "datos de mercado", "precio de acción", "cartera", "saldo de cuenta" o "trading alpaca".

¿Qué es openclaw-alpaca-trading-skill?

Esta skill transforma tu agente de IA en un poderoso asistente de trading bursátil a través de la interfaz de línea de comandos `apcacli` para la API de Trading de Alpaca. Permite ejecutar operaciones de compra y venta de acciones, ETFs, opciones y criptomonedas, gestionar carteras, consultar datos de mercado en tiempo real, administrar órdenes (límite, stop, trailing stop) y supervisar la actividad de la cuenta. Es ideal para desarrolladores y traders algorítmicos que prefieren la eficiencia del terminal sobre interfaces gráficas. La skill prioriza la seguridad con paper trading por defecto, explicación de cada comando antes de ejecutar, verificación de horarios de mercado y saldo disponible, y fomenta el uso de órdenes límite y stops de pérdida para gestionar el riesgo. Funciona en macOS, Linux y Windows, y requiere una cuenta en Alpaca con las credenciales de API configuradas como variables de entorno. Además, proporciona una guía completa de comandos, flujos de trabajo comunes y una sección de resolución de problemas para facilitar su adopción.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add lacymorrow/openclaw-alpaca-trading-skill

Preguntar en tu IA favorita

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

Documentación

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

  1. Descarga y ejecuta rustup-init.exe
  2. 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:

  1. Seguridad Primero: Siempre recomienda paper trading para nuevos usuarios o al hacer pruebas
  2. Verificar Comandos: Muestra el comando exacto antes de ejecutar operaciones
  3. Requisitos Previos: Confirma horarios de mercado, saldo de cuenta y símbolos válidos
  4. Explicar Tipos de Órdenes: Ayuda a los usuarios a elegir el tipo de orden adecuado para sus necesidades
  5. 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:

  1. Regístrate en https://alpaca.markets/
  2. Navega a tu panel de control
  3. Genera claves de API (papel o real)
  4. 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

  1. Empieza con Paper Trading - Siempre prueba estrategias primero con paper trading
  2. Usa Órdenes Límite - Evita órdenes de mercado en condiciones volátiles para un mejor control de precios
  3. Verifica Símbolos - Revisa dos veces los símbolos de las acciones antes de ejecutar operaciones
  4. Revisa Antes de Ejecutar - Usa apcacli order get para verificar los detalles de la orden
  5. Configura Stops de Pérdida - Protege posiciones con órdenes stop
  6. Consulta el Saldo de la Cuenta - Asegura suficiente poder de compra antes de operar
  7. Monitorea Posiciones - Revisa regularmente el P/G con apcacli position list

Uso Efectivo

  1. Consulta la ayuda de cualquier comando - Usa apcacli <comando> --help para opciones detalladas
  2. Guarda los IDs de órdenes - Almacena los IDs de órdenes devueltos para rastrear y gestionar órdenes después
  3. Usa variables de entorno - Mantén las credenciales seguras en variables de entorno, nunca las codifiques
  4. Verifica horarios de mercado - Consulta apcacli market clock antes de colocar órdenes
  5. 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

TareaComando
Ver cuentaapcacli account get
Actividad de cuentaapcacli 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ónapcacli order submit sell SÍMBOLO --quantity N
Listar todas las órdenesapcacli order list
Obtener detalles de ordenapcacli order get ID_ORDEN
Cancelar ordenapcacli order cancel ID_ORDEN
Cancelar todas las órdenesapcacli order cancel-all
Listar posicionesapcacli position list
Obtener posiciónapcacli position get SÍMBOLO
Cerrar posiciónapcacli position close SÍMBOLO
Cerrar todas las posicionesapcacli position close-all
Listar activosapcacli asset list
Obtener info de activoapcacli asset get SÍMBOLO
Consultar estado del mercadoapcacli market clock
Stream de eventos de cuentaapcacli stream account
Stream de operacionesapcacli 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_ID y APCA_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_URL para 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]

Skills relacionados