Cómo Funciona

Max Capital API es un ecosistema completo que permite a instituciones financieras, PSPs, wallets y empresas integrar servicios del mercado de capitales de forma programática. Nuestro sistema facilita el acceso a una amplia gama de instrumentos financieros: desde fondos comunes de inversión hasta títulos públicos, acciones, cauciones y otros productos del mercado argentino.

Conceptos Fundamentales

Cuenta Comitente

Una cuenta comitente es la cuenta de inversión que habilita a sus clientes a operar en el mercado de capitales argentino. Es el requisito legal para acceder a todos los instrumentos financieros disponibles en el sistema.

Características:

• Cumple normativa CNV, BCRA y organismos regulatorios
• Identificación única por cliente
• Segmentación automática por perfil de inversor
• Acceso a múltiples mercados y productos financieros

Instrumentos Financieros

Max Capital ofrece acceso programático a una amplia gama de instrumentos financieros regulados por la CNV:

Fondos Comunes de Inversión (FCI):

• Money Market, Renta Fija, Renta Variable
• Liquidación T+0 a T+3 según tipo de fondo
• Gestión profesional de carteras diversificadas

Títulos Públicos:

• Bonos nacionales y provinciales
• LECAP, BOPREAL, y otros instrumentos gubernamentales
• Operaciones primarias y secundarias

Acciones:

• Acciones líderes del mercado argentino
• Operaciones en Mercado de Valores
• Trading intradía y posiciones

Cauciones:

• Operaciones de liquidez a corto plazo
• Diferentes plazos y tasas
• Gestión automática de vencimientos

CEDEARs:

• CEDARs, CEDARs Fijos y CEDARs Variables
• Operaciones primarias y secundarias
• Gestión profesional de carteras diversificadas

Obligaciones Negociables:

• Obligaciones nacionales y provinciales
• Operaciones primarias y secundarias
• Información sobre calificaciones y tasa de interés

Otros:

• Futuros y opciones
• Echeqs, Pagarés, Facturas de Crédito Electrônico, etc.

Posiciones y Tenencias

Las posiciones representan las inversiones que un cliente mantiene en cada instrumento financiero.

Estados de posición:

• Disponible: Instrumentos libres para operar
• Comprometida: Instrumentos en operaciones pendientes
• Bloqueada: Instrumentos con restricciones temporales por normativas o leyes del mercado

Información por instrumento:

• Cantidad de títulos/cuotapartes
• Precio de mercado actualizado
• Valor total de la posición
• Valuación en distintas monedas

APIs del Ecosistema

🔐 Authentication API

Propósito: Autenticación centralizada para obtener token JWT de acceso para todas las APIs

POST /api/v1/auth/login

📊 Statements API

Propósito: Consulta de movimientos y posiciones

GET /statements/api/v1/current-account/instruments

Casos de uso:

• Descarga diaria para ERP corporativo
• Conciliación automática de movimientos
• Reportería para auditoría y compliance

Evolución Continua

La API de Statements está en constante evolución para proporcionar información más detallada de los movimientos de cuenta corriente:

• Atributos estándar: Principales datos que identifican un movimiento de cuenta, como fecha, tipo de movimiento, abreviatura, cantidad, precio, tipo de instrumento, etc.
• Atributos extendidos: Nuevos campos informativos, como aranceles, derechos de mercado, impuestos, etc.
• Personalización: Adaptación de respuestas a requerimientos específicos
• Compatibilidad: Evolución manteniendo retrocompatibilidad

Diseño adaptable

Diseñada para adaptarse a las necesidades específicas de cada integración, si se requiere se pueden incorporar respuestas con distintos tipos de diseños de registro, pensados para cada ERP o sistema de gestión.

• Información a medida: Campos adicionales según requerimientos de negocio
• Formatos personalizados: Estructura de datos ajustable con mapeos de campos personalizados
• Consultas específicas: Parámetros de filtrado según casos de uso

👤 Onboarding API

Propósito: Alta automatizada de cuentas comitentes

POST /api/v1/onboardings
POST /api/v1/onboardings/{id}/person/{idPerson}/document

Casos de uso:

• KYC digital automatizado
• Validación de identidad con documentos
• Apertura masiva de cuentas B2B

💰 Mutual Funds API

Propósito: Gestión de inversiones en fondos comunes

GET  /api/v1/mutual-funds/{cafciCode}
POST /api/v1/subscriptions
POST /api/v1/redemptions
GET  /api/v1/mutual-funds-holdings

Casos de uso:

