Statements API

Current Account Query

This API allows querying detailed information about current account movements of instruments associated with a specific account within a date range.

Endpoint Details

Method	URL	Description
GET	/v1/current-account/instruments	Gets current account instrument information

Query Parameters

Parameter	Required	Description
number	Yes	Current account number
dateFrom	Yes	Period start date (format: YYYY-MM-DD)
dateTo	Yes	Period end date (format: YYYY-MM-DD)
dateType	Yes	Date type for filtering
instrumentDescription	No	Instrument description (optional)

Responses

200 OK

The request was successful. Returns an array with current account movement information.

[
  {
    "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"
      }
    }
  }
]

Main fields for each movement:

• Dates: operationDate (operation date), settlementDate (settlement date)
• Operation: detail (complete description), instrumentDescription
• Quantities: amount (operated quantity), balance (resulting balance)
• Prices: price (unit price), net (net amount), gross (gross amount)
• Status: isAvailable (availability), instrumentTypeCode
• Currency: Complete information about the operation currency
• Instrument: Detailed information about the financial instrument (optional)

400 Bad Request

The request could not be processed due to an error in the sent parameters.

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

500 Internal Server Error

Internal server error.

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

Usage Example

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'

Additional Notes

• Authentication: All requests require a valid JWT token in the Authorization header.
• Versioning: All endpoints belong to version v1 of the API, as indicated in the URL (/v1/).