With Midaz, you can configure a global account structure similar to those offered by major banks, where clients hold accounts in multiple currencies (e.g., BRL, USD, EUR). This setup allows organizations to manage multiple currency accounts under a single client profile.

Using Midaz

With Midaz, the setup for this case would follow these steps:

Step 1: Create Assets for Each Currency

To set up different currency accounts, begin by creating assets using the Create an Asset endpoint. Each asset represents a currency type that the client can hold within their portfolio.

🚧

Using multiple currencies

If you wnat to use multiple currencies, you must repeat this step for each currency needed (e.g., USD, EUR).

Step 2: Create a Portfolio for the Client

The portfolio acts as a "wallet" for the client, grouping multiple currency accounts. Use the Create a Portfolio endpoint to create a portfolio where the client’s various accounts (holding different assets) will be managed.

📘

Client identifier

Use entityId as the client’s unique identifier.

Step 3: Create Accounts for Each Currency within the Portfolio

Once the portfolio and assets are created, add accounts for each currency by using the Create an Account endpoint. For example, create accounts for BRL, USD, and EUR with unique identifiers and aliases.

🚧

Account creation

You will have to create an account for each currency, one at a time.

Step 4: Retrieve All Accounts for the Portfolio

Finally, you can retrieve all accounts in the portfolio by calling the Retrieve all Accounts endpoint. This endpoint provides a comprehensive view of all currency accounts linked to the client's portfolio.