Inicio Rápido

Esta guía te lleva desde cero hasta tu primera respuesta de la API en pocos minutos: obtenés un token y hacés una primera llamada real.

Requisitos

• Credenciales (clientId y clientSecret) provistas por Max Capital.

• La Base URL del ambiente. Para pruebas se usa el ambiente de desarrollo:

  https://openapi-dev.max.capital

  Dentro de la Base URL, el login cuelga de /auth/api y los endpoints de negocio de /gateway-openapi/api (ver Convenciones).

1. Obtener un token de acceso

Autenticate con tus credenciales para obtener un accessToken (JWT). Todas las demás llamadas lo usan en el encabezado Authorization.

curl -X POST 'https://openapi-dev.max.capital/auth/api/v1/login' \
  -H 'Content-Type: application/json' \
  -d '{
    "clientId": "demo-client-dev",
    "clientSecret": "<CLIENT_SECRET>"
  }'

Respuesta:

{
  "accessToken": "<ACCESS_TOKEN>",
  "expiresIn": 720,
  "expiresAt": "2024-06-01T14:15:59.999Z",
  "tokenType": "Bearer"
}

Guardá el accessToken: es válido por el tiempo indicado en expiresIn (en segundos). Cuando expira, volvés a pedir uno.

2. Hacer tu primera llamada

Con el token, consultá los movimientos de una cuenta corriente. Pasá el token en el encabezado Authorization con el formato Bearer {token}:

curl -X GET 'https://openapi-dev.max.capital/gateway-openapi/api/v1/current-account/instruments?accountHolderNumber=12345678&dateFrom=2025-04-01&dateTo=2025-04-30&dateType=OPERATION' \
  -H 'Authorization: Bearer <ACCESS_TOKEN>'

Si todo está bien, recibís un 200 OK con los movimientos del período. ¡Esa es tu primera integración funcionando!

3. Próximos pasos

• API Reference — todos los endpoints, con "Try it".
• Conceptos — cuenta comitente, instrumentos, posiciones.
• Convenciones — ambientes, versionado, fechas y errores.

¿Necesitás credenciales de desarrollo? Contáctanos.