Introducción a Alpaca

Opera cuentas internacionales con Alpaca: crea cuentas, consulta saldos y custodias, busca instrumentos y registra órdenes y movimientos en USD.

Qué puedes hacer con este módulo

Crear una cuenta Alpaca asociada a una cuenta local existente
Consultar cuentas y saldos internacionales del asesor autenticado
Buscar instrumentos disponibles para operar en mercados internacionales
Ingresar órdenes de compra o venta usando CodBolsa = "ALPACA"
Consultar actividad, órdenes y custodias de una cuenta Alpaca
Registrar movimientos internacionales de aporte o retiro patrimonial

Antes de empezar

Para usar el módulo internacional necesitas:

Una cuenta local existente en GPI (numCuenta)
El identificador del cliente (identificador)
Un usuario autenticado con acceso al asesor correspondiente

💡
La creación de cuenta internacional se realiza sobre una cuenta local existente. En los endpoints de Alpaca verás tanto el numCuenta local como el accountNumber de Alpaca.

Flujo recomendado

Sigue este orden para implementar el módulo internacional:

Crear la cuenta Alpaca con POST /api/publicapi/creasys/CuentaAlpaca/CrearClienteAlpaca
Consultar la cuenta creada con GET /api/publicapi/creasys/CuentaAlpaca/ObtenerCuentaAlpaca/{accountNumber}
Revisar saldo disponible con GET /api/publicapi/creasys/CuentaAlpaca/SaldoAlpaca/{accountNumber}
Buscar instrumentos con GET /api/publicapi/creasys/Asset
Ingresar órdenes internacionales con POST /api/publicapi/creasys/Ordenes/IngresarOrdenesMercado usando CodBolsa = "ALPACA"
Consultar actividad, custodias y órdenes de la cuenta
Registrar movimientos internacionales con POST /api/publicapi/creasys/MovimientosAlpaca/MovimientoInternacionalAlpaca

Endpoints principales

Cuentas Internacionales

Crea cuentas Alpaca, consulta su estado, lista las cuentas del asesor y revisa saldos.

Assets e Instrumentos

Busca instrumentos por símbolo, nombre o bolsa para preparar órdenes internacionales.

Órdenes Internacionales

Ingresa órdenes con CodBolsa = "ALPACA" y consulta el historial de órdenes por cuenta.

Actividad y Custodias

Consulta movimientos de actividad, posiciones abiertas y valorización actual de la cuenta.

Movimientos Internacionales

Registra aportes y retiros patrimoniales internacionales con APO_PAT_IT y RET_PAT_IT.

Consideraciones operativas

Las cuentas Alpaca operan en USD
Las órdenes internacionales usan CodBolsa = "ALPACA"
Para órdenes internacionales, se documenta el uso de TipoSeguridad = "CS" y TipoLiquidacion = "T2"
Los movimientos internacionales soportados son APO_PAT_IT y RET_PAT_IT

📘
Usa esta sección junto con la API Reference para validar parámetros, responses y ejemplos por endpoint.

Siguiente paso

Empieza por la página Cuentas Internacionales para crear la primera cuenta Alpaca y validar su estado.