Assets represent the financial instruments or currencies that Accounts hold. Every Account is linked to exactly one Asset.

Assets can include:

• Currencies (e.g., BRL, USD, EUR)
• Cryptocurrencies (e.g., BTC, ETH)
• Non-currency assets (e.g., gold, loyalty points, tokenized securities)

Each Asset is managed independently within the Ledger, ensuring that balances remain clearly defined.

🚀

Exchange Engine

The Midaz Exchange Engine enables seamless transactions between Accounts holding different Assets. By integrating external data sources for exchange rates, it manages spreads, conversions, and risk parameters dynamically.

Multi-Asset

Modern finance isn’t limited to a single currency or asset class. Midaz supports traditional currencies, cryptocurrencies, commodities, and tokenized assets, all within a single system. Whether you’re managing multi-currency wallets, cross-border payments, or digital asset portfolios, Midaz makes transactions smooth and efficient.

Asset Structure

• Asset > Account: Every Account is tied to a single Asset.
• Asset > Ledger > Account: Assets are defined at the Ledger level, and Accounts are created based on available Assets.

Key Characteristics

• Assets must be explicitly defined before use.
• Each Asset has a unique identifier, such as a currency code.
• Multi-asset operations are handled through structured conversions.

Managing Assets

---

To manage your Assets you can use the Assets API or the Assets tab of the Ledgers page on Midaz Console.

View Assets Details

• Via API:
  • To view the details of all Assets, use the List Assets endpoint.
  • To view the details of a specific Asset, use the Retrieve an Asset endpoint.
• Via Console: Access the Assets tab to view the detais of an Asset. For more information, refer to the Managing Assets page.

Create an Asset

• Via API: Use the Create an Asset endpoint.
• Via Console: Create an Asset from the Assets tab of the Ledgers page. For more information, refer to the Creating the First Asset or the Creating a new Asset pages.

📘

Automatic External Account Creation

When you create an Asset, Midaz automatically sets up an External Account if one doesn’t already exist. This ensures seamless backing for all transactions flowing in and out of the Ledger.

The External Account follows the naming convention @external/<asset-code>, for example, @external/BRL.

Edit an Asset

• Via API: Use the Update an Asset endpoint.
• Via Console: Edit Asset details from the Assets tab of the Ledgers page. For more information, refer to the Editing Asset Information page.

Delete an Asset

• Via API: Use the Delete an Asset endpoint.
• Via Console: Delete an Asset from the Assets tab of the Ledgers page. For more information, refer to the Deleting an Asset page.

❗️

Important

An Asset can only be deleted if no balance is available in its Ledger accounts. Therefore, all remaining amounts must be moved to an External Account before deleting the Asset.