Statements API

Consulta de Cuenta Corriente

Esta API permite consultar información detallada de los movimientos de cuenta corriente de los instrumentos asociados a una cuenta específica dentro de un rango de fechas.

Detalles del Endpoint

Método	URL	Descripción
GET	/v1/current-account/instruments	Obtiene información de instrumentos de la cuenta corriente

Parámetros de Consulta

Parámetro	Requerido	Descripción
number	Sí	Número de cuenta corriente
dateFrom	Sí	Fecha inicial del período (formato: YYYY-MM-DD)
dateTo	Sí	Fecha final del período (formato: YYYY-MM-DD)
dateType	Sí	Tipo de fecha para el filtrado
instrumentDescription	No	Descripción del instrumento (opcional)

Respuestas

200 OK

La solicitud fue exitosa. Retorna un array con la información de los movimientos de la cuenta corriente.

[
  {
    "operationDate": "2025-06-04",
    "settlementDate": "2025-06-04",
    "detail": "Suscripción / FCI MAX RENTA FIJA CLASE A / $",
    "isAvailable": true,
    "balance": 15000.0000000000,
    "net": -50000.000000,
    "price": 1.2456780000,
    "instrumentDescription": "MAX RENTA FIJA CLASE A - CAFCI 3852",
    "amount": 40150.0000000000,
    "id": 45,
    "instrumentTypeCode": "FCI",
    "currency": {
      "code": 1,
      "description": "Pesos",
      "symbol": "$"
    },
    "gross": 50000.000000,
    "instrument": {
      "id": "F3852",
      "cajaValoresCode": null,
      "cafciCode": 3852,
      "isinCode": null,
      "ticker": "MAXRF",
      "denomination": "MAX RENTA FIJA CLASE A",
      "alias": "MAXRF - MAX RENTA FIJA CLASE A",
      "detail": "Fondo Común de Inversión orientado a renta fija",
      "expirationDate": null,
      "priceUnit": 1,
      "isTradable": true,
      "currency": {
        "code": 1,
        "description": "Pesos",
        "disabled": false,
        "symbol": "$"
      },
      "securityType": {
        "code": 3,
        "description": "Fondos Comunes de Inversión"
      },
      "instrumentType": {
        "code": "FCI",
        "description": "Fondo Común de Inversión"
      },
      "mutualFundType": {
        "code": "RF",
        "description": "Renta Fija"
      },
      "instrumentKind": {
        "code": "F1",
        "description": "Fondos de Renta Fija"
      }
    }
  }
]

Campos principales de cada 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
• Moneda: Información completa de la moneda de la operación
• Instrumento: Información detallada del instrumento financiero (opcional)

400 Bad Request

La solicitud no pudo ser procesada debido a un error en los parámetros enviados.

{
  "statusCode": "string",
  "errorCode": "string",
  "title": "string",
  "detail": "string"
}

500 Internal Server Error

Error interno del servidor.

{
  "statusCode": "string",
  "errorCode": "string",
  "title": "string",
  "detail": "string"
}

Ejemplo de Uso

curl -X GET 'https://api-dev.max.capital/statements/api/v1/current-account/instruments?number=987654321&dateFrom=2025-01-01&dateTo=2025-04-01&dateType=operation' \
  -H 'Authorization: Bearer {your-access-token}' \
  -H 'Content-Type: application/json'

Notas Adicionales

• Autenticación: Todas las solicitudes requieren un token JWT válido en el encabezado Authorization.
• Versionado: Todos los endpoints pertenecen a la versión v1 de la API, como se indica en la URL (/v1/).