How It Works

Max Capital API is a complete ecosystem that allows financial institutions, PSPs, wallets, and companies to integrate capital market services programmatically. Our system facilitates access to a wide range of financial instruments: from mutual funds to government bonds, stocks, repos, and other products from the Argentine market.

Fundamental Concepts

Client Account

A client account is the investment account that enables your clients to operate in the Argentine capital markets. It is the legal requirement to access all financial instruments available in the system.

Features:

• Complies with CNV, BCRA and regulatory bodies regulations
• Unique identification per client
• Automatic segmentation by investor profile
• Access to multiple markets and financial products

Financial Instruments

Max Capital offers programmatic access to a wide range of financial instruments regulated by the CNV:

Mutual Funds (FCI):

• Money Market, Fixed Income, Variable Income
• Settlement T+0 to T+3 depending on fund type
• Professional management of diversified portfolios

Government Bonds:

• National and provincial bonds
• LECAP, BOPREAL, and other government instruments
• Primary and secondary operations

Stocks:

• Leading stocks from the Argentine market
• Stock Market operations
• Intraday trading and positions

Repos:

• Short-term liquidity operations
• Different terms and rates
• Automatic maturity management

CEDEARs:

• CEDARs, Fixed CEDARs and Variable CEDARs
• Primary and secondary operations
• Professional management of diversified portfolios

Negotiable Obligations:

• National and provincial obligations
• Primary and secondary operations
• Information on ratings and interest rates

Others:

• Futures and options
• Echeqs, Promissory Notes, Electronic Credit Invoices, etc.

Positions and Holdings

Positions represent the investments that a client maintains in each financial instrument.

Position states:

• Available: Instruments free to trade
• Committed: Instruments in pending operations
• Blocked: Instruments with temporary restrictions due to market regulations or laws

Information per instrument:

• Quantity of securities/units
• Updated market price
• Total position value
• Valuation in different currencies

Ecosystem APIs

🔐 Authentication API

Purpose: Centralized authentication to obtain JWT access token for all APIs

POST /api/v1/auth/login

📊 Statements API

Purpose: Query movements and positions

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

Use cases:

• Daily download for corporate ERP
• Automatic movement reconciliation
• Reporting for audit and compliance

Continuous Evolution

The Statements API is constantly evolving to provide more detailed information on current account movements:

• Standard attributes: Main data that identifies an account movement, such as date, movement type, abbreviation, quantity, price, instrument type, etc.
• Extended attributes: New informative fields, such as fees, market rights, taxes, etc.
• Customization: Adaptation of responses to specific requirements
• Compatibility: Evolution maintaining backward compatibility

Adaptable design

Designed to adapt to the specific needs of each integration, if required, responses can be incorporated with different types of record designs, designed for each ERP or management system.

• Custom information: Additional fields according to business requirements
• Custom formats: Adjustable data structure with custom field mappings
• Specific queries: Filtering parameters according to use cases

👤 Onboarding API

Purpose: Automated client account creation

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

Use cases:

• Automated digital KYC
• Identity validation with documents
• Massive B2B account opening

💰 Mutual Funds API

Purpose: Mutual fund investment management

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

Use cases:

• Automatic investment of idle balances
• Diversified portfolio management
• Balance remuneration in wallets/PSPs

Key Data Model

Holdings Structure

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

Detailed Instrument Information

Each current account movement can include detailed information of the financial instrument involved:

{
  "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",
      "disabled": false,
      "symbol": "$"
    },
    "securityType": {
      "code": 2,
      "description": "Títulos Públicos"
    },
    "instrumentType": {
      "code": "BO",
      "description": "Bono"
    },
    "mutualFundType": null,
    "instrumentKind": {
      "code": "B1",
      "description": "Bonos Nacionales"
    }
  }
}

Main instrument fields:

• Identifiers: id, ticker, isinCode, cajaValoresCode
• Descriptive information: denomination, alias, detail
• Operational data: priceUnit, isTradable, expirationDate
• Classification: securityType, instrumentType, instrumentKind
• Currency information: currency with code, description and symbol
• Fund type: mutualFundType (for FCIs)

Current Account Movements

Movements include complete operation and price information:

[
  {
    "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",
    "downloadId": "D5pM5Yh2rq/vEuPG+PQa6Gt5dwsJXnExS+yHkdZ0amn4Vhyty7EnaljO5VWgsMThaMQC4BJKArQXhZ0XbIeZPNDk61Flm6WqQvBnYCYvlX0J4sgILw/rYNpV3Lh8HxIdPjuYPbewnLQroHFOyJp+7+/bT0Y5PkLZGxFpcEluiBgSJJC4nCLm",
    "currency": {
      "code": 1,
      "description": "Pesos",
      "disabled": false,
      "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",
    "downloadId": "aRIzAs9/RQmDwgwysEEtLswSBEhcsDChjtI08OaB0lTNqAc1anddvTp0aFtkuyOrzGGPLR6eaVTLqVEr09xQwvzYB3Bu0nCheEQgLC2AyygaooJVDYf2C4xvakuYrcLiN/48LtngbfkfQcqZz8yDPiT5xQP3XACf1k3QY75LkOT6KeaeGyTZ",
    "currency": {
      "code": 1,
      "description": "Pesos",
      "disabled": false,
      "symbol": "$"
    },
    "gross": 4635000.000000
  }
]

Main movement fields:

• 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
• Identifiers: id (unique movement), downloadId (for download)
• Currency: Complete information of the operation currency

Example of a complete B2B integration flow

Available Environments

Development (Sandbox)

• Base URL: https://api-dev.max.capital
• Purpose: Testing and integration
• Data: Simulated for testing

Production

• Base URL: https://api.max.capital
• Purpose: Real operations
• Data: Real, with financial impact

Next Steps

1. Explore Use Cases - See practical implementation examples
2. How-to Guides - Detailed technical documentation
3. Code Examples - Ready-to-use code

Need sandbox access? Contact us to get your development credentials.