Introducción a Alpaca

El módulo internacional de Voultech permite a tus clientes operar acciones en mercados de EE.UU. a través de Alpaca Markets, manteniendo la cuenta local en Voultech como punto de control.

💡
Todas las consultas usan numCuenta (cuenta local en Vector). El accountNumber asignado por Alpaca aparece en respuestas con fines regulatorios e informativos únicamente.

Qué cubre el módulo

Cuentas internacionales

Crear, consultar y gestionar cuentas Alpaca asociadas a cuentas locales.

Assets e instrumentos

Buscar instrumentos, cotizaciones, market data y horario de mercado.

Órdenes internacionales

Enviar órdenes de compra/venta usando codBolsa = ALPACA.

Actividad y custodias

Consultar movimientos históricos y posiciones vigentes.

Movimientos internacionales

Registrar aportes y retiros patrimoniales entre cuenta local y Alpaca.

Flujo de integración recomendado

1. Crear cuenta Alpaca       → POST /CuentaAlpaca/CrearClienteAlpaca
2. Aportar fondos            → POST /MovimientosAlpaca/MovimientoInternacionalAlpaca (RET_PAT_IT)
3. Buscar instrumentos       → GET  /Asset?search=...
4. Consultar cotización      → GET  /Asset/LastQuote?nemo=AAPL
5. Enviar orden              → POST /Ordenes/IngresarOrdenesMercado (codBolsa: ALPACA)
6. Consultar custodias       → GET  /CuentaAlpaca/Custodias/{numCuenta}
7. Revisar saldo             → GET  /CuentaAlpaca/SaldoAlpaca/{numCuenta}

Conceptos clave

Identificadores

Campo	Descripción
`numCuenta`	Cuenta local Voultech (formato `{RUT}/{secuencia}`, ej: `19130340/0`) — se usa en todas las consultas
`accountNumber`	Número asignado por Alpaca — solo informativo/regulatorio, no se usa en llamadas a la API
`identificador`	RUT del cliente con dígito verificador (ej: `12345678-9`)

Bolsas y horario

Mercado americano abierto de lunes a viernes 14:30–21:00 UTC (ajustado por DST)
Consulta el estado en tiempo real con GET /ClockAlpaca
Las órdenes ingresadas con mercado cerrado quedan pendientes hasta la apertura

⚠️
Las confirmaciones de ejecución de órdenes y movimientos llegan de forma asíncrona vía Service Bus, no en la respuesta HTTP del POST.

Tipo de orden por bolsa

Campo	Nacional (XSGO)	Internacional (ALPACA)
`codBolsa`	`XSGO`	`ALPACA`
`tipoSeguridad`	varía	`CS` (common stock)
`tipoLiquidacion`	varía	`T2`

Próximos pasos

Comienza con Cuentas Internacionales para crear tu primera cuenta Alpaca
Revisa Assets e Instrumentos para encontrar tickers disponibles
Continúa con Órdenes Internacionales para enviar tu primera orden