Glosario

Términos y campos que aparecen a lo largo de la API.

Conceptos generales

Optimus — Plataforma de intermediación de MBI que expone la mayoría de los servicios (clientes, cuentas, custodia, órdenes, instrumentos).

FX Spot — Servicios de cambio de divisas al contado, bajo rutas /v1/.

Socio de negocio — Entidad (persona natural o jurídica) registrada en la plataforma. Un cliente es un socio de negocio habilitado para operar.

Portafolio — Contenedor de la operación de un cliente. Un cliente puede tener varios, con propósitos distintos (intermediación, APV, administración de cartera).

Matriz agrupadora — Agrupación de portafolios que define plan y producto asociado.

Custodia — Instrumentos que un cliente mantiene depositados; sus posiciones.

Campos de autenticación

IdEmpresa — Identificador numérico de la empresa que se conecta.

IdUsuario / ClaveUsuario — Credenciales del usuario que se repiten en el cuerpo de los servicios Optimus.

X-SESSION-TOKEN — Cabecera con el token de sesión obtenido de Session/obtenerToken.

x-api-key / x-api-secret — Par de llaves de autenticación de los servicios FX Spot.

Campos comunes de consulta

IdInterno — Correlativo que identifica cada grupo de filtros o cada ítem, y que en la respuesta permite asociar cada resultado con su entrada.

Filtro / Valor — Patrón de consulta: Filtro nombra el campo y Valor su valor; varios se combinan separándolos con ;.

DocumentoIdentidad — Documento de identidad del cliente (RUT o pasaporte).

EsADC — Indicador (S/N) de si corresponde a administración de cartera.

Códigos frecuentes

Tipo de persona — N (natural), J (jurídica).

Tipo de documento — R (RUT), P (pasaporte).

Operación (renta variable) — C (compra), V (venta).

Side (FX) — buy (compra), sell (venta).

Tipo de precio — L (límite), M (mercado).

Condición de liquidación — T0 a T7 (según plazo), OT, TP.

Tipo de vigencia — SH (solo hoy), FF (fecha fija), SE (semanal), OP (permanente).

Estado — ACT (activo), INA (inactivo), BLO (bloqueado), VIG (vigente), entre otros.

Muchos campos aceptan códigos del sistema (país, comuna, banco, bolsa, categoría de inversionista). Cuando un valor espera un código y su lista es extensa, la referencia del endpoint lo indica y, en varios casos, remite al servicio de datos generales de la plataforma para obtener el catálogo vigente.