• Inversión automática de saldos ociosos
• Gestión de carteras diversificadas
• Remuneración de saldos en wallets/PSPs

Modelo de Datos Clave

Estructura de Tenencias

{
  "sharePrice": 2.339641,
  "availableShareAmounts": 22656.9232,
  "availableValuation": 53009.07,
  "unavailableShareAmounts": 0,
  "unavailableValuation": 0,
  "valuation": 53009.07
}

Información Detallada de Instrumentos

Cada movimiento de cuenta corriente puede incluir información detallada del instrumento financiero involucrado:

{
  "instrument": {
    "id": "E1421",
    "cajaValoresCode": 94,
    "cafciCode": null,
    "isinCode": "ARP125991090",
    "ticker": "AL30",
    "denomination": "BONO NACIONAL EN PESOS 2030",
    "alias": "AL30 - BONO NACIONAL EN PESOS 2030",
    "detail": null,
    "expirationDate": null,
    "priceUnit": 1,
    "isTradable": true,
    "currency": {
      "code": 1,
      "description": "Pesos",
      "symbol": "$"
    },
    "securityType": {
      "code": 2,
      "description": "Títulos Públicos"
    },
    "instrumentType": {
      "code": "BO",
      "description": "Bono"
    },
    "mutualFundType": null,
    "instrumentKind": {
      "code": "B1",
      "description": "Bonos Nacionales"
    }
  }
}

Campos principales del instrumento:

• Identificadores: id, ticker, isinCode, cajaValoresCode
• Información descriptiva: denomination, alias, detail
• Datos operativos: priceUnit, isTradable, expirationDate
• Clasificación: securityType, instrumentType, instrumentKind
• Información de moneda: currency con código, descripción y símbolo
• Tipo de fondo: mutualFundType (para FCIs)

Movimientos de Cuenta Corriente

Los movimientos incluyen información completa de la operación y precios:

[
  {
    "operationDate": "2025-06-03",
    "settlementDate": "2025-06-03",
    "detail": "Boleto / 78066 / VENTA / 0 / SUPV / $",
    "isAvailable": true,
    "balance": 0E-10,
    "net": 4649194.980000,
    "price": 3110.0000000000,
    "instrumentDescription": "\"GRUPO SUPERVIELLE AA.ORD. \"\"B\"\" 1 V.$ ESC\" - SUPV /30035",
    "amount": -1500.0000000000,
    "id": 37,
    "instrumentTypeCode": "ES",
    "currency": {
      "code": 1,
      "description": "Pesos",
      "symbol": "$"
    },
    "gross": 4665000.000000
  },
  {
    "operationDate": "2025-06-03",
    "settlementDate": "2025-06-04",
    "detail": "Boleto / 78067 / COMPRA / 1 / SUPV / $",
    "isAvailable": true,
    "balance": 1500.0000000000,
    "net": -4650703.380000,
    "price": 3090.0000000000,
    "instrumentDescription": "\"GRUPO SUPERVIELLE AA.ORD. \"\"B\"\" 1 V.$ ESC\" - SUPV /30035",
    "amount": 1500.0000000000,
    "id": 38,
    "instrumentTypeCode": "ES",
    "currency": {
      "code": 1,
      "description": "Pesos",
      "disabled": false,
      "symbol": "$"
    },
    "gross": 4635000.000000
  }
]

Campos principales del movimiento:

• Fechas: operationDate (fecha de operación), settlementDate (fecha de liquidación)
• Operación: detail (descripción completa), instrumentDescription
• Cantidades: amount (cantidad operada), balance (saldo resultante)
• Precios: price (precio unitario), net (monto neto), gross (monto bruto)
• Estado: isAvailable (disponibilidad), instrumentTypeCode
• Identificadores: id (único del movimiento), downloadId (para descarga)
• Moneda: Información completa de la moneda de la operación

Ejemplo de un flujo completo de integración B2B

Ambientes Disponibles

Desarrollo (Sandbox)

• URL Base: https://api-dev.max.capital
• Propósito: Pruebas e integración
• Datos: Simulados para testing

Producción

• URL Base: https://api.max.capital
• Propósito: Operaciones reales
• Datos: Reales, con impacto financiero

Próximos Pasos

1. Explorar Casos de Uso - Vea ejemplos prácticos de implementación
2. Guías de Integración - Documentación técnica detallada
3. Ejemplos de Código - Código listo para usar

¿Necesita acceso al sandbox? Contáctenos para obtener sus credenciales de desarrollo.