FAQ

¿Necesito un token distinto para cada servicio Optimus?
No. Un mismo token de sesión (Session/obtenerToken) sirve para todos los servicios Optimus mientras siga vigente. Reutilízalo hasta que expire y, entonces, solicita uno nuevo.

¿Puedo usar mi x-api-key de FX Spot en los servicios Optimus?
No. Son mecanismos de autenticación separados. Optimus usa X-SESSION-TOKEN más credenciales en el cuerpo; FX Spot usa x-api-key y x-api-secret. Cada familia tiene sus propias credenciales.

¿Las credenciales de sandbox funcionan en producción?
No. Cada ambiente tiene sus propias URLs y credenciales. Prueba en sandbox y, al pasar a producción, cambia tanto la URL base como las credenciales.

¿Cómo sé si una operación fue exitosa?
En Optimus, revisa ContadorErrores (debe ser 0). En FX Spot, revisa el campo success y el código de estado HTTP. Consulta Respuestas y Errores para el detalle.

¿Cómo consulto varios clientes o aplico varios filtros en una llamada?
Los servicios de consulta Optimus reciben un arreglo: agrega un elemento por cada consulta, cada uno con su IdInterno. Dentro de un mismo elemento puedes combinar filtros separando Filtro y Valor con ; en el mismo orden.

¿Puedo validar una orden antes de cursarla?
Sí. En renta variable, usa SimularOperacion en S. En FX, usa POST /v1/customer/preorder para calcular el resultado antes de ingresar la orden.

¿Cuánto dura una cotización FX?
Las cotizaciones tienen vigencia corta. Cotiza justo antes de operar y, si expiró, vuelve a solicitar una con GET /v1/quote.

¿Está disponible la operación internacional (Interactive Brokers)?
Aún no. El módulo está en desarrollo; revisa esa sección para el estado y la referencia preliminar.

Límites de Uso

Para mantener la estabilidad del servicio, la API puede aplicar límites de tasa (rate limiting) sobre la cantidad de solicitudes en una ventana de tiempo. Si superas el límite, tus solicitudes serán rechazadas temporalmente hasta que la ventana se reinicie.

Recomendaciones

Reutiliza el token de sesión en lugar de solicitar uno por cada llamada.
Agrupa consultas aprovechando los arreglos de filtros: una llamada con varios ítems es preferible a muchas llamadas individuales.
Cachea datos poco cambiantes, como el catálogo de instrumentos, en lugar de consultarlos en cada operación.
Implementa reintentos con espera (backoff) ante respuestas de límite excedido, en lugar de reintentar de inmediato.

Los valores específicos de límite por ambiente y credencial los define MBI. Si esperas un volumen alto de operaciones, coordínalo con tu ejecutivo para dimensionar correctamente tu integración.