Introducción

La API de MBI Corredores de Bolsa expone, a través de servicios REST, las operaciones de intermediación bursátil que ejecuta la plataforma Optimus: enrolamiento de clientes, consulta de saldos y custodia, ingreso y seguimiento de órdenes de renta variable, cotización y compra/venta de divisas (FX Spot), y consulta de instrumentos del mercado.

Está pensada para que fintechs, family offices y desarrolladores integren estos flujos directamente en sus propios sistemas, sin depender de la interfaz web.

Dos familias de servicios

La API agrupa dos conjuntos de endpoints con estilos y autenticación distintos. Conviene tenerlos claros desde el inicio porque no comparten credenciales.

Servicios Optimus. Cubren clientes, cuentas, custodia, órdenes de renta variable e instrumentos. Se invocan con método POST y una estructura de entrada/salida homogénea (Entrada... / Salida...). La autenticación combina un token de sesión en la cabecera con credenciales de empresa y usuario dentro del cuerpo.

Servicios FX Spot. Cubren el flujo de divisas: cotización, secuencias de cliente, cálculo de preorden e ingreso de la orden. Usan rutas bajo /v1/ y se autentican con un par de llaves (x-api-key y x-api-secret) en las cabeceras.

Qué encontrarás en esta guía

La documentación sigue el recorrido natural de una integración: primero autenticación y ambientes, luego el alta y consulta de clientes, el manejo de sus cuentas, las operaciones (renta variable y FX), las consultas de saldos, movimientos y custodia, y finalmente el material de apoyo con errores, glosario y límites.

Cada endpoint tiene su referencia detallada — con parámetros, esquemas y ejemplos — en la sección API Reference. Esta guía te da el contexto y el orden en que conviene usarlos.

Antes de empezar

Para operar necesitas credenciales entregadas por MBI: para Optimus, un IdEmpresa, un usuario y su clave; para FX Spot, un x-api-key y un x-api-secret. Si aún no las tienes, contacta a tu ejecutivo de MBI.

Recuerda que para rutear ordenes tienes que tener la clasificación de enrutador y estar registrado en listado oficial de la CMF